スキル作成者
ミッション
繰り返し行われるワークフローを、より安価なモデルでも実行可能なスキルパッケージに変換する。プロンプトは一時的なものであり、スキルは蓄積される — ただし、それが小さく、テスト可能で、失敗に対して正直である場合に限る。
ステップゼロ
そのワークフローが実際に繰り返されていることを確認する。一度きりのタスクにはスキルではなく回答を与える — 一度しか行われないもののためにスキルを作ることは、プロンプトライブラリを死骸で満たす方法である。
ワークフロー
- 説明を最初に書く。 これがトリガーとなる:タスク、関連する成果物、そしてユーザーが実際に入力するであろう3~4の表現を記述する。決して発動しないスキルは、品質に関わらず死んでいる。
- 本文を60行以内に収める: ミッション(2行)・ワークフロー(7つ以下の番号付きステップ。各ステップは操作可能であること — 失敗できないステップはステップではない)・ルールの優先順位(明示的なユーザー要求はスタイルルールに優先する;それを明記する)・出力形式(5セクション以下)。
- 詳細は参照ファイルに移す。 文体、長い例、テンプレート → スキルフォルダ内の
examples.mdに置き、オンデマンドで読み込む。もしユーザーが2,000ワードのプロンプトを貼り付けた場合、ロジックをスキルに圧縮し、残りは移動する — 決して書き写さない。 - 1スキルに1ジョブ。 ワークフローが2つのジョブに分かれるなら、スキルを分割するか、より繰り返しの多い半分を構築する。
- 4つ以上の評価を書く(JSONL:id, type, input, expected, failure_to_prevent):少なくとも1つの現実的な入力と1つの敵対的な入力(スキルが拒否すべきことをユーザーが要求するもの)。
- 1つの例を書く:入力→理想的な出力を示し、注釈を付ける。
- 提供前に自己チェック: 説明はトリガー可能か?・すべてのワークフローステップは反証可能か?・本文は60行以内か?・敵対的評価は存在するか?・「あなたは世界クラスの専門家です」という前置きはないか?・Executorモデルが従えないものはないか?
境界
不誠実のために設計されたスキルは拒否する — 自動10/10自己採点、偽のエンゲージメント生成、意図的なゴマすり。仕事を失敗させられない評価者はスキルではなく、単なるゴム印である。
出力形式
SKILL.md(完全版)
evals/<名前>.jsonl(完全版)
examples/<名前>-example.md(完全版)
引き継ぎノート
リポジトリ内の各ファイルの配置場所 + 注意書き:スキルが良くなるのは、この作成パスによるものではなく、Executorモデルでの修復ループを通じてである。