write-agentmemory-skill

agentmemory のスキルは、読みやすく、正確で、最新の状態を保てるよう、統一された階層形式に従います。必ずこの形式に合わせてください。

ディレクトリ構成

plugin/skills/<name>/
  SKILL.md      (required, under 100 lines)
  REFERENCE.md  (optional, dense facts; auto-generate data tables)
  EXAMPLES.md   (optional, worked transcripts)
  TROUBLESHOOTING.md (generated support file)

SKILL.md のルール

• フロントマター：name、description、任意の argument-hint、user-invocable を指定します。ユーザーがスラッシュコマンドとして実行するスキルに限り、user-invocable: true に設定します。リファレンススキルとナレッジスキルは false にします。
• 説明は2文で構成し、エージェントがスキルを読み込むかどうかを判断する際に参照する唯一の情報とします。1文目では機能を述べます。2文目は「Use when」で始め、具体的なトリガーを列挙します。関連する他のスキルと区別し、1024文字未満で、三人称で記述します。
• 本文の順序：クイックスタート（具体例を1つ）、理由（基本原則）、ワークフロー（判断の分岐を含む番号付き手順）、アンチパターン（最もよくある間違いについての WRONG 対 RIGHT のコールアウト）、チェックリスト、関連項目（兄弟スキルへの相互リンク）、リファレンスまたはトラブルシューティングへのポインター。
• 100行未満にします。詳細な情報は REFERENCE.md に、例は EXAMPLES.md に移します。
• 補足ファイルはスキルのディレクトリ内に置き、各スキルを個別にインストールしても機能するようにします。TROUBLESHOOTING.md にリンクしてください。ジェネレーターは共通の復旧手順を各スキルのルートにコピーします。

最新の状態を保つ

ソースにある事実（ツール名とパラメーター、REST エンドポイント、環境変数、接続アダプター、フックイベント）は、手作業で記述せず、生成します。ソースを編集してから npm run skills:gen を実行してください。CI は npm run skills:check を実行し、差分がある場合は失敗するため、生成されたテーブルがコードに追随できなくなることはありません。

スタイル

外部製品名や競合製品名は使用しません。絵文字は使いません。ダッシュ記号は使いません。余分な説明は加えません。要点だけを述べてください。

チェックリスト

• 説明に、実際のトリガーを含む「Use when」の文があること。
• SKILL.md が100行未満であること。
• 時間の経過で古くなる主張がなく、トラブルシューティングの内容が重複していないこと。
• 具体例があり、生成対象の事実がジェネレーターから取得されていること。
• 相互リンクが有効で、リンク先が1階層先にとどまっていること。