mcpField
S
skill-forge-convert

skill-forge-convert

github.com/agricidanielエージェントワークフロー18639 回インストール29 週間前に更新
リポジトリ

skill-forge-convert について

skill-forge-convertは、Claude CodeのSkillを複数のエージェントプラットフォーム向けに変換するSkillです。互換性分析、変換、検証に加え、MCP設定も扱います。

主な機能

  1. 01Skillの複雑さと互換性を分析
  2. 02Codex、Gemini、Antigravity、Cursor向けに変換
  3. 03MCP設定を含めて変換
  4. 04各プラットフォームの生成物を検証
  5. 05マルチプラットフォーム用インストールスクリプトを生成

活用シーン

  1. 01Claude CodeのSkillを他のプラットフォームへ移植
  2. 02変換前にプラットフォーム互換性を確認
  3. 03MCP設定を変換して検証

MCP 対応

変換にMCP設定を含め、対象プラットフォームの設定形式に合わせることができます。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/agricidaniel/skill-forge --skill skill-forge-convert

インストール後、Claude Code で/skill-forge-convertを入力して読み込まれたか確認します。

詳細

スキル変換 — マルチプラットフォーム

品質を維持し、各プラットフォームのベストプラクティスに従いながら、Claude Code のスキルを OpenAI Codex、Google Gemini CLI、Google Antigravity、Cursor で動作するように変換します。

プロセス

ステップ 1：ソーススキルを読む
  1. ソースの SKILL.md を読み、フロントマターを解析します
  2. スキルの複雑さの階層（1～4）を検出します
  3. すべてのファイルを一覧にします：scripts/、references/、agents/、サブスキル
  4. 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 の機能CodexGemini/AntigravityCursor
allowed-toolsサポートされています削除；すべてのツールが利用可能です削除；同等の機能はありません
context: fork同等の機能はありません同等の機能はありません同等の機能はありません
hooks1 つのイベント（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：デプロイレポートを生成する

ユーザーに概要を提示します：

## Conversion Report: {skill-name}

| Platform | Score | Files | Warnings | Manual Steps |
|----------|-------|-------|----------|-------------|
| Codex | 92% | 4 | 2 | 1 |
| Gemini | 88% | 3 | 3 | 1 |
| Antigravity | 88% | 3 | 3 | 1 |
| Cursor | 88% | 3 | 3 | 1 |

### Generated Files
[list per platform]

### Warnings
[list per platform]

### Manual Steps Required
[list per platform]
ステップ 7：マルチプラットフォーム用インストールスクリプトを生成する

すべてのプラットフォーム（--target all）に変換する場合、スクリプトは install-multiplatform.sh を自動生成します。このスクリプトは次の機能を備えています：

  • 現在のエージェントプラットフォームを自動検出します
  • 適切なスキルパスにインストールします
  • 明示的に選択するための --platform フラグをサポートします

プラットフォーム早見表

プラットフォームスキルパス指示ファイル設定形式
Claude Code.claude/skills/CLAUDE.mdJSON（.mcp.json）
OpenAI Codex.agents/skills/AGENTS.mdTOML（config.toml）
Gemini CLI.gemini/skills/GEMINI.mdJSON（settings.json）
Antigravity.agent/skills/GEMINI.mdJSON（mcp_config.json）
Cursor.cursor/skills/.cursor/rules/*.mdcJSON（mcp.json）

各プラットフォームの詳細な仕様については、references/platforms.md を読み込みます。

階層別の変換ガイドライン

  • 階層 1（SKILL.md のみ）：問題なく変換できます。自動変換を推奨します。
  • 階層 2（スキル＋スクリプト）：適切に変換できます。スクリプトのパスを確認してください。
  • 階層 3（複数スキル）：部分的に変換できます。各サブスキルは個別に変換されます。ルーティングには手作業が必要です。
  • 階層 4（エコシステム）：手動レビューが必要です。サブエージェントの委任にはプラットフォームごとの調整が必要です。

コメント

Markdown 対応