building-skills-from-patterns

パターンからスキルを作成する

スキルは、再利用可能なSKILL.mdファイルです。このメタスキルは、エージェントに繰り返し行う作業を名前付きのスキルにまとめるよう指示します。一度調査してワークフローを記述すれば、いつまでも再利用できます。

トリガーとなる条件

• ユーザーから同じ手順を3回以上依頼された場合（例：「コミット前に必ずlint、次にtsc、最後にテストを実行する」）。
• このリポジトリ内のタスクで、エージェントが同じ手順を毎回再導出していることに気付いた場合（例：「プレビュー用ブランチのデプロイ方法」）。
• 修正内容がポリシーのように聞こえる場合（「ここでは生のSQLを決して使わず、必ずリポジトリレイヤーを使う」）。常に適用すべきならsuggesting-cursor-rulesと組み合わせ、手順を伴う作業ならスキルを使います。

ワークフロー

1. パターンに名前を付ける

短いスラッグ（小文字、ハイフン区切り）を選びます。例：verifying-api-before-merge、releasing-mobile-buildなど。

2. SKILL.mdを作成する

.cursor/skills/<slug>/SKILL.mdを作成します（または、このリポジトリのパターンに従って上流への貢献時にはresources/<slug>/SKILL.mdからコピーします）。

フロントマター：

---
name: <slug>
description: One line: what it does and when to use it. Ends with a clear trigger.
user-invocable: true   # optional, if the user should be able to invoke by name
---

本文のセクション（簡潔にまとめます）：

1. タイトル — 人が読んで分かるタイトル。
2. 使用するタイミング — 箇条書き。
3. 手順 — 番号付きで、命令形にします。必要に応じてツール名（npm、gh、MCP ツールなど）を記載します。
4. メモ — 例外的なケース、安全性、使用しない状況。

このリポジトリのほかのスキルに合わせたトーンにします。具体的なコマンドを記載し、余計な説明は省きます。

3. 検証する

• ユーザーがタスクについて説明したとき、Cursorがスキルを適切に照合できるだけの具体性が説明にあること。
• リポジトリの構成を推測せずにエージェントが実行できる手順になっていること（または「ロックファイルからパッケージマネージャーを特定する」と記載します）。
• シークレットやマシン固有のパスが含まれていないこと。

4. ユーザーに場所を知らせる

ファイルの保存場所と、そのワークスペースで次回チャットを開始したときにエージェントがスキルを認識することをユーザーに伝えます。

ルールおよびフックとの関係

仕組み	用途
スキル	オンデマンドの手順、分岐のある手順、ツールの使用。
ルール（.cursor/rules/）	常に適用される規約、スタイル、ファイルパターン。
フック（.cursor/hooks.json）	ファイル保存後や停止時のイベントを自動化します。

「保存するたびにXを実行する」というパターンなら、代わりにフックを提案します。「リリースを依頼されたとき」というパターンなら、スキルとして扱います。

メモ

• 1つのワークフローにつき1つのスキルを推奨します。あらゆる状況を網羅しようとする巨大なスキルは避けてください。
• ワークフローが進化した場合は、重複して追加するのではなく、既存のスキルを更新します。