Skill Interop Converter

Skill Interop Converter

Workflow

1. Detect source style:

• Codex style: has SKILL.md
• Claude style: has CLAUDE.md

2. Choose conversion direction.
3. Run conversion script.
4. Review conversion-report.json for assumptions.
5. Manually inspect trigger description and workflow quality.

Commands

Codex -> Claude-style

python3 scripts/codex_to_claude.py \
  --input /path/to/codex-skill \
  --output /path/to/output-claude-skill

Claude-style -> Codex

python3 scripts/claude_to_codex.py \
  --input /path/to/claude-skill \
  --output /path/to/output-codex-skill

Optional overrides:

python3 scripts/claude_to_codex.py \
  --input /path/to/claude-skill \
  --output /path/to/output-codex-skill \
  --name my-converted-skill \
  --description "Converted and tuned for Codex triggers"

Required Review After Conversion

• Validate trigger description clarity for target platform.
• Validate file links and script paths.
• Validate generated metadata (agents/openai.yaml for Codex output).
• Validate that safety constraints survived conversion.

Resource Usage

• Read mapping-notes.md for field mapping and known limitations.
• Use conversion-report.json to track conversion assumptions.

Safety Notes

• Do not assume behavior parity after syntax conversion.
• Run at least one smoke test task against the converted skill.