claude-command-converter — Claude Code skill: how to install
Converts Claude Code slash commands into portable Agent Skills format. Useful when migrating workflows to Codex, Cursor, or Copilot.
npx skills add dceoy/speckit-agent-skills --skill claude-command-converter -a claude-codeWhat claude-command-converter does
This skill reads command files from .claude/commands/ and rewrites them into skills/<skill-name>/SKILL.md. It normalizes names to kebab-case by turning dots into hyphens. You must supply a source command path; otherwise, the agent asks for one before proceeding.
During conversion, runtime-only constructs are stripped. The skill turns $ARGUMENTS into an Inputs section, removes raw handoffs frontmatter, and adds a Next Steps section referencing related skills. Frontmatter is trimmed to keep only name and description.
Because platform-specific variables are removed automatically, you should review the generated steps before running them elsewhere. The skill is licensed under AGPL-3.0.
What it helps with
- convert Claude Code slash commands to portable Agent Skills
- eliminate
$ARGUMENTSand runtime-specific blocks from command files - transform
handoffsmetadata into a readable Next Steps section - generate structured Inputs, Workflow, and Outputs documentation
Example prompts for the agent
- Convert
.claude/commands/speckit.specify.mdto an agent skill - Transform
.claude/commands/build.mdinto standard skill format with namebuild-tool
How to install claude-command-converter
1Skills CLI (Vercel)
npx skills add dceoy/speckit-agent-skills --skill claude-command-converter -a claude-code2Manually: put the files in place
~/.claude/skills/claude-command-converter/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/claude-command-converter/
1Skills CLI (Vercel)
npx skills add dceoy/speckit-agent-skills --skill claude-command-converter -a codex2Manually: put the files in place
.agents/skills/claude-command-converter/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add dceoy/speckit-agent-skills --skill claude-command-converter -a cursor2Manually: put the files in place
.cursor/skills/claude-command-converter/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install dceoy/speckit-agent-skills claude-command-converter2Manually: put the files in place
.github/skills/claude-command-converter/SKILL.md1Skills CLI (Vercel)
npx skills add dceoy/speckit-agent-skills --skill claude-command-converter -a gemini-cli2Platform CLI
gemini skills install https://github.com/dceoy/speckit-agent-skills --path skills/claude-command-converterManually: put the files in place
.devin/skills/claude-command-converter/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add dceoy/speckit-agent-skills --skill claude-command-converter -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about claude-command-converter
How to install claude-command-converter in Claude Code?
Run npx skills add dceoy/speckit-agent-skills --skill claude-command-converter -a claude-code.
What does claude-command-converter do?
It transforms command files from .claude/commands/ into portable skills/<skill-name>/SKILL.md documents, stripping runtime-specific syntax along the way.
How does it handle $ARGUMENTS during conversion?
It deletes the $ARGUMENTS block and runtime sections, documenting user parameters inside a dedicated Inputs section instead.