# Skill Interop Converter

> Convert skill folders between Codex and Claude-style formats while preserving scripts and references. Use when migrating skills across ecosystems or standardizing team skill assets.

- Skill: `skills-generator/skill-interop-converter` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add skills-generator/skill-interop-converter`
- Raw SKILL.md: https://api.skillmd.com/api/skills/skills-generator/skill-interop-converter/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: skills-generator (https://skillmd.com/u/skills-generator)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/skills-generator/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

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

### Claude-style -> Codex

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

Optional overrides:

```bash
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](references/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.