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コーディングエージェント向けのスキルを構築する開発者にとって、これらの原則はスキルを効果的に構造化するための具体的な指針を提供します。単一ファイルではなくフォルダを使用することや、説明だけでなく実際のスクリプトを含めることなど、実用的な実装に焦点を当てることは、実際の使用パターンを反映しています。
📖 Read the full source: r/ClaudeAI
👀 See Also
開発チームのための実践的Claudeコードワークフロー
RedditユーザーがClaude Codeのベストプラクティスに関する内部プレゼンテーションを共有。モデル選択、構造化されたワークフロー、出力品質を向上させる具体的なプロンプト技術などを含む。
OpenCLAWメモリの実際の仕組み：エージェントの「忘却」問題を解決する
OpenCLAWエージェントは会話間で永続的なメモリを持ちません。毎回、SOUL.md、USER.md、MEMORY.mdなどのファイルからコンテキストを再構築します。一般的な「忘れる」問題は、古いセッション、構造化されていないメモリファイル、重要な情報をチャット履歴ではなく永続的なファイルに保存していないことから生じます。
オープンクロースキルの習得：ステップバイステップガイド
この包括的なガイドでOpenClawの全ポテンシャルを解き放ちましょう。AIコーディングエージェントを使ってプロジェクトを強化するための主要な戦略を学びます。
AIをコード工場ではなく、認知パートナーとして活用する
Redditの投稿では、『Cognitive Authorship Copilot』と呼ばれるシステムプロンプトが提案されています。これは、AIを自律的な解決策生成器ではなく、ペアプログラミングのパートナーとして行動させるもので、タスクの複雑さに基づいて3段階の介入レベルを設けています。