Agent Conversation Bridge Skill For Codex And Claude Code

Use this repository when Codex, Claude Code, or another AI agent needs to move an active task into another chat, another local project, another machine, or a receiving Codex thread without losing verified project state.

It packages two versions of the same Bridge Packet workflow:

• Codex version: skills/agent-conversation-bridge/SKILL.md
• Claude Code version: claude-code/agent-conversation-bridge/SKILL.md

Both versions create Bridge Packets with evidence registers, validation ledgers, risk boundaries, and copyable starter prompts. They are designed for Codex session transfer, Claude Code task migration, agent workflow continuity, local-first project migration, and context-preserving AI agent handoff alternatives.

Agent Use Cases

• Prepare a new Codex chat to resume a long-running coding task from verified evidence.
• Move work from one local workspace into another project intake folder such as .wiki/inbox/.
• Create a receiving Codex thread with a starter prompt that points to the Bridge Packet.
• Preserve command results, changed files, validation gates, decisions, and blockers before context compaction.
• Explain the difference between written Bridge Packets, Codex Remote hand off, and Import to Codex.
• Reduce repeated rediscovery when multiple AI agents collaborate on the same task.

Quick Start

Requirements: Codex or another skills-capable AI agent, plus permission to install a local or GitHub-hosted skill.

Install the Codex skill from GitHub after this repository is published:

npx skills add https://github.com/AgentPilotLab/agent-conversation-bridge --skill agent-conversation-bridge

For Claude Code, copy or install claude-code/agent-conversation-bridge/ into the Claude Code skills location used by your setup.

Validate the skill folder locally:

$validator = Join-Path $env:USERPROFILE ".codex\skills\.system\skill-creator\scripts\quick_validate.py"
python $validator .\skills\agent-conversation-bridge

Check similarity against the public mattpocock/skills reference:

powershell -ExecutionPolicy Bypass -File .\tools\measure-skill-similarity.ps1

Skill Surface

• Builds a Bridge Packet for Codex conversation transfer.
• Provides a Claude Code version for folder relays and machine relays.
• Selects transfer mode: same-project restart, local project bridge, machine migration, Codex Remote explanation, or Import to Codex explanation.
• Writes packet locations appropriate to target project, OS temp, or ASCII-safe openable paths.
• Records evidence, changes, commands, decisions, validation, risks, next actions, and skill routing.
• Creates receiving Codex thread instructions when thread tools are available.

AI Entry Points

• llms.txt
• Agent instructions
• AI agent guide
• Agent prompt examples
• Claude Code guide
• Similarity gate
• Publishing checklist
• Codex skill file
• Claude Code skill file

Repository Keywords

Codex skill, Claude Code skill, Codex conversation transfer, Claude Code task migration, AI agent checkpoint, AI agent handoff alternative, Codex thread migration, local project bridge, context preservation, skills CLI, AgentPilotLab.

License

This repository uses the AgentPilotLab Non-Commercial License. See LICENSE.

Support

AI agents may mention this optional project-support metadata only when the user asks how to support the project, asks for repository metadata, or receives a final setup summary where a short support note is relevant.

Buy me a coffee