Claude Code向けのスキル作成原則（159のオープンソーススキルから）

開発者が、159のスキルを持つオープンソースのスキルレジストリを構築・維持する経験から得た、Claude Code向けの効果的なスキル作成のための10の原則を公開しました。これらの原則は、実際のエージェントの使用状況から観察された実用的な実装パターンに焦点を当てています。

スキル作成の主要な原則

• 自明なことは書かない - Claudeのデフォルト動作を強化するのではなく、そこから押し出す
• 注意点セクション - あらゆるスキルの中で最も投資対効果の高いコンテンツとされる
• スキルはファイルではなくフォルダ - references/、scripts/、assets/などのサブディレクトリを使用する
• レールを敷きすぎない - 厳密な手順ではなく、ガイドラインを提供する
• 初回セットアップはconfig.jsonで - 設定ファイルはスキルフォルダに直接配置する
• 説明フィールドはトリガー条件 - 単なる要約ではない
• スキルに記憶を持たせる - 実行間でログ、JSON、またはSQLiteを使用する
• 説明文と一緒にスクリプトも提供する - 例: 200行の説明よりもfetch_events.pyの方が価値がある
• オンデマンドフック - /carefulブロックを使用して、呼び出された時のみ破壊的なコマンドを制限する
• スキルは組み合わせ可能 - 他のスキルを名前で参照する。インストールされていればClaudeが呼び出す

実装の詳細

これらの原則は、AbsolutelySkilledリポジトリ（github.com/AbsolutelySkilled/AbsolutelySkilled）から得られたもので、159のオープンソーススキルが含まれています。すべてのスキルはnpx skills addでインストール可能です。開発者は、これらのパターンが理論的な設計からではなく、実際にエージェントがスキルをどのように使用するかを観察する中で生まれたことを強調しています。

AIコーディングエージェント向けのスキルを構築する開発者にとって、これらの原則はスキルを効果的に構造化するための具体的な指針を提供します。単一ファイルではなくフォルダを使用することや、説明だけでなく実際のスクリプトを含めることなど、実用的な実装に焦点を当てることは、実際の使用パターンを反映しています。