sync-skills について
sync-skillsは、hal-9000プロジェクト向けのメンテナンススキルです。スキルを検出し、一覧、権限、リンクを同期してから、プロジェクトの同期コマンドを実行します。
主な機能
- 01スキルとメタデータの検出
- 02READMEのスキル一覧更新
- 03ユーザー呼び出し可能なスキル権限の同期
- 04スキルディレクトリのリンク同期
- 05`./bin/hal sync`の実行
活用シーン
- 01スキル変更後のREADME更新
- 02frontmatterに基づく許可スキルの整合
- 03追加・削除したスキルのリンク更新
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ vinta/ hal-9000 --skill sync-skillsインストール後、Claude Code で/sync-skillsを入力して読み込まれたか確認します。
詳細
手順
重要:このスキルは /usr/local/hal-9000 内でのみ使用してください。それ以外の場合は中止してください。
-
スキルを検出する
/usr/local/hal-9000内のみでskills/*/SKILL.mdを Glob します- 各 YAML フロントマターから
nameを抽出します - 各
descriptionを、機能を説明する約10語以内の短い文に書き換えます。「Use when」のトリガーは含めず、フロントマターの文言をそのままコピーしないでください
-
README.mdを更新する(### Agent Skillsセクション)- 形式:
- [name](skills/name): description - 手順1で書き換えた説明を使います
- 新しいスキルを追加し、削除されたスキルを削除し、説明が変更された項目を更新します
- 既存の項目順を維持し、新しい項目は末尾に追加します
- 形式:
-
dotfiles/.claude/settings.jsonを更新する(permissions.allow配列)Skill(...)エントリーを、検出されたユーザーが呼び出せるスキルに同期します- フロントマターで
user-invocable: trueのスキルのみを含めます - 形式:
"Skill(<name>)" - 新しいスキルを追加し、スキルが存在しなくなったエントリーを削除します
- 既存の項目順を維持し、新しい項目は末尾に追加します
- 他のツールエントリーの間の同じ位置ブロック内にエントリーを維持します
-
dotfiles/hal_dotfiles.jsonを更新する(links配列)- 形式:
{"dest": "{{HOME}}/.claude/skills/<name>/", "src": "{{REPO_ROOT}}/skills/<name>/"} - 新しいスキルのディレクトリを追加し、
"src"が{{REPO_ROOT}}/skills/*に一致するエントリーのうち、対応するスキルがなくなったものを削除します - 既存の項目順を維持し、新しい項目は末尾に追加します
- スキル以外のエントリーと
copies配列は変更しないでください
- 形式:
-
./bin/hal syncを実行し、変更内容を報告する
コメント
Markdown 対応