Communityライティング&編集github.com

AradhanaID/agent-skills

4つのチェック(トリガー、構造、誘導、剪定)を用いてスキルを作成または書き直します。

agent-skills とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)向けに高品質なスキル(指示ファイル)を作成・改善するためのメタスキルです。「4つのチェック」――トリガー(誰が・いつ起動するか)、構造(実際の作業手順)、誘導(モデルの事前知識を活用したキーワード選び)、剪定(不要部分の削除)――を通じて、読みやすさだけでなく実際の動作で評価されるスキルを生成します。サポートするプラットフォームはファイルベースのスキルシステム全般で、特にエージェントが自律的に参照するmodel-invokedスキルと、ユーザーが明示的に呼び出すuser-invokedスキルの区別を重視します。スキル作成後も実実行での挙動をもとに反復改善を行い、失敗があった場合はreference.mdのチェックリストで原因を特定してから書き換えるプロセスを組み込んでいます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AradhanaID/agent-skills/tree/HEAD/skills/write-a-skill

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

スキルを書く

このランの目的は、1つのスキルを作成または書き直すことです。出力は、スキルが実行されたときの動作で評価され、読みやすさでは評価されません。このランは、ユーザーのプロセスをインストールするものであり、汎用的なスキルのテンプレートを提供するものではありません。

書き始める前に、reference.mdにあるコンテキストポインタに従ってください。フロントマターの仕組みはそちらにあります。

手順

  1. トリガーを固定する。 誰がスキルに到達しなければならないか、いつ到達するかを尋ねます。意図的にのみ実行されるスキルは ユーザー起動型(disable-model-invocation: true、説明は1行の人間向け要約、100文字未満)です。エージェントがプロンプトなしで自発的に到達しなければならないスキルは モデル起動型 です。説明は常にロードされるポインタであり、その文言が実行のトリガーとなるかどうかを決定します。 完了条件:起動の選択が、それが負担する負荷(コンテキスト、またはあなたの記憶)に名前を付けていること。
  2. 作業が実際にどのように実行されるかを棚卸しする。 この作業の最後の実際の実行を思い出してください。何が送り返され、修正され、繰り返されたか。それらの修正がスキルの内容です。モデルが支援なしで行うことは内容に含みません。 完了条件:ドラフトが、それが防止する実際の障害を少なくとも1つ引用していること。
  3. 手順を書き、次にポインタを書く。 各手順は、明示的な完了条件を伴う1つの手続きであり、最初に出荷可能なものをチェックできるように順序付けられています。一部のパスでのみ必要な補足資料は、reference.mdに、いつ読むべきかを示すポインタの後ろに配置します。 完了条件:すべての手順が、エージェントに成功したかどうかを尋ねることなく検証可能であること。
  4. 主要な単語を選ぶ。 繰り返し現れる考えごとに、モデルの事前学習にすでに存在するコンパクトな単語を取り上げ、その単語に意味を負わせます。ポインタ、手順、完了条件はそれらの単語を再利用します。専門用語を説明で回避するのではなく、それらの単語に変換します。 完了条件:各主要な単語が複数の場所に出現し、それぞれの場所で誘導していること。
  5. 無操作テストで剪定する。 文ごとに:それを削除し、何が壊れたかを尋ねます。何も壊れなければ、その文は削除します。単語を削るのではなく文全体を削除します。重複は2つの薄い記述ではなく、1つの情報源に集約します。 完了条件:無操作テストをパスなしで実行できなくなり、ファイルが前のバージョンよりも短くなっていること。

参考

  • reference.md — 起動タイプごとのフロントマターの仕組み、ポインタ記述ルール、既存スキルをレビューするためのチェックリスト一式。
  • このランで生成されるスキルは、一度書かれたものではなく、実際の実行に対して反復的に改善されます。実行が誤動作した場合、書き換えの前に参考資料がその失敗を評価します。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

関連スキル