RyoMurakami1983 スキルルーター
スキルそのものを作る・直す・確かめる・測る話題を、1 本の入口から適切な sub-skill へ案内します。単一入口にする理由は、会話の途中で「作成 → 検証 → 改善」のように論点が切り替わっても、同じ文脈のまま扱えるようにするためです。
こんなときに使う
- 新しいスキルをアイデアや仕様から作り始めたいとき
- 既存スキルをレビュー結果や利用時の違和感に基づいて改善したいとき
- スキルの構造や説明品質を広く使う前に確認したいとき
- スキルが本当に挙動を改善するか比較評価したいとき
- 関連する複数スキルをまとめて設計したいとき
判断表
| やりたいこと | ルート | 次にやること |
|---|---|---|
| 新しいスキルを作る | sub_skills/new/ |
意図整理、制約調査、雛形作成、初期検証まで進める。 |
| 既存スキルを改善する | sub_skills/improve/ |
変更の種類を見極め、弱い guidance を削り、説明と metadata を磨く。 |
| 品質を確認する | sub_skills/validate/ |
L1-L4 の順で検証し、どこが出荷の妨げかを明確にする。 |
| 効果を測定する | sub_skills/evaluate/ |
ケース設計、baseline / legacy / current 比較、集計、次アクション判定を行う。 |
| スキル群をまとめて作る | sub_skills/new/ |
バッチモードで命名と相互参照をそろえる。 |
共通リソース
_foundation/TEMPLATE.md— 最小の hot path を保つ workflow template_foundation/ROUTER_TEMPLATE.md— 親 router 用 template_foundation/SUB_SKILL_TEMPLATE.md— nested sub-skill 用 template_foundation/QUALITY.md— Critical / Recommended checks の基準_foundation/CONVENTIONS.md— naming、frontmatter、書き方の約束_eval/— behavioral evaluation assets と validation scriptsscripts/— generator、packaging、index maintenance の再利用コード
ルーティングメモ
- ユーザーの現在地点から最短で役立つ sub-skill に飛び込む。
- 用語は相手の literacy に合わせ、必要なら専門語を説明する。
- この repo では Python helper script を bare
pythonではなくuv run python ...で実行する。 - 実行ロジックは router に書かず、sub-skill や script に委譲する。
注意点
- router に実行詳細を書き込みすぎない: 親が重くなると route 判断より説明の重複が増え、sub-skill の役割がぼやける。
- route 粒度を細かくしすぎない: 似た route を増やすと判断表がノイズになり、かえって到達性が落ちる。