skills-management について
skills-managementは、エージェントスキルを管理するコマンドラインツールです。スキルの検索、レビュー、移行、テスト、反復最適化に対応し、複数のエージェント環境にまたがる重複も確認できます。
主な機能
- 01スキルの一覧表示、確認、レビュー、削除
- 02ユーザーとプロジェクト間のスキル移行
- 03重複検出とエージェント別コピー管理
- 04タスク評価によるスキル最適化
- 05トリガーとエージェント間移行のテスト
活用シーン
- 01スキルをレビューして改善点を反映
- 02インストール前にスキル名の重複を確認
- 03代表的なタスクで変更を評価
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ codealive-ai/ ai-driven-development --skill skills-managementインストール後、Claude Code で/skills-managementを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
prompts/analyst_error.mdanalyst_success.mdblind_comparator.mdgrader.mdmerge_failure.mdmerge_final.mdmerge_success.mdmeta_skill.mdranking.mdslow_update.mdreferences/01-introduction.md02-fundamentals.md03-planning-and-design.md04-testing-and-iteration.md05-distribution-and-sharing.md06-patterns-and-troubleshooting.md07-resources-and-references.mdopencode-skills.mdoptimization-artifacts-schemas.mdoptimization-grading-checklist.mdref-a-quick-checklist.mdref-b-yaml-frontmatter.mdref-c-complete-skill-examples.mdremote-skill-assessment.mdskill-deduplication.mdskill-optimization.mdscripts/agents.pyaggregate_runs.pyaudit_skill_duplicates.pyblind_comparator.py詳細
スキルマネージャー
クイックリファレンス
| タスク | コマンド |
|---|---|
| すべてを一覧表示 | python3 scripts/list_skills.py |
| スコープ別に一覧表示 | python3 scripts/list_skills.py -s user または -s project |
| 詳細を表示 | python3 scripts/show_skill.py <name> |
| スキルをレビュー | python3 scripts/review_skill.py <name> |
| 削除 | python3 scripts/delete_skill.py <name> |
| エージェントから削除 | python3 scripts/delete_skill.py <name> --all-agents --force |
| ユーザー領域に移動 | python3 scripts/move_skill.py <name> user |
| プロジェクト領域に移動 | python3 scripts/move_skill.py <name> project |
| 名前の重複を監査 | python3 scripts/audit_skill_duplicates.py |
| インストール前のチェック | python3 scripts/audit_skill_duplicates.py --candidate /path/to/skill --fail-on-conflict |
| 新規作成 | /skill-creator を使用 |
| 最適化と反復(SkillOpt 方式) | |
| 最適化を計画 | python3 scripts/optimize_skill.py <name> --tasks tasks.jsonl --dry-run |
| 最適化を実行 | python3 scripts/optimize_skill.py <name> --tasks tasks.jsonl --output-dir runs/r1 |
| 手動編集を記録 | python3 scripts/log_skill_edit.py <name> --reason "..." --snapshot |
| 最近の編集を一覧表示 | python3 scripts/log_skill_edit.py <name> --list --since 7d |
| 最後のスナップショットとの差分 | python3 scripts/diff_skill_versions.py <name> --log --format stats |
| コミット間の差分 | python3 scripts/diff_skill_versions.py <name> --git HEAD~3 HEAD |
| トリガーテスト | python3 scripts/trigger_test.py <name> --cases cases.yaml |
| トリガーケースを生成 | python3 scripts/trigger_test.py <name> --generate > cases.yaml |
| 転移テスト | python3 scripts/transfer_test.py <name> --all |
| 実行結果を集約 | python3 scripts/aggregate_runs.py runs/* |
| 実行結果を比較 | python3 scripts/aggregate_runs.py runs/r1 runs/r2 --compare |
| アサーション採点で実行 | python3 scripts/optimize_skill.py <name> --tasks tasks.jsonl --verifier assertions |
| 複数回実行のばらつきを確認 | python3 scripts/optimize_skill.py <name> --tasks tasks.jsonl --runs-per-task 3 |
| ブラインド A/B 比較 | python3 scripts/blind_comparator.py --skill-a runs/r1/initial_skill.md --skill-b runs/r1/best_skill.md --tasks tasks.jsonl --output-dir cmp/ |
| HTML ビューアー | python3 scripts/eval_viewer.py runs/r1 |
| 2 つの実行結果を比較(HTML) | python3 scripts/eval_viewer.py runs/r1 runs/r2 --compare |
| 検索とインストール | |
| スキルを検索 | npx skills find [query] |
| リモートスキルをレビュー | skills.sh のページを取得し、評価フレームワークを使用して評価します |
| エコシステムのスキルを一覧表示 | npx skills list または npx skills ls |
| GitHub からインストール | npx skills add <owner/repo@skill> -g -y |
| エコシステムのスキルを削除 | npx skills remove <name> -g -y または npx skills rm |
| インストール済みバージョンを確認 | ロックメタデータと上流の状態を確認します。npx skills check が読み取り専用だとは想定しないでください |
| すべてを更新 | npx skills update |
| オンラインで閲覧 | skills.sh |
| マルチエージェント | |
| エージェントを検出 | python3 scripts/detect_agents.py |
| エージェントのスキルを一覧表示 | python3 scripts/list_agent_skills.py --agent cursor |
| エージェントにインストール | python3 scripts/install_skill.py /path --agent cursor |
| エージェント間でコピー | python3 scripts/copy_skill.py <name> --from claude-code --to cursor |
| エージェント間で移動 | python3 scripts/move_skill_agent.py <name> --from claude-code --to cursor |
スコープと重複に関する不変条件
スキルの検出方法は利用者ごとに異なります。Codex はユーザースキルに $HOME/.agents/skills を使用し、CWD からリポジトリのルートまで .agents/skills をスキャンして、シンボリックリンクをたどります。その他のエージェントは scripts/agents.py に記載されたパスを使用します。プラグインは、個別に管理される名前空間付きレイヤーを追加します。
各利用者のトポロジーで、frontmatter の name ごとに有効な実装を 1 つだけ維持してください。同じ実ディレクトリへのエイリアスは独立したコピーではありません。同一のエージェント固有の複製が必要な場合もありますが、内容の異なるグローバル/リポジトリ/プラグインのコピーについては、正本を決定する必要があります。インストール、重複解消、移行、またはプラグインとスタンドアロンの競合解決を行う前に、skill-deduplication.md を読んでください。
操作
スキル一覧
python3 scripts/list_skills.py # All skills
python3 scripts/list_skills.py -s user # User scope only
python3 scripts/list_skills.py -f json # JSON output
スキルの詳細を表示
python3 scripts/show_skill.py <name> # Basic info
python3 scripts/show_skill.py <name> --files # Include file listing
python3 scripts/show_skill.py <name> -f json # JSON output
スキルをレビュー
スキルをベストプラクティスに照らして監査し、改善案を提示します。
python3 scripts/review_skill.py <name> # Review with text output
python3 scripts/review_skill.py <name> -f json # JSON output for programmatic use
実施するチェック:
- 名前の形式(小文字、ハイフン、最大 64 文字、動名詞形)
- 名前とディレクトリ名の一致
- 説明の品質(トリガー、否定的トリガー、三人称、具体性)
- frontmatter 内の XML 山括弧(セキュリティ)
- 禁止されているドキュメントファイル(README.md、CHANGELOG.md)
- 本文の長さ(500 行を超える場合は警告)
- トークン使用量(SkillOpt による目標は 300~2000 トークン。2000 で警告し、4000 でペナルティを適用)
- 手順性(インスタンス固有の指標――ファイル名、具体的な数値、タスクへの言及――はまれであるべきです)
- パッチ適用のしやすさ(確実な
insert_after編集には、アンカーの密度として##/###見出しと**ラベル:**マーカーが必要です) - 低頻度更新セクションの整合性(
/マーカーは対応しており、入れ子になっていない必要があります) - 時間の経過で変わる内容
- パス形式(Windows のバックスラッシュを使用していないこと)
- 参照の深さ(1 階層であるべきです)
- 長いファイルの目次
レビュー後: スキルの SKILL.md を読み、提案された修正を直接適用してください。
スキルを削除
重要: 削除する前に必ず AskUserQuestion を使用して、次の確認を行ってください:「スキル『[name]』を削除してもよろしいですか?この操作は取り消せません。」
python3 scripts/delete_skill.py <name> # Claude Code only, with confirmation
python3 scripts/delete_skill.py <name> --force # Skip confirmation prompt
python3 scripts/delete_skill.py <name> -s project # Target specific scope
python3 scripts/delete_skill.py <name> -a cursor # Delete from specific agent
python3 scripts/delete_skill.py <name> --all-agents --force # Delete from all agents
複数エージェントからの削除: npx skills add でインストールされたスキルは、複数のエージェントのディレクトリに存在する場合があります。デフォルトのモード(フラグなし)では Claude Code からのみ削除され、他のエージェントにコピーが残っている場合は警告が表示されます。検出されたすべてのエージェントから一度に削除するには、--all-agents を使用してください。
エコシステム経由でインストールされたスキルは、まず npx skills remove <name> -g -y を使用してください。手動でクリーンアップする場合は、代わりに delete_skill.py --all-agents を使用してください。
スキルを移動
python3 scripts/move_skill.py <name> user # Project → User (personal)
python3 scripts/move_skill.py <name> project # User → Project (share with team)
python3 scripts/move_skill.py <name> user -f # Overwrite if exists
スキルを変更
python3 scripts/show_skill.py <name>を実行して場所を確認します- 返されたパスにある SKILL.md を直接編集します
新しいスキルを作成
適切な構造でガイド付き作成を行うには、/skill-creator スキルを使用してください。
スキルを最適化(SkillOpt スタイル)
スキルを訓練可能なテキスト成果物として扱います。編集範囲を限定し、ホールドアウト検証ゲートを設け、却下した編集をバッファに保存し、エポックごとに低頻度の更新を行います。手法の詳細は references/skill-optimization.md を参照してください(Microsoft、arXiv 2605.23904、2026 年 5 月)。
このループを使用する場合:
- スキルがすでに存在し、測定可能なタスクセットで性能が不十分な場合
- 検証器(完全一致、スコア付き出力、または LLM 判定)を用意できる、または作成できる場合
- 参照回答付きの代表的なタスクを 20~100 件用意できる場合
使用しない場合:
- タスクに測定可能な成功シグナルがない場合――範囲を限定したテキスト最適化にはゲートが必要です
- スキルをゼロから作成する場合――まず
/skill-creatorで v0 を作成してください - タスクが 1~5 件しかない場合――このループにはエビデンスのバッチが必要です
ループを実行
# 1. Dry-run to see the plan (splits, schedule, prompt previews)
python3 scripts/optimize_skill.py <name> \
--tasks tasks.jsonl --epochs 4 --edit-budget 4 \
--output-dir runs/r1 --dry-run
# 2. Real run
python3 scripts/optimize_skill.py <name> \
--tasks tasks.jsonl --output-dir runs/r1 \
--optimizer-cmd "claude -p --model claude-opus-4-7" \
--target-cmd "claude -p --model claude-haiku-4-5-20251001"
# 3. Inspect
cat runs/r1/optimization_report.md
python3 scripts/diff_skill_versions.py <name> --files \
runs/r1/initial_skill.md runs/r1/best_skill.md --format stats
このループにより、best_skill.md、optimization_report.md、edit_apply_report.json、rejected_buffer.json、meta_skill.json が生成されます(最適化側のみで使用され、配布されません)。
手動編集の監査証跡
ループ外で編集する場合(手動調整、バグ修正後のフォローアップなど)は、簡潔なログを記録してください。
# After saving an edit
python3 scripts/log_skill_edit.py <name> \
--reason "tightened insert_after target" \
--source from-bug --ref "issue #42" --snapshot
python3 scripts/log_skill_edit.py <name> --list --since 30d
python3 scripts/diff_skill_versions.py <name> --log
--snapshot を指定すると、<skill>/.skill_snapshots/SKILL.<sha8>.md にコピーが保存され、差分ヘルパーでハッシュだけでなく実際の内容も表示できるようになります。
保護された低速更新セクション
反復的に最適化されるスキルには、長期的なガイダンス用のマークアップで囲まれた領域を含める必要があります。
scripts/review_skill.py は、マーカーの不整合や入れ子を検出します。scripts/optimize_skill.py は、この領域内のコンテンツを対象とするステップ単位の編集の適用を拒否します。
トリガーと転送のテスト
# Auto-generate candidate trigger cases from the skill's description
python3 scripts/trigger_test.py <name> --generate > cases.yaml
# Curate, then run
python3 scripts/trigger_test.py <name> --cases cases.yaml --threshold 0.8
# Verify skill lands and parses in other agents
python3 scripts/transfer_test.py <name> --all --scope global
詳細な評価:アサーション検証器
--verifier assertions を指定すると、tasks.jsonl の宣言的な assertions[] に照らして各ロールアウトを評価します。評価器は、証拠と抽出された主張に加えて、アサーション自体への批評(eval_feedback)をアサーションごとの合格/不合格とともに返します。これは、弱いチェックや識別力のないチェックを指摘するメタレイヤーです。optimization_report.md では、これらが「Assertion critique」セクションにまとめられます。
// tasks.jsonl entry for --verifier assertions
{"id":"t1","prompt":"...","assertions":["The output is a valid JSON array","Each item has a name field"]}
分散:タスクごとの複数回実行
--runs-per-task 3 を指定すると、各タスクを N 回実行します。rollouts.jsonl には score_mean と score_stddev が記録され、検証ゲートでは平均値が使用されます。検証器の結果にばらつきがある場合や、エージェントの動作が非決定的な場合に使用してください。
ブラインド A/B 比較
best_skill.md が initial_skill.md より実際に優れているかどうかを独立して判定します。SkillOpt ゲートでは編集を提案したものと同じ検証器を使用するため、自己確認に陥る可能性があり、この判定は重要です。
python3 scripts/blind_comparator.py \
--skill-a runs/r1/initial_skill.md \
--skill-b runs/r1/best_skill.md \
--tasks tasks.jsonl \
--output-dir cmp/r1
タスクごとに、両方のスキルを同じプロンプトで実行し、出力を X/Y としてランダム化されたラベルとともに独立した判定者に提示します。結果は comparison_report.{json,md} に集約されます。
実行結果の HTML ビューアー
python3 scripts/eval_viewer.py runs/r1 # opens in browser
python3 scripts/eval_viewer.py runs/r1 runs/r2 --compare # side-by-side
単一ページの静的 HTML です。エポックごとのグラフ、承認/却下された編集のタイムライン、低速更新の履歴、評価付きのタスクごとのロールアウト、初期版から最良版への差分を表示します。JS/CSS の依存関係はありません。
スキルを検索してインストールする
Skills CLI(npx skills)を使って、オープンなエージェントスキルのエコシステムからスキルを検索してインストールできます。skills.sh で閲覧できます。
スキルを検索する
npx skills find [query] # Interactive search
npx skills find react performance # Keyword search
npx skills find pr review # Search by task
エコシステムからインストールする
必須の事前確認: 候補のフロントマターにある name を特定し、インストール前に重複監査を実行してください。名前がすでに存在する場合は、正規のコピーを更新または再利用してください。意図的に複数のエージェント用レプリカを作成する場合は、その必要性を文書化し、レビュー後に限り install_skill.py --allow-duplicate-name を使用してください。
ローカルで管理する正規のソースがある場合は、install_skill.py --link を優先してください。すべてのエージェントが同じ実ディレクトリを参照するため、今後の編集によってコピー先との内容にずれが生じることもありません。利用側がシンボリックリンクをたどれない場合や、意図的に独立したスナップショットが必要な場合に限り、コピーを使用してください。
npx skills add <owner/repo@skill> -g -y # Install globally, skip prompts
npx skills add vercel-labs/agent-skills@vercel-react-best-practices -g -y
エコシステムのスキルを一覧表示する
npx skills list # List all installed ecosystem skills
npx skills ls # Alias
npx skills list -g # Global skills only
npx skills list -a cursor # Skills for a specific agent
エコシステムのスキルを削除する
npx skills add でインストールしたスキルをアンインストールします。ローカルで作成したスキルには、代わりに python3 scripts/delete_skill.py を使用してください。
重要: 削除する前に、必ずユーザーに確認してください。
npx skills remove <name> -g -y # Remove a global skill, skip prompt
npx skills rm <name> # Alias, with confirmation prompt
npx skills remove <name> -a cursor # Remove from specific agent
npx skills remove --all -g -y # Remove all global ecosystem skills
確認して更新する
npx skills check # Check for available updates
npx skills update # Update all installed skills
npx skills check は変更を加える可能性があるものとして扱ってください。一部の CLI バージョンでは check の実行中に更新が行われ、check --help でも同じワークフローに入る場合があります。ユーザーがすでに更新を許可していない限り、読み取り専用の確認には実行しないでください。読み取り専用で鮮度を比較する場合は、リポジトリの HEAD、マネージャーのロックメタデータ、インストール済みのハッシュを優先してください。管理対象の更新を行った後は、古いロックエントリによって削除済みのコピーが再作成される可能性があるため、重複監査を再実行してください。
検索するタイミング
ユーザーが次のような場合は、npx skills find を使用してください。
- よくあるタスクについて「X はどうすればできますか」と尋ねる
- 「X に使えるスキルを探して」または「X 用のスキルはありますか」と尋ねる
- デザイン、テスト、デプロイなどの専門的な機能を求める
よく検索されるカテゴリ
| カテゴリ | 検索例 |
|---|---|
| Web 開発 | react, nextjs, typescript, tailwind |
| テスト | testing, jest, playwright, e2e |
| DevOps | deploy, docker, kubernetes, ci-cd |
| ドキュメント | docs, readme, changelog, api-docs |
| 品質 | review, lint, refactor, best-practices |
| デザイン | ui, ux, design-system, accessibility |
| 生産性 | workflow, automation, git |
レビューと結果の比較
検索後は、見つかったスキルのレビューを必ず提案してください。 検索結果を提示した後、インストール前に有力候補をレビューして比較するか、ユーザーに尋ねてください。
検索結果が2件以上ある場合は、上位候補を取得して評価することを積極的に提案してください。これはエージェント主導で行います。https://skills.sh/<owner>/<repo>/<skill> のページに WebFetch を使用し、判断を適用してください。
次の場合は必ずレビューを提案してください。
- 検索で結果が返された場合(「インストール前に、これらのスキルをレビューしますか?」と尋ねる)
- 結果が3件以上返された場合(レビューが特に有用です)
- 名前が似ている、または説明が重複している結果が複数ある場合
- ユーザーが比較、レビュー、評価、または最適なものの選定を求めた場合
- 特定の分野に特化したトピックにもかかわらず、インストール数が非常に多いなど、不審な指標がある場合
手順:
- まず検索結果の概要を提示する
- 上位候補をレビュー/比較するか、ユーザーに尋ねる
- はいの場合:上位3~6件の候補について skills.sh のページを取得する
- 品質を示す要素を評価する:インストール数、エージェントの分布、経過期間、説明、関連性、インストール済みスキルとの重複
- 判定を付ける:推奨/検討/見送り
- 1~2文の評価を添えた、順位付きの概要を提示する
危険信号やスコアリングの指標を含む詳しい評価基準については、references/remote-skill-assessment.md を参照してください。
検索結果がない場合
スキルが見つからなかった場合は、直接支援を申し出てから、カスタムスキルを作成するための npx skills init <name> を提案してください。
マルチエージェント操作
40種類の対応 AI コーディングエージェントにまたがってスキルを管理します。完全なレジストリは skills.sh をご覧ください。
対応エージェント
対応エージェントと検出パスの正規レジストリは
scripts/agents.py です。パスが古くなる可能性があるため、表を手順にコピーするのではなく、
detect_agents.py --all を使って表示してください。
インストール済みエージェントの検出
python3 scripts/detect_agents.py # List detected agents
python3 scripts/detect_agents.py --all # Show all supported agents
python3 scripts/detect_agents.py -f json # JSON output
任意のエージェントのスキルを一覧表示
python3 scripts/list_agent_skills.py --agent cursor # Single agent
python3 scripts/list_agent_skills.py --agent goose -s global # Specific scope
python3 scripts/list_agent_skills.py --all # All detected agents
python3 scripts/list_agent_skills.py --agent amp -f json # JSON output
エージェントへのスキルのインストール
python3 scripts/install_skill.py /path/to/skill --agent cursor # Single agent
python3 scripts/install_skill.py /path/to/skill --agent cursor --agent amp # Multiple agents
python3 scripts/install_skill.py /path/to/skill --all # All detected
python3 scripts/install_skill.py /path/to/skill --agent goose -s global # Global scope
python3 scripts/install_skill.py /path/to/skill --agent cursor --force # Overwrite
python3 scripts/install_skill.py /path/to/skill --agent cursor --link --allow-duplicate-name # Canonical alias
エージェント間でスキルをコピー
python3 scripts/copy_skill.py my-skill --from claude-code --to cursor
python3 scripts/copy_skill.py my-skill --from claude-code --to cursor --to-scope global
python3 scripts/copy_skill.py my-skill --from claude-code --from-scope project --to amp
python3 scripts/copy_skill.py my-skill --from claude-code --to cursor --force
エージェント間でスキルを移動
python3 scripts/move_skill_agent.py my-skill --from claude-code --to cursor
python3 scripts/move_skill_agent.py my-skill --from claude-code --to goose --force
重要な注意事項
- 新しい最上位ディレクトリを作成した場合は再起動が必要です:セッション開始時に存在しなかった最上位の
skills/ディレクトリを作成した場合、そのディレクトリを監視できるよう Claude Code を再起動する必要があります - 変更のライブ検出(Claude Code、2026):
~/.claude/skills/、プロジェクトの.claude/skills/、または--add-dirディレクトリ内の.claude/skills/でスキルを追加、編集、削除すると、現在の Claude Code セッション内で反映されます。再起動は不要です - 編集はすぐに反映されます:既存のスキル内容を変更しても、再起動は不要です
- エージェントの検出:設定ディレクトリの有無を使って、インストール済みエージェントを検出します
- 検出トポロジーごとに一度だけインストール:共有の正規ルートまたはシンボリックリンクを優先してください。そのルートを読み取れない利用元に限り、エージェント固有の複製を作成し、複製後に監査してください。
- カスタムコマンドはスキルに統合されています(Claude Code、2026):
.claude/commands/deploy.mdのファイルと.claude/skills/deploy/SKILL.mdのスキルは、どちらも/deployを作成します。既存の.claude/commands/ファイルも引き続き動作します。スキルでは、補助ファイル、フロントマター、自動呼び出し用のディレクトリが追加されます。 - プラグインのスキルは
plugin-name:skill-nameの形式で名前空間が分けられており、ユーザーまたはプロジェクトのスキルと競合しません
OpenCode 固有の注意事項
OpenCode(anomalyco/opencode v1.14.x)は、ネイティブのパスに加えて、複数の互換性のある場所からスキルを読み込みます。
- プロジェクト:
.opencode/skills/、.claude/skills/、.agents/skills/— すべて読み込まれます - グローバル:
~/.config/opencode/skills/、~/.claude/skills/、~/.agents/skills/— すべて読み込まれます - CWD から git ワークツリーのルートまでさかのぼり、その過程でスキルを収集します
つまり、Anthropic 形式の SKILL.md スキルを 1 つ用意すれば、変更せずに Claude Code、Codex、OpenCode で使用できます。OpenCode ユーザー向けに、任意で次の調整を行うとより使いやすくなります。
- フロントマターに
compatibility: opencode,claude-code,codexを追加する - スキル本文からツールを呼び出す場合は、ツール名を小文字にする(
bash、edit、read—Bash/Edit/Readではありません)
opencode.json の permission.skill ブロックを使うと、スキルへのアクセスを名前ごとに制限できます。
{ "permission": { "skill": { "*": "allow", "internal-*": "deny" } } }
OpenCode スキルの詳細なリファレンスについては、references/opencode-skills.md を参照してください。
参考資料 — Claude のスキル構築完全ガイド
スキルを確認する場合や、スキルの構成とベストプラクティスについてアドバイスする場合に、以下を参照してください。
| ファイル | 説明 |
|---|---|
references/01-introduction.md | スキルとは何か、このガイドの対象者、2 つの学習パス |
references/02-fundamentals.md | スキルの構成、段階的開示、合成可能性、MCP 統合 |
references/03-planning-and-design.md | ユースケース、カテゴリ、成功基準、YAML フロントマター、指示の作成 |
references/04-testing-and-iteration.md | トリガーテスト、機能テスト、パフォーマンス比較、skill-creator の使用方法 |
references/05-distribution-and-sharing.md | 配布モデル、API の使用方法、GitHub でのホスティング、位置付け |
references/06-patterns-and-troubleshooting.md | 7 つのワークフローパターン(SkillOpt 方式の検証済み反復的改良を含む)、よくあるエラーとその修正方法 |
references/07-resources-and-references.md | 公式ドキュメント、スキルの例、ツール、サポート窓口 |
references/ref-a-quick-checklist.md | 構築前、開発時、アップロード時、アップロード後のチェックリスト |
references/ref-b-yaml-frontmatter.md | 必須/任意のフィールド、セキュリティ上の制限 |
references/ref-c-complete-skill-examples.md | 本番環境に対応したスキルの例へのリンク |
references/remote-skill-assessment.md | インストール前にエコシステム内のスキルを評価するためのフレームワーク |
references/skill-deduplication.md | 正規ソースの選定、重複の分類、プラグインの処理、インストール前チェック、検証 |
references/skill-optimization.md | SkillOpt 方式のトレーニングループ:範囲を限定した編集、検証ゲート、却下バッファー、低速/メタ更新(Microsoft、arXiv 2605.23904) |
references/optimization-artifacts-schemas.md | optimize_skill.py および log_skill_edit.py が書き込むすべての成果物(分割データ、状態、ロールアウト、提案、判断、edit_apply_report、rejected_buffer、meta_skill など)の JSON スキーマ |
references/optimization-grading-checklist.md | 最適化の完了後に行う監査チェックリスト — リリース前に best_skill.md、edit_apply_report.json、rejected_buffer.json で確認する項目 |
prompts/analyst_error.md、analyst_success.md | オプティマイザー向けの失敗/成功分析プロンプトの仕様 |
prompts/merge_failure.md、merge_success.md、merge_final.md | 階層的な編集マージの仕様 |
prompts/ranking.md | 編集のランキングと選択に関する仕様 |
prompts/slow_update.md、meta_skill.md | エポック境界での低速更新と、オプティマイザー側のメタスキルに関する仕様 |
prompts/grader.md | --verifier assertions 用の詳細な採点仕様(アサーションごとの合否、主張、eval_feedback による批評) |
prompts/blind_comparator.md | blind_comparator.py 用の独立した A/B 判定仕様 |
謝辞
マルチエージェントのサポートは、Vercel Labs の Skills CLI(npx skills)を基にしています。skills.sh で、オープンなエージェントスキルのエコシステムをご覧ください。