claude-command-converter

Claude Command Converter

Claude Code コマンドを標準的な Agent Skills 形式に変換し、さまざまな AI コーディングアシスタント間で移植できるようにします。

使用する場面

• 既存の .claude/commands/*.md ファイルを skills/*/SKILL.md 形式に移行する場合。
• Claude Code 固有のコマンドから、移植可能なスキルを作成する場合。
• Claude Code、Codex CLI、GitHub Copilot、その他のランタイムで使用するコマンド定義を標準化する場合。

入力

• ソースコマンドのファイルパス（例：.claude/commands/my-command.md）。
• 任意：対象となるスキル名（デフォルトは拡張子を除いたコマンドのファイル名です）。

入力がない場合は、ソースコマンドのファイルパスを尋ねてください。

形式の違い

Claude Code コマンド形式

場所：.claude/commands/<command-name>.md

---
description: Short description of the command
handoffs:
  - label: Next Action
    agent: other.command
    prompt: Trigger prompt
    send: true
---
## User Input

\`\`\`text
$ARGUMENTS
\`\`\`

[Command instructions...]

標準 Agent Skill 形式

場所：skills/<skill-name>/SKILL.md

---
name: skill-name
description: Complete description including what the skill does and when to use it.
---

# Skill Title

## When to Use

- Scenario 1
- Scenario 2

## Inputs

- Required input 1
- Optional input 2

## Workflow

1. Step 1
2. Step 2
...

## Outputs

- Output file 1
- Output file 2

変換ワークフロー

1. .claude/commands/ からソースコマンドを読み取ります。

2. メタデータを抽出します：

   • YAML フロントマターから description を取得します。
   • 関連スキルや次の手順に関する handoffs を取得します。
   • 入力に関する $ARGUMENTS の扱いを確認します。

3. スキル名を決定します：

   • command.name.md → command-name に変換します（ドットをハイフンに置き換えます）。
   • 複数語の名前にはケバブケースを使用します。

4. スキルディレクトリを作成します：skills/<skill-name>/

5. コンテンツを SKILL.md 形式に変換します：

   • フロントマター：name と description のみを残します。
   • description を拡充：スキルを使用する場面を含めます。
   • $ARGUMENTS を変換：入力セクションで説明します。
   • ワークフローを構成：手順を抽出し、番号付きのワークフローセクションにまとめます。
   • 「使用する場面」を追加：コマンドのコンテキストと説明から導きます。
   • 「出力」を追加：生成されるファイルや成果物を列挙します。
   • handoffs を変換：関連スキルを参照する「次の手順」セクションを追加します。

6. ランタイム固有のコンテンツを削除します：

   • $ARGUMENTS ブロックを含む ## User Input セクションを削除します。
   • フロントマターから handoffs を削除し、本文に移します。
   • /command.name の参照を削除し、代わりにスキル名を使用します。

7. スキルの構造を検証します：

   • フロントマターに name と description のみがあることを確認します。
   • 本文に明確なセクション（使用する場面、入力、ワークフロー、出力）があることを確認します。
   • TODO のプレースホルダーが残っていないことを確認します。
   • $ARGUMENTS などのランタイム固有の変数がないことを確認します。

8. 変換結果を報告します：

   • ソースコマンドのパス。
   • 生成されたスキルのパス。
   • 適用した主な変換。
   • 手動レビューの推奨事項。

変換ルール

Claude コマンド	Agent Skill
$ARGUMENTS	期待されるユーザー入力を説明する入力セクション
handoffs:	スキル参照を含む次の手順セクション
/command.name	skill-name（ケバブケース）
agent: foo.bar	foo-bar スキルの参照
フロントマターの description:	使用のきっかけを含めて拡充した description:
インラインの ## User Input	削除し、入力セクションに記載

変換例

入力：.claude/commands/speckit.specify.md

---
description: Create feature specification from natural language.
handoffs:
  - label: Build Technical Plan
    agent: speckit.plan
---
## User Input

\`\`\`text
$ARGUMENTS
\`\`\`

The text the user typed after `/speckit.specify`...

出力：skills/speckit-specify/SKILL.md

---
name: speckit-specify
description: Create or update a feature specification from a natural language feature description.
---

# Spec Kit Specify Skill

## When to Use

- The user wants a new or updated feature spec from a natural language description.

## Inputs

- Feature description from the user.
- Repo context with `.specify/` scripts and templates.

If the description is missing or unclear, ask a targeted question before continuing.

## Workflow

...

## Outputs

- `specs/<feature>/spec.md`
- `specs/<feature>/checklists/requirements.md`

## Next Steps

After generating spec.md:

- **Plan** technical implementation with speckit-plan.
- **Clarify** specification requirements with speckit-clarify.

主なルール

• ワークフローのロジックと指示をすべて保持します。
• ランタイム固有の構成（$ARGUMENTS、handoffs、/slash-commands）を削除します。
• 簡潔すぎる説明を拡充し、使用のきっかけを含めます。
• ワークフローの手順では命令形を使います。
• スキルを自己完結型で移植可能なものにします。
• 余分なドキュメントファイル（README、CHANGELOG など）は追加しないでください。

次の手順

変換後：

• 生成された SKILL.md の完全性を確認します。
• scripts/、references/、assets/ にある未使用のサンプルファイルを削除します。
• 必要に応じて、AGENTS.md/CLAUDE.md のスキル一覧を更新します。
• 必要に応じて、ランタイム統合用のシンボリックリンクを作成します。