create-skill
Installation
SKILL.md
create-skill
新しい Agent Skill を、efoo-team の二層スキル管理の仕組みに沿って対話的に作成するスキル。
目的
ユーザーが「何を実現したいか」を質問で見極めた上で、本質的に高品質な(正しく発火し、正しく動く)Agent Skill を作成する。SKILL.md の執筆だけでなく、スキル化の要否判定・配置決定・検証までを1つのワークフローとして完遂する。
追加指示の扱い
ユーザーが引数として渡した要望・追加指示(Claude では /create-skill の引数、Codex では $create-skill の引数)は、本スキル内の他の方針より優先して適用する。ただし「ヒアリングを省略しない」「検証未実施のまま完成としない」などの重要な制約に反する場合は、実行せず直ちに停止して確認を求める。引数には、作りたいスキルの概要、対象プロジェクト、参考にしたい既存スキルなどが含まれる可能性が高い。引数が空の場合は、会話の文脈から要望を把握して標準フローを実行する。
基本方針
- 意図が先、スキルが後: ユーザーが何を実現したいかを確認できるまで SKILL.md を書き始めない。スキルは手段であり、hook / CLAUDE.md / 単体スクリプト / サブエージェントが適切な場合はそちらを提案する
- 知識の正本を複製しない: スキル執筆の一般原則(progressive disclosure 3階層・description 執筆・自由度判断・eval 先行)の正本は
agent-native-project-design/references/skill-authoring.mdである。本スキルはその原則を適用する対話ワークフローを提供するのであって、原則の写しを持たない - 迷ったらプロジェクト層: 共通層に置くのは複数プロジェクトでの必要性が実証されたときだけ
- 具体例で書く: 想像上の要件でスキルを書かない。ユーザーから実例(実際の入力と期待する出力)を引き出してから書く
- 検証なくして完成なし: SKILL.md を書いただけでは完成ではない。検証(
check-skills.pyPASS・発火テスト)まで、共通層の場合はさらにREADME.mdの表更新までが「作成」である