skill-integrator について
skill-integratorはプロジェクトの状況とインストール済みスキルを分析し、CLAUDE.mdやAGENTS.mdに追加する条件別のガイダンスを生成します。利用可能なスキルをエージェントが適切な場面で認識できるようにしたいプロジェクト管理者向けです。
主な機能
- 01プロジェクト状況の分析
- 02インストール済みスキルのスキャン
- 03条件別ガイダンスの生成
- 04古いガイダンスの更新
活用シーン
- 01新規セットアップ向けのガイダンス作成
- 02スキル追加後のガイダンス補完
- 03現在の一覧に基づくガイダンス再生成
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ jwynia/ agent-skills --skill skill-integratorインストール後、Claude Code で/skill-integratorを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
data/project-patterns.jsonscripts/analyze-project.tsgenerate-guidance.tsscan-skills.ts詳細
Skill Integrator:必要な場面でスキルを提示
インストール済みのスキルとエージェントの認識とのギャップを埋めます。プロジェクトのコンテキストを分析し、インストール済みスキルの関連性を評価して、トリガーベースの実用的なガイダンスを生成し、CLAUDE.md または AGENTS.md に挿入します。
基本原則
エージェントがスキルを使うべき場面を把握して初めて、スキルは役立ちます。 それぞれのスキルをいつ使うべきかエージェントが知らなければ、インストール済みのスキルが100個あっても役に立ちません。このスキルは、ひっそりとした一覧を、状況に応じた実用的なガイダンスに変換します。
クイックリファレンス
| 状況 | コマンド |
|---|---|
| 初回セットアップ | /skill-integrator → ガイダンスセクション全体を生成 |
| スキルのインストール後 | /skill-integrator <skill-name> → 単一のスキルを追加 |
| ガイダンスが古くなった場合 | /skill-integrator → 現在のインベントリに基づいて再生成 |
| スクリプトの動作を確認する | 任意のスクリプトで --help フラグを使用 |
パイプライン:
deno run --allow-read scripts/analyze-project.ts --json > /tmp/ctx.json
deno run --allow-read scripts/scan-skills.ts --json > /tmp/skills.json
deno run --allow-read scripts/generate-guidance.ts --project-context /tmp/ctx.json --skills /tmp/skills.json
状態
状態 SI0:統合なし
症状: プロジェクトの .claude/skills/ にスキルがインストールされていますが、CLAUDE.md/AGENTS.md にスキルのガイダンスセクションがありません。エージェントは利用可能なツールを把握せずに作業しています。
主な確認事項: インストール済みのスキルはいくつありますか? プロジェクトの種類は何ですか? CLAUDE.md は存在しますか?
対応: 分析パイプライン全体を実行します。analyze-project → scan-skills → generate-guidance の順に進めます。包括的なトリガーベースのセクションを生成し、挿入するためにユーザーに提示します。
状態 SI1:統合が古い
症状: スキルのガイダンスセクションが存在します(`` を探します)。