skill-development

スキル開発

このスキルは、抽象的なプラグインテンプレートではなく、現在のローカル環境で Claude スキルを作成または修復するために使用します。

目標

次の条件を満たすスキルを作成します。

• 起動しやすい
• SKILL.md のレイヤーが簡潔
• 言及する references/、examples/、scripts/ ファイルが実際に存在する
• ローカルの参照切れがない

基本ルール

• 1つのスキルにつき、継続的な役割は1つにします。
• フロントマターの説明を、主要な起動の手がかりとして扱います。
• SKILL.md はワークフローと境界に焦点を絞ります。
• 詳細なカタログ、テンプレート、長い説明は references/ または examples/ に移します。
• 存在しないファイルに言及しないでください。
• 古い名前、エージェント、関連スキルへの参照は、ローカルに存在することを確認せずに引き継がないでください。

デフォルトのワークフロー

1. まず現在の環境を調べる

何かを書く前に、次のことを行います。

• 対象のスキルディレクトリを調べる
• 類似の問題をすでに解決している近隣のスキルを調べる
• 実際に存在するエージェント、コマンド、関連スキルを確認する
• 新しい参照を追加する前に、古い参照を特定する

ローカルの一覧を正とします。想像上のプラグイン構成を前提にしたガイダンスを書かないでください。

2. スキルの役割を明確にする

編集前に、次の4点を定義します。

1. スキルが行うこと
2. スキルが起動する条件
3. スキルが明示的に行わないこと
4. 実際に必要な同梱リソース

短いワークフローだけで十分なら、簡潔に保ちます。ディレクトリが慣例だからという理由だけで references/、examples/、scripts/ を作成しないでください。

3. フロントマターを作成または修復する

フロントマターでは、次の点に注意します。

• name には実際のスキル識別子を使用する
• 三人称で起動条件を説明する
• ユーザーが自然に使う具体的なフレーズを含める
• すばやく確認できる短さにする

次の形式の説明を推奨します。

---
name: skill-name
description: This skill should be used when the user asks to "...", "...", or needs help with ....
---

4. メインファイルを簡潔に保つ

適切な SKILL.md には、通常、次の内容を含めます。

• 短い目標セクション
• 役割の境界
• デフォルトのワークフロー
• 安全性または品質に関するルール
• 追加リソースの短い一覧

次の内容が長くなったら、メインファイルから移します。

• テンプレート
• 網羅的なチェックリスト
• 例外ケースのカタログ
• 出力例
• 長いサンプル

5. 実在する同梱リソースだけを追加する

同梱リソースは、目的に応じて使用します。

• 詳細なガイダンスを必要に応じて読み込む場合は references/
• 実際の出力例やひな型には examples/
• 決定論的な補助ロジックには scripts/

SKILL.md でリソースに言及する場合、そのリソースが存在していなければなりません。 リソースが存在していても、参照も使用もされていない場合は削除してください。

6. 完了前に整合性を確認する

最低限、次の点を確認します。

• フロントマターを解析できる
• 参照しているローカルファイルが存在する
• 関連スキルやエージェントへの参照が実在する
• SKILL.md に、参照ファイルに置くべき内容を詰め込みすぎていない
• 一時ログ、キャッシュ、エディターの生成ファイルがスキルディレクトリ内に残っていない

よくある修復パターン

スキルが長すぎる場合

• 起動条件とワークフローは SKILL.md に残す
• カタログや詳細は references/ に移す
• 別のモデルが最初に読み込むファイルがわかるよう、短い読み込み順を示す

スキルが簡素すぎる場合

• デフォルトのワークフローを追加する
• 具体例またはチェックリストを少なくとも1つ追加する
• スローガンだけのスキルにならないよう、境界を明確にする

スキルに古い参照がある場合

• 参照切れのパスを直ちに削除する
• 古い名前を現在のローカル名に置き換える
• 近隣のエージェント、コマンド、スキルを、実際のディレクトリで再確認する

推奨する出力形式

スキルを作成または修復する際は、最後に次の内容を記載することを推奨します。

• 変更内容
• 作成または更新したファイル
• 実施した整合性チェック
• 手動での追加対応が必要な場合は、その内容

参考資料

必要なものだけを読み込んでください：

• references/checklist.md - スキルの編集を完了する前に確認する、簡潔な品質チェックリスト
• references/integrity-checks.md - ファイルの欠落、参照切れ、差異を確認するための具体的なローカルチェック
• references/skill-creator-original.md - 従来の背景資料です。参考情報として使用し、最新の正式な情報源としては扱わないでください