jh-create-skill

構成

ファイル構成

skill-name/
├── SKILL.md
└── scripts/          # optional

すべての手順、ルール、例は SKILL.md に記載してください。他の兄弟ドキュメントは追加しないでください。

フロントマター

---
name: your-skill-name
description: Brief high-level description of what this skill does.
disable-model-invocation: true
metadata:
  dependencies: other-skill
  dependents: downstream-skill
---

• name: kebab-case で、最大 64 文字。小文字、数字、ハイフンのみを使用してください。
• description: スキルの機能を非常に大まかにまとめた 1 文にしてください。仕組みの詳細、呼び出すタイミング、トリガーとなる語句は含めないでください。
• metadata:
  • dependencies: エージェントに読み、従うよう指示するスキル（**`skill-name` skill**, **`skill-name`**、または skill-name/SKILL.md へのリンク）。スキル間の依存関係のみを指定してください。フックやサブパスは含めません。
  • dependents: その逆です。両側の内容を一致させてください。
  • name の値はカンマ区切りにしてください。空のフィールドは省略してください。
  • 本文でスキルを明示していない限り、成果物の名前や共通のツールから依存関係を推測しないでください。

内容

writing-for-agents スキルを読み、その指示に従ってください。このスキルでは、スキル固有の仕組みのみを扱います。

• いかなる種類の見出しも含めないでください。タイトル、説明、冒頭のセクション、導入、前置きは不要です。
• 本文でエージェントにそのスキルのワークフローを実行させる場合に限り、スキルを dependencies に記載してください。単独の事実やルールは、ここに記載したままにしてください。
• スキルを記載する場合は、その依存先がすでに担っている手順やルールを本文から削除してください。繰り返してはいけません。

1 回の実行ではなく、タスクについて記述する

スキルでは、ある種のタスクを実行する方法をエージェントに伝えます。すでにエージェントが実行した1 回のセッションの記録ではありません。

スキルに記載すること

• 順序立てたワークフローと対象範囲の制限（実行すること、スキップすること）。
• エージェントが違反すると問題になる必須ルール（環境上の注意点、「remsh を停止してはいけない」、承認ゲートなど）。
• そのワークフローを担当する他のスキルへの参照。

記載しないこと

• スキル名と説明がその機能のみを明示的に対象としている場合を除き、単一の機能に属する手順。
• 過去の実行内容のコピー＆ペースト：サンプルのメッセージ本文、TypeID、SQL、Oban ワーカー名、API ルート、Redis キー、「ジョブをキャンセルしてからステータスをリセットする」手順など、一度限りのスクリプトに相当するもの。
• ユーザーのリクエスト、テスト、コードベースからエージェントが実行時に取得できる詳細。

実行時に、エージェントは具体的な情報を得るためにユーザーの依頼とリポジトリを読みます。そうした情報が変わっても、スキルの内容は変わらないようにしてください。