メインコンテンツまでスキップ

スキル作成・管理

スキルを作成・改善し、正本とカタログの関係を保って配置します。

スキルできること
skill-authoring正本とカタログを整えて配置する
skill-foundationルール・出力検査・hooks・違反例・収束テストを備えたスキルを作る。pluginで導入
my-skill-creatorスキルを作成・改善して検証する
skill-refiner1つのスキルを独立実行し、HTMLで指摘・評価・改善を進める

組み合わせて使う場合はワークフローを参照してください。各ページには入力と成果物の例を掲載しています。

Skill単体の導入と、複数Skill・hooksをまとめるplugin配布の使い分けはSkillとpluginの配布・導入を参照してください。Codex・Claude Code向けの編集用構造と配布物の関係も説明しています。

配置・候補探索のルール​

共通スキルは主な用途で分類し、最大2階層までの分類を使います。直下へ置く構成も許容します。現在の分類は共通スキル一覧で確認できます。

utils/skills/<skill-name>/SKILL.md
utils/skills/<category>/<skill-name>/SKILL.md
utils/skills/<category>/<subcategory>/<skill-name>/SKILL.md

SKILL.mdを直接持つディレクトリを一つの候補とし、候補名には末尾のスキル名だけを使います。分類名は小文字のkebab-caseにして、既存の分類を優先します。

探索でスキルを見つけたら、その配下のvendor/などを別候補として扱いません。同梱スキルはscripts・assets・referencesとともに親スキルの一部です。共通候補は分類をまたいで名前を一意にし、重複があれば全該当パスを示して配布を止めます。

プロジェクト固有スキルはprojects/<repo-name>/skills/<skill-name>/SKILL.mdへ配置します。同名の共通スキルよりプロジェクト側を優先しますが、共通側の重複エラーを隠してはいけません。

リポジトリの配布用CLIでSkill単体をコピーする構想では、分類階層を含めず、選んだスキルのディレクトリ全体を.claude/skills/<skill-name>/と.codex/skills/<skill-name>/へ同じ内容でコピーします。このCLIは未実装です。npx skills addによる導入先はSkills CLIが管理するため、このコピー先と同一とは限りません。

plugin配布ではSkill正本を参照して配布物へコピーし、Agentごとのplugin管理から導入します。編集用のplugin定義と、利用者に届けるpluginの構造は配布・導入ガイドで区別しています。