Communityコーディング&開発github.com

スキルレジストリ更新

スキルのインストール、削除、作成、移動、名前変更後、またはデリゲーターが新しいスキルインデックスを必要とするときに、利用可能なスキルをトリガーとパスでインデックス化します。

スキルレジストリ更新 とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)のスキルレジストリを管理するためのものです。スキルの追加、削除、移動、名前変更などの変更があった後、またはサブエージェントが最新のスキルインデックスを必要とするときに呼び出されます。スキルディレクトリをスキャンし、各スキルの`SKILL.md`から名前と説明を抽出し、プロジェクトレベルのスキルをユーザーレベルのスキルより優先して重複排除し、`.atl/skill-registry.md`にレジストリを生成します。また、Engramが利用可能な場合は`topic_key: skill-registry`として永続化し、サブエージェントが適切なスキルを参照できるようにします。このレジストリはコンパイラではなくインデックスであり、各スキルの`SKILL.md`が常に信頼できる唯一の情報源であることが保証されます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Gentleman-Programming/gentle-shell/tree/main/skills/skill-registry

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

アクティベーションコントラクト

このスキルは、スキルのインストール、削除、作成、移動、名前変更を行った後、またはデリゲーターが新しいスキルインデックスを必要とするときに使用します。

ハードルール

  • レジストリはインデックスであり、コンパイラやサマリーではありません。SKILL.mdが信頼できる唯一の情報源です。
  • デフォルトでコンパクトルールを生成または注入しないでください。正確なスキルパスをサブエージェントに渡すことで、作成者の意図を保持します。
  • SDD永続化モードに関係なく、常に.atl/skill-registry.mdを書き込みます。
  • 可能な場合は、capture_prompt: falseを指定して、Engramにtopic_key: skill-registryとしてレジストリを保存します。
  • sdd-*、_shared、skill-registryをスキップし、スキル名で重複排除し、ユーザーレベルのスキルよりもプロジェクトレベルのスキルを優先します。
  • 明示的に無効にされていない限り、可能な場合は.atl/を.gitignoreに追加します。

決定ゲート

状況アクション
同じスキルがグローバルとプロジェクトに存在するプロジェクトレベルのスキルを保持
同じスキルが複数のグローバルロケーションに存在するスキャン順序で最初のソースを保持
スキルが見つからないエージェントが盲目的に検索を続けないように、空のレジストリを書き込む
エージェントが作業を委任する一致するレジストリ行を選択し、そのSKILL.mdパスを渡す

実行手順

  1. 既知のすべてのユーザーおよびプロジェクトスキルディレクトリを*/SKILL.mdについてスキャンします。
  2. 必要に応じてフロントマターのみを読み取り、nameおよびdescriptionトリガーテキストを抽出します。
  3. スキャンしたソース、レジストリコントラクト、スキル名、トリガー/説明、スコープ、および正確なパスを含む.atl/skill-registry.mdをレンダリングします。
  4. 可能な場合は、title: skill-registry、topic_key: skill-registry、type: config、capture_prompt: falseを使用してEngramに永続化します。
  5. レジストリパス、スキル数、キャッシュステータス、Engramが更新されたかどうかを返します。

出力コントラクト

以下の情報を返します:

  • プロジェクト名と.atl/skill-registry.mdのパス。
  • インデックス化されたスキルの数。
  • キャッシュがヒットしたか、再生成されたか。
  • スキップまたは重複したスキル(該当する場合)。

参考文献

  • docs/skill-style-guide.md — インデックス化前にスキルを作成する方法。
  • skills/_shared/skill-resolver.md — デリゲーターがインデックスをどのように使用するか。

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

関連スキル