# claude-command-converter

Converts Claude Code slash commands into portable Agent Skills format. Useful when migrating workflows to Codex, Cursor, or Copilot.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1400 installs · ★ 153
- Author: dceoy
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/dceoy/speckit-agent-skills/tree/HEAD/skills/claude-command-converter/SKILL.md
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/skills/claude-command-converter

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add dceoy/speckit-agent-skills --skill claude-command-converter -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/claude-command-converter/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/claude-command-converter/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add dceoy/speckit-agent-skills --skill claude-command-converter -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/claude-command-converter/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add dceoy/speckit-agent-skills --skill claude-command-converter -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/claude-command-converter/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dceoy/speckit-agent-skills claude-command-converter
```

2. **Manually: put the files in place**
- File: `.github/skills/claude-command-converter/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add dceoy/speckit-agent-skills --skill claude-command-converter -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/dceoy/speckit-agent-skills --path skills/claude-command-converter
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/claude-command-converter/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add dceoy/speckit-agent-skills --skill claude-command-converter -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/dceoy/speckit-agent-skills/tree/HEAD/skills/claude-command-converter/SKILL.md

## When to use it
- convert Claude Code slash commands to portable Agent Skills
- eliminate `$ARGUMENTS` and runtime-specific blocks from command files
- transform `handoffs` metadata into a readable Next Steps section
- generate structured Inputs, Workflow, and Outputs documentation

## Example prompts
- Convert `.claude/commands/speckit.specify.md` to an agent skill
- Transform `.claude/commands/build.md` into standard skill format with name `build-tool`

## Similar
- [PDF Converter](https://affpapa.org/en/nevibecode/skills/pdf-converter.md) — skill · 5200 installs
- [unit-test-mapper-converter](https://affpapa.org/en/nevibecode/skills/unit-test-mapper-converter.md) — skill · 3700 installs
- [markdown-to-epub-converter](https://affpapa.org/en/nevibecode/skills/markdown-to-epub-converter.md) — skill · 696 installs
- [markdown-converter](https://affpapa.org/en/nevibecode/skills/steipete-markdown-converter.md) — skill · 339 installs
- [Any Programming Language to Python Converter](https://affpapa.org/en/nevibecode/prompts/any-programming-language-to-python-converter.md) — prompt · ★ 174597
- [gpt-image-2](https://affpapa.org/en/nevibecode/skills/pilioai-gpt-image-2.md) — skill · 20300 installs

From the same set: [dceoy/speckit-agent-skills](https://affpapa.org/en/nevibecode/by/dceoy/speckit-agent-skills.md) — 10 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md