スキル変換 — マルチプラットフォーム は何をしますか？
Claude CodeのスキルをOpenAI Codex、Google Gemini CLI、Google Antigravity、Cursor向けに変換し、品質を維持しながら各プラットフォームのベストプラクティスに従えるようにします。
プロセス
ステップ 1: ソーススキルの読み取り
- ソースの
SKILL.mdを読み込み、frontmatterを解析する - スキルの複雑度レベル (1-4) を検出する
- すべてのファイルを一覧化する: scripts/、references/、agents/、サブスキル
- MCP設定 (
.mcp.json) が存在する場合は特定する
ステップ 2: プラットフォーム互換性の分析
最初にドライランの分析を実行する:
python scripts/convert_skill.py <path> --dry-run --target all
互換性レポートを確認する:
- 移植可能なフィールド: そのまま転送 (name, description, license)
- 適応が必要なフィールド: プラットフォーム固有の処理が必要
- Claudeのみのフィールド: 警告とともに削除される
ステップ 3: ターゲットプラットフォームへの変換
変換を実行する:
python scripts/convert_skill.py <path> --target codex,gemini,antigravity,cursor --output dist/
MCP設定を変換する場合:
python scripts/convert_skill.py <path> --target all --output dist/ --include-mcp
ステップ 4: Claude固有機能の処理
プラットフォームごとに手動での適応が必要な機能:
| Claude機能 | Codex | Gemini/Antigravity | Cursor |
|---|---|---|---|
allowed-tools | サポート済み | 削除; すべてのツールが利用可能 | 削除; 同等機能なし |
context: fork | 同等機能なし | 同等機能なし | 同等機能なし |
hooks | 1イベント (notify) | 一部対応 (CLI) | 6イベント (ベータ) |
model 選択 | 同等機能なし | 同等機能なし | 同等機能なし |
Task 委任 | 個別のスキルに分割 | 個別のスキルに分割 | バックグラウンドエージェント (Ultraプラン) |
/slash コマンド | $mention 構文 | 説明ベースの起動 | 説明ベース + @rule |
| サブスキルルーティング | $mention を使用した個別のスキル | 個別のスキル、LLMルーティング | 個別のスキル、LLMルーティング |
ステップ 5: 変換済みスキルの検証
生成された各出力に対して検証を実行する:
python scripts/validate_skill.py dist/codex/<skill-name>/
python scripts/validate_skill.py dist/gemini/<skill-name>/
python scripts/validate_skill.py dist/antigravity/<skill-name>/
python scripts/validate_skill.py dist/cursor/<skill-name>/
先に進む前に、重要または高優先度の問題を修正する。
ステップ 6: デプロイレポートの生成
ユーザーに要約を提示する:
変換レポート: {skill-name}
| プラットフォーム | スコア | ファイル数 | 警告数 | 手動ステップ数 |
|----------|-------|----------|-------------|
| Codex | 92% | 4 | 2 | 1 |
| Gemini | 88% | 3 | 3 | 1 |
| Antigravity | 88% | 3 | 3 | 1 |
| Cursor | 88% | 3 | 3 | 1 |
### 生成されたファイル
[プラットフォームごとに一覧]
### 警告
[プラットフォームごとに一覧]
### 必要な手動ステップ
[プラットフォームごとに一覧]
ステップ 7: マルチプラットフォームインストールスクリプトの生成
すべてのプラットフォーム向けに変換する場合 (--target all)、スクリプトは自動的に install-multiplatform.sh を生成し、以下の機能を提供する:
- 現在のエージェントプラットフォームを自動検出
- 正しいスキルパスにインストール
- 明示的な選択のための
--platformフラグをサポート
プラットフォームクイックリファレンス
| プラットフォーム | スキルパス | 指示ファイル | 設定形式 |
|---|---|---|---|
| Claude Code | .claude/skills/ | CLAUDE.md | JSON (.mcp.json) |
| OpenAI Codex | .agents/skills/ | AGENTS.md | TOML (config.toml) |
| Gemini CLI | .gemini/skills/ | GEMINI.md | JSON (settings.json) |
| Antigravity | .agent/skills/ | GEMINI.md | JSON (mcp_config.json) |
| Cursor | .cursor/skills/ | .cursor/rules/*.mdc | JSON (mcp.json) |
完全なプラットフォーム仕様については、references/platforms.md を読み込んでください。
レベル変換ガイドライン
- レベル 1 (単一 SKILL.md): クリーンに変換できます。自動変換を推奨。
- レベル 2 (スキル + スクリプト): 適切に変換できます。スクリプトパスを確認してください。
- レベル 3 (マルチスキル): 部分的に変換。各サブスキルは独立して変換されます。ルーティングは手動での対応が必要です。
- レベル 4 (エコシステム): 手動レビューが必要です。サブエージェント委任はプラットフォームへの適応が必要です。