Codex Bridge
A Claude Code skill that bridges Claude Code to the Codex CLI: externalizes plan, files, conversation and conventions into an on-disk bundle, runs codex exec, validates the JSON response with jq.
Supply asset profile
Coding and developer agents
Code review, repo analysis, testing, CI, GitHub, DevOps, and developer workflow skills.
Scenario
Coding agents
I need a coding agent that can understand a repository, edit code, and review pull requests.
Agent fit
Claude Code + OpenAI Agents + CLI
Codex, Claude Code, Cursor, CLI, or custom agents.
Install
Ready
npx skills add yaohui325/codex-bridge
Maintenance
fresh
11d since push
Risk
Needs review
Permission surface may require sandboxing
GitHub quality
47
75/100 Quality · 76/100 Trust
Coverage tags
Review notes
Permission surface may require sandboxing · Low GitHub adoption signal
Agent adoption scorecard
Trust, audit, and install readiness at a glance
These scores combine public repository metadata, OpenAgentSkill review signals, maintenance freshness, and install readiness. They are a shortlist signal, not a replacement for human review.
Quality
StrongSolid option that is likely worth shortlisting for production workflows.
Trust
Sandbox onlyUseful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.
Audit
Needs reviewA machine-readable review of install readiness, security metadata, maintenance, and adoption risk.
OpenAgentSkill Trust Score v5
Human review before install
Run only in a sandbox and compare close alternatives before using it for real work.
Stars
47 GitHub stars
Repo activity
47 stars, 3 forks
Maintenance
11d since push
License
MIT
Install
npx skills add yaohui325/codex-bridge
Install safety
standard package or runtime install path
Permission surface
shell or command execution, filesystem or document access
Agent outcomes
No agent outcome data yet
Docs
Strong README/SKILL.md context
Risk summary
Review before production
- Low GitHub adoption signal
- Quality score needs review
- Permission surface needs review: shell or command execution, filesystem or document access
- GitHub adoption: 47 GitHub stars
Install readiness
Install path available
- Install path is available
- Repository evidence is available
- License is declared
- No Agent Proven outcome evidence yet
Agent-readable metadata
Machine-readable decision data for this skill.
Use this block or the embedded JSON to decide whether an agent should install this skill, choose an alternative, or ask for human review first.
Suited tasks
- Coding agents workflows
- Claude Code teams
- builders willing to evaluate younger projects
- Inspect source files
Suited agents
Install decision
- Command
- npx skills add yaohui325/codex-bridge
- Policy
- review
- Human review
- yes
Trust and risk
- Trust
- 68/100
- Audit
- 82/100
- Risk level
- Needs review
Outcome loop
- Endpoint
- /api/agent/outcome
- Event ID
- resolve
- Outcomes
- 5
Install command
npx skills add yaohui325/codex-bridgeDo not use when
- teams that need a vendor-supported SLA
- production agents without a repository review
- Low GitHub adoption signal
- High-risk permission hints: Shell or command execution
- Permission surface may require sandboxing
Alternative
Code Review
168.6K Stars
npx skills add mattpocock/skills --skill code-review
Alternative
Grill With Docs
164.7K Stars
npx skills add mattpocock/skills --skill grill-with-docs
Alternative
To Spec
164.7K Stars
npx skills add mattpocock/skills --skill to-spec
Alternative
To Tickets
176.7K Stars
npx skills add mattpocock/skills --skill to-tickets
Agent safety v2
50/100 · Avoid automatic install
Sparse or mixed signals. Useful for discovery, but not for autonomous installation.
Test manually in an isolated workspace and compare against safer alternatives.
high
Shell or command execution
Skill metadata references terminal, CLI, shell, subprocess, or command execution workflows.
medium
Network access
Skill likely fetches remote pages, APIs, repositories, or external services.
medium
Filesystem access
Skill may read or write project files, documents, generated artifacts, or local workspace state.
medium
Database access
Skill may inspect schemas, query databases, or work with persistent stores.
- High-risk permission hints: Shell or command execution
- Permission surface may require sandboxing
Install targets
Install this skill in your agent workflow
Use the public install endpoint to fetch the command, safety checklist, target prompts, and canonical links for this skill.
OpenAgentSkill CLI
Resolve policy, run the source installer safely, and report a verified install receipt.
$ npx --yes https://github.com/Leon-Drq/openagentskill/releases/download/cli-v0.2.1/openagentskill-0.2.1.tgz install yaohui325-codex-bridgeAgent resolve plan
Let an agent verify fit before installing.
The Resolve API returns the selected skill, alternatives, safety policy, audit notes, install target, and copy-paste prompt an agent can follow without scraping this page.
Open JSON
/api/agent/resolve?task=Use%20Codex%20Bridge%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Resolve text
/api/agent/resolve?task=Use%20Codex%20Bridge%20for%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text
Install handoff
/api/skills/yaohui325-codex-bridge/install
Agent should check
- Task fit and alternatives from Resolve API.
- Audit score, trust score, and safety policy warnings.
- Install target compatibility for Codex, Claude Code, Cursor, or CLI.
Copy prompt
Task: Use Codex Bridge in this workspace.
Resolve first: https://www.openagentskill.com/api/agent/resolve?task=Use%20Codex%20Bridge%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Review install handoff: https://www.openagentskill.com/api/skills/yaohui325-codex-bridge/install
Install command: npx skills add yaohui325/codex-bridge
Before running it, summarize audit warnings, required permissions, and the fallback skill if install is risky.Agent handoff
Give an agent the install path, not another directory page.
Use the public install endpoint to fetch the command, safety checklist, target prompts, and canonical links for this skill.
Install handoff
/api/skills/yaohui325-codex-bridge/install
LLM text format
/api/skills/yaohui325-codex-bridge/install?format=text
Find alternatives
/api/skills/search?q=Codex%20Bridge&limit=3
Agent prompt
Use Codex Bridge for this task. Review https://www.openagentskill.com/api/skills/yaohui325-codex-bridge/install, then install with: npx skills add yaohui325/codex-bridgeRegistry metadata
Agent-readable profile for automatic skill selection.
This page exposes the same decision, trust, audit, use-case, and install signals through the Registry API, so agents can rank this skill without scraping the UI.
Manifest
/api/registry/manifest/yaohui325-codex-bridge
LLM text
/api/registry/manifest/yaohui325-codex-bridge?format=text
Install alias
/api/registry/install/yaohui325-codex-bridge
Recommend
/api/registry/recommend?task=Use%20Codex%20Bridge%20in%20an%20agent%20workflow&limit=3
Agent fit
Coding agents
Use-case tags
Platforms
Shell, Claude Code, OpenAI Agents
Audit report
Needs review · 82/100
A machine-readable review of install readiness, security metadata, maintenance, and adoption risk.
Agent decision cockpit
Companion skill for Coding agents
Shortlist this skill and compare it with close alternatives before production adoption.
Role in stack
Companion skill
Primary fit
Coding agents
Trust label
Strong shortlist
Install path
Command ready
Use when
- Coding agents workflows
- Claude Code teams
- builders willing to evaluate younger projects
Evidence
- recent repository activity
- install command or GitHub repo available
- 75/100 quality profile
- 1 OpenAgentSkill engagement events
review first
- Low GitHub adoption signal
Implementation path
- 1Install it in a sandbox agent and run one Coding agents task end to end.
- 2Compare output quality, latency, and failure behavior against at least one alternative.
- 3Promote it into production only after reviewing repository permissions, license, and maintenance signals.
Trust profile
Sandbox only
Useful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.
GitHub adoption
CHECK47 GitHub stars
Stars/forks activity
CHECK47 stars, 3 forks; issue activity unavailable in current metadata
Recent maintenance
PASS11d since push
License clarity
PASSMIT
Good signals
- AI review approved
- Install path is available
- Repository evidence is available
- Recently maintained repository
- Install command has no obvious high-risk pattern
- Outcome loop is ready but needs first real agent run
Review before install
- Low GitHub adoption signal
- Quality score needs review
- Permission surface needs review: shell or command execution, filesystem or document access
- GitHub adoption: 47 GitHub stars
- Stars/forks activity: 47 stars, 3 forks; issue activity unavailable in current metadata
- Permission surface: shell or command execution, filesystem or document access
- No real agent outcome reports yet
- Human review required before unattended installation
Recommended action
Run only in a sandbox and compare close alternatives before using it for real work.
Quality profile
Strong candidate for agent workflows
Solid option that is likely worth shortlisting for production workflows.
Workflow fit
Use this skill in these scenarios
Build and ship code
Coding agents
I need a coding agent that can understand a repository, edit code, and review pull requests.
Manage repositories
GitHub automation
I need my agent to triage GitHub issues, review pull requests, and summarize repository changes.
Automate repeated work
Workflow automation
I need my agent to automate a repeated workflow across tools and files.
Workflow fit
Add it to a complete workflow
Inspect, patch, and verify code
Coding review agent
A workflow for software agents that inspect repositories, review pull requests, generate tests, and turn findings into shippable patches.
Turn skills into distribution
Content growth agent
A workflow for turning newly indexed skills into SEO briefs, social drafts, comparison pages, and reusable publishing workflows.
Scrape, clean, and reuse web data
Web data pipeline
A practical workflow for agents that crawl public pages, extract clean content, normalize data, and hand it to downstream research or RAG workflows.
Alternative shortlist
Compare before you install
Similar skills that may fit this task.
Code Review
Review a branch or diff against repository standards and the originating spec in two independent analysis passes.
Grill With Docs
A relentless interview that pressure-tests a plan against the codebase, sharpens domain language, and updates CONTEXT.md and ADRs when decisions become durable.
To Spec
Turn the current conversation and codebase context into a structured implementation spec, then publish it to the configured project issue tracker.
To Tickets
Break a plan, spec, or conversation into independently actionable tracer-bullet tickets with explicit blocking relationships.
Overview
# codex-bridge
> 显式触发的 **Claude Code → Codex CLI 桥接 skill**。把对话上下文 / plan / 相关文件 / 项目约定外化为 bundle 目录,调 `codex exec` 拿回结构化 JSON 响应 + Claude Code 用 jq 后处理校验。
**核心命题**:Claude Code 调 Codex 时,**上下文是显性的、结构化的、可机械校验的**,而不是塞到 prompt 字符串里靠 LLM 猜。
---
## 这个 skill 解决什么问题
当 Claude Code 通过 Bash 直接调用 `codex exec` 时,只有 prompt 字符串能传给 Codex。结果:
- 当前对话讨论过的方向、ruled-out 的方案 → **丢失** - plan / 主件代码引用但没 inline 的文件 → Codex **看不到** - 项目约定(CLAUDE.md / AGENTS.md) → **丢失** - "我已经试过 X / 确认 Y" 等隐性信息 → **丢失**
本 skill 把"显性外化上下文"变成**强制工作流**——Claude Code 调 Codex 前必须先把所有相关信息打包成一个磁盘 bundle,调 `codex exec` 拿回结构化 JSON 响应。
---
## 角色分工(v1.2 起,**根本设计原则**)
| 角色 | 定位 | 主要职责 | |---|---|---| | **Claude Code(主)** | 全面把控者 + 聪明规划者 | 业务规划、工作流编排、bundle 打包、用户接口、最终决策("不盲目吸收"discipline) | | **Codex(辅)** | **细节补盲者** | 补 Claude Code 在 schema 字段 / 文件引用 / 边界 case / 测试覆盖 / 文档一致性 / 隐藏假设等**细节维度**的盲点 |
**Codex 的副职**:发现业务规划问题也欢迎,**但不是主职**——Claude Code 在战略上通常更强(它有完整对话上下文),Codex 的最大价值在它**单干会漏的细节**。
详见 [SKILL.md "角色分工" section](./SKILL.md#角色分工claude-code-全面把控--codex-补细节盲点v12-新增根本设计原则)。
---
## 4 个场景
| 场景 | 用途 | sandbox | |---|---|---| | `plan-review` | 让 Codex 审计 plan / 设计 / 代码 | `read-only` | | `codify` | 让 Codex 写代码完成任务 | `workspace-write` | | `review-iteration` | 基于 Claude review 让 Codex 修改(Round 2,硬上限) | `workspace-write` | | `verification-round` (v1.1) | 验证 Claude Code 从主轮 finding 提取的 patterns 和 candidates | `read-only` |
---
## Quick start
### 安装
```bash git clone <this-repo-url> /tmp/codex-bridge cd /tmp/codex-bridge ./install.sh ```
会自动: 1. 检查依赖(`jq`、`bash 4+`、`codex` CLI) 2. 软链到 `~/.claude/skills/codex-bridge` 3. 验证 Claude Code 能识别 skill
### 使用
在 Claude Code 对话里说:
``` 让 Codex 审一下这个 plan ```
或显式 slash:
``` /codex-bridge ```
skill 自动接管,按 SKILL.md 强制执行清单走 12 步流程(含 v1.1 Pattern Extraction + Lateral Verification)。
---
## Skill 激活情境下的隐式触发(v1.2 关键规则)
⚠️ **重要**:一旦用户激活了 skill(通过自然语言触发词或 `/codex-bridge`),**在那个用户任务里 Claude Code 写完任何 plan 都必须先用 plan-review 让 Codex 审一遍**,综合后才呈现给用户。
这**不是**无条件"自动触发"——skill 是
Platform compatibility
Technical details
- Version
- 1.0.0
- License
- MIT
- Last updated
- Aug 18, 2026
- Published
- Aug 11, 2026
Frameworks & tools
Decision snapshot
Companion skill
recent repository activity
Audit
Install review
Install and adoption review
- Security
- 82/100
- Maintenance
- 100/100
- Install
- 92/100
Agent-proven evidence
Agent-proven evidence
Outcome reports after resolve, review, install, and one narrow run.
- Success rate
- —
- Recent failure
- —
- Outcomes
- 0
- Output quality
- —
- Failed
- 0
- Not relevant
- 0
- Installs
- 0
- Risk blocked
- 0
- Setup needed
- 0
- Production
- 0
No agent outcome data yet. The first agent run can report success, setup needs, risk blocks, failure, or not-relevant through /api/agent/outcome.
Install
Add to agent workflow
Free and open source. Review the report before installing into production agents.
Growth loop
Share kit
Scenario-led draft for Codex Bridge, ready for a manual X post.
A practical pick for a repeatable workflow: Codex Bridge: A Claude Code skill that bridges to Codex CLI, externalizing context into structured bundles for explicit, verifiable colla... 47 stars https://www.openagentskill.com/skills/yaohui325-codex-bridge?ref=x
Optional reply with install command
Listing + install path for Codex Bridge: https://www.openagentskill.com/skills/yaohui325-codex-bridge?ref=x Install: npx skills add yaohui325/codex-bridge
Listing source
Community indexed
This listing was indexed from public sources and is not marked official until a maintainer claim is approved.
- Creator
- yaohui325
- Source
- yaohui325/codex-bridge
- Indexed by
- OpenAgentSkill community index
Attribution links to the public repository or creator profile. Creators can claim the listing to update ownership signals.
Claim this skillOwner claim
Claim this skill listing
This Community indexed listing is attributed to yaohui325 but is not marked official yet. Claim it to add a verified owner signal and make future launch, install, and audit updates easier to trust.
Creator backlink kit
Add the evidence badges to your README
Show the canonical listing, current trust and audit signals, and real Agent-Proven evidence where developers evaluate the repository.
[](https://www.openagentskill.com/skills/yaohui325-codex-bridge)
[](https://www.openagentskill.com/skills/yaohui325-codex-bridge)
[](https://www.openagentskill.com/skills/yaohui325-codex-bridge/audit)
[](https://www.openagentskill.com/skills/yaohui325-codex-bridge)Author
yaohui325
@yaohui325
Platform fit
Health signals
- GitHub stars
- 47
- Quality score
- 47/100
- Last GitHub push
- Aug 11, 2026
- Framework hints
- 1
- OpenAgentSkill views
- 1
- Install copies
- 0
- Outbound clicks
- 0
Community signal
Share whether this skill looks useful for your agent workflow. Aggregated feedback improves rankings over time.
Trust & safety
Sandbox only
- GitHub adoption47 GitHub starsCHECK
- Stars/forks activity47 stars, 3 forks; issue activity unavailable in current metadataCHECK
- Recent maintenance11d since pushPASS
- License clarityMITPASS
- README/SKILL.md completenessMetadata includes enough usage and workflow contextPASS
- Dependency/runtime riskcommand execution surfaceINFO
Related skills
Code Review
Review a branch or diff against repository standards and the originating spec in two independent analysis passes.
168.6K StarsGrill With Docs
A relentless interview that pressure-tests a plan against the codebase, sharpens domain language, and updates CONTEXT.md and ADRs when decisions become durable.
164.7K StarsTo Spec
Turn the current conversation and codebase context into a structured implementation spec, then publish it to the configured project issue tracker.
164.7K StarsTo Tickets
Break a plan, spec, or conversation into independently actionable tracer-bullet tickets with explicit blocking relationships.
176.7K Stars