clarify-skill

Installation
SKILL.md

スキルの目的

スキルは読み込まれるたびにエージェントの文脈を使い、そのエージェントの振る舞いを決定する。点検の目的は、読んだエージェントがスキルの目的と受け持つ範囲を理解し、記述されていない場面でも目的に合う判断ができる状態にすることだ。手順・ツール・出来事・数値を細かく書き込むと、記述した場面の外で振る舞いが決まらず、ツールや環境が変わったときに古い指示が残る。

このスキルが変えるのは、指示の書き方と置き場所だけだ。スキルに記述された業務の決まり(何を正とするか、人から受けた指摘で決まったこと)は、中身を落とさずに残すか、正しい置き場所へ移す。

呼び出し元は、このスキルを頼んだユーザー、またはこのスキルを呼んだエージェントだ。

当てる決まりは、点検するスキルを置くリポジトリやプロジェクトの指示ファイルと開発の文書(スキル・ツール・規則の置き場所と書き方の決まり)と、そのリポジトリが従う上位の文書(組織やチームで共通の決まり)にある。スキルの書き方の決まりが見つからないときは、スキル writing-rules のフォルダの references/writing-instructions.md の方針と、下の観点の表の「満たされた状態」を基準にする。

点検するスキルを置くリポジトリやプロジェクトに、ユーザーと合意した拘束の記録があれば読む。記録にある拘束は、観点に該当しても指摘しない。ユーザーが合意して定めた形式を、点検で縛りすぎとして外さないためだ。点検や書き直しの途中でユーザーと新しく拘束を合意したら、記録に追加する。記録が無ければ、記録を置く場所を修正する方針に記載する。

review-for-readers・remove-meta-narrative との分担

review-for-readers は、人に渡す文書を、経緯を知らない読み手の視点で読み直す。remove-meta-narrative は、文書自身や作った経緯を語る文を除く。このスキルは、スキルをエージェントへの指示文として見て、目的が伝わるか、縛りすぎていないか、置き場所が合っているかを点検する。

  • 観点 3・4・16 は writing-instructions.md の方針と重なる。指示ごとの目的、選べる幅、記述しなくても変わらない文の除き方は、writing-instructions.md に沿う。
  • 観点 2 の出来事や出所の記録と、観点 16 の書き手の造語は、メタ記述や読み手の引っかかりとも重なる。メタ記述は remove-meta-narrative で、読み手の引っかかりは review-for-readers で修正する。
  • スキルの目的・受け持ち・置き場所・実行環境・呼ばれ方のように、文書の読みやすさでは見つからない点は、このスキルが受け持つ。
Installs
26
First Seen
Nov 6, 2026