fix(codex): Transform Task agent calls to skill references #120
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
terry-li-hm
force-pushed
the
fix/codex-task-to-skill-transform
branch
from
f2910ae to
a2c2019
Compare
Contributor
Author
Tested and Working ✅Verified locally with Codex CLI 0.89.0:
This is the expected behavior - Codex doesn't have subagent spawning like Claude Code, so it reads the skill and executes instructions in the main thread. Note: During testing, found and fixed an additional bug where the prompt files weren't being transformed (only skill files were). Both are now correctly transformed. |
Adds comprehensive content transformation for Codex compatibility: 1. Task agent calls: `Task agent-name(args)` → `Use the $agent-name skill to: args` 2. Slash commands: `/command-name` → `/prompts:command-name` 3. Agent references: `@agent-name` → `$agent-name skill` This bridges the syntax gap between Claude Code and Codex: - Claude Code uses Task tool with subagent_types - Codex uses skills and /prompts: namespace Transformations are applied to both skill and prompt files during conversion. Tested with Codex CLI 0.89.0 - all transformations working correctly. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
terry-li-hm
force-pushed
the
fix/codex-task-to-skill-transform
branch
from
a2c2019 to
dc834a4
Compare
Contributor
Author
Full End-to-End Test Passed ✅Tested the complete workflow in Codex CLI 0.89.0:
The Ready for review. |
Collaborator
|
TY!! you are the best |
Collaborator
|
I'll add CI here as well so we can see it pass on PRs |
Contributor
Author
|
These are actually my first open-source contributions — made using Claude Code + compound-engineering itself. Thanks for building this! |
Collaborator
|
Love this! |
criztiano
pushed a commit
to criztiano/coen-plugin
that referenced
this pull request
Feb 1, 2026
…veryInc#120) Adds comprehensive content transformation for Codex compatibility: 1. Task agent calls: `Task agent-name(args)` → `Use the $agent-name skill to: args` 2. Slash commands: `/command-name` → `/prompts:command-name` 3. Agent references: `@agent-name` → `$agent-name skill` This bridges the syntax gap between Claude Code and Codex: - Claude Code uses Task tool with subagent_types - Codex uses skills and /prompts: namespace Transformations are applied to both skill and prompt files during conversion. Tested with Codex CLI 0.89.0 - all transformations working correctly. Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Adds comprehensive content transformation to the Codex converter, bridging syntax differences between Claude Code and Codex.
Problem
Claude Code and Codex have different syntax for invoking commands, agents, and referencing other features:
Task agent-name(args)Use $skill to: args/command-name/prompts:command-name@agent-name$skill-name skillThe converter was transforming structure (commands → prompts, agents → skills) but not content references within those files.
Solution
Added
transformContentForCodex()function that handles all content mappings:/prompts:namespace$skillsyntaxApplied to both skill and prompt files during conversion.
Testing
/prompts:workflows-plannow correctly invokes/prompts:deepen-plan(instead of failing with "no such file or directory: /deepen-plan")Before/After
Task calls:
Slash commands:
Agent references:
🤖 Generated with Claude Code