パーソナルスキルビルダー
特定の反復可能なワークフローに対して、エージェントの意思決定を改善する小さな発見可能なスキルを作成します。
スコープ
このスキルは、新しいスキルを作成する場合、または既存のスキルに焦点を絞った変更を加える場合に使用します。ユーザーが要求した場所、呼び出しポリシー、および認可境界を保持してください。エージェントがすでに知っている一般的なアドバイスを保持するためだけにスキルを作成しないでください。
ワークフロー
-
ファイルを書き込む前にタスクの境界を定義します：
- スキルはどのような反復可能な成果を提供しますか？
- どのリクエストがスキルを有効にし、どの類似リクエストは有効にすべきではありませんか？
- どのような入力、ツール、副作用、完了チェックが重要ですか？
-
既存のスキルを変更する前に検査します。有用なリソースとポリシーを保持し、既存のディレクトリを再初期化しないでください。
-
最小限の構造を選択します：
SKILL.mdは必須です。references/は、判断を変更する実質的で条件付きのマテリアルがある場合にのみ追加します。scripts/は、実行によって信頼性が向上する反復的または決定論的な作業がある場合にのみ追加します。assets/は、生成された出力で使用されるファイルがある場合にのみ追加します。
-
SKILL.mdを記述します：- フロントマターの
nameは小文字のハイフン区切りで、ディレクトリ名と一致し、最大64文字にします。 descriptionは、スキルが何をするか、いつ適用されるかの両方を記述し、誤ルーティングを防ぐための境界を含めます。- 本文は、成果、非自明なルール、実行順序、確認ポイント、完了チェックに焦点を当てます。
- 条件付きの詳細はリンクされたリソースに配置し、いつそれを読むべきかを正確に記述します。
- フロントマターの
-
環境が提供する場合（インストールされた
skill-creatorスキル配下のquick_validate.pyを特定します）、利用可能なスキルバリデーターで結果を検証します：python3 <skill-creator>/scripts/quick_validate.py /path/to/skillバリデーターが利用できない場合は、同等のフロントマター、命名、リソースリンク、プレースホルダー、スクリプトチェックを手動で実行します。追加したスクリプトは実用的な範囲で実行します。
設計ルール
- 説明は機能カタログではなくルーティング条件として扱います。
- 共有手順は日常的な読み込みに十分短く保ち、外部仕様全体をエントリポイントにコピーしないでください。
- 広範な禁止事項や曖昧な品質形容詞よりも、明示的なスコープと観測可能な完了基準を優先します。
- 具体的なワークフローで使用されないREADMEファイル、例、テンプレート、リソースディレクトリを追加しないでください。
- スキルを更新する際は、既存のサポートされているフロントマターと
agents/openai.yamlフィールドを保持します。 - ユーザーが明示的に明示的な呼び出しのみを要求しない限り、自動ディスカバリーを有効にしたままにします。
参照
移植性、フロントマターフィールド、命名制限、読み込み動作が不明な場合は、Agent Skills 仕様 を参照してください。ユーザーが提供した、またはマシンローカルの設計ガイドは、オプションの優先ソースとして扱います。ユーザーが明示的にそれらの規則を要求した場合、またはタスクがそれらに依存する場合にのみ読み取り、その全文をスキルにコピーしないでください。初期化子、UIメタデータ、検証の詳細については、マシン固有の絶対パスに依存する代わりに、インストールされている skill-creator スキルを参照してください。