skill-design-philosophy

スキル設計の理念

スキルが提供するのは知識とコンテキストであり、自律的な実行ではありません。

知識テスト

次のように問いかけてください。「これはClaudeに何かを教えるものか、それとも何かを実行するものか？」

教える（スキル）	実行する（エージェント）
コーディング規約	リンターを実行してコードを修正する
ワークフローの方法論	複数ステップのプロセスを実行する
フレームワークのパターン	レポートを生成する
ツールの使用方法に関するガイダンス	データを取得して分析する

**ルール：**ユーザーの指示がなくても成果物を生成するなら、おそらくエージェントです。

良いスキルの例

スキル	効果がある理由
dhh-coder	コーディングスタイルのガイダンス。Claudeがコードを書く際に適用するパターンです
tdd-workflow	方法論に関する知識。テスト駆動開発でClaudeが従う手順です
stimulus-coder	フレームワークのパターン。StimulusコントローラーでClaudeが使う規約です
pdf-processing	ツールに関する知識。特定のライブラリやスクリプトの使い方です

**パターン：**スキルはClaudeにパターン、規約、アプローチを教えます。

悪いスキルの例

スキル	うまくいかない理由
「コードレビュー担当」	自律的に作業します。エージェントにすべきです
「Gitヘルパー」	範囲が曖昧です。具体的に何を教えるのでしょうか？
「ベストプラクティス」	範囲が広すぎて、実践につながりません
「ドキュメント生成ツール」	成果物を作成します。エージェントにすべきです

**パターン：**これらのスキルは何かを教えるのではなく、何かを実行します。

コンテンツのルール

含める内容	除外する内容
具体的なパターンと規約	ペルソナを示す文（「あなたは専門家です……」など）
具体的なテンプレートと例	出典の記載（「Xに触発されて……」など）
判断基準	装飾的な引用
エラー処理のガイダンス	ASCIIアートや罫線文字
フレームワーク固有のイディオム	曖昧な「ベストプラクティス」

品質テスト

「このスキルの各行はすべて、Claudeの動作を改善していますか？」

装飾的、鼓舞するだけ、または冗長な行があれば、削除してください。