Agent Skills

Agent Skills は、AI エージェントに特化した機能を追加するためのオープン標準です。スキルは、エージェントが特定のタスクを実行する際に使用できる、ドメイン固有の知識とワークフローをパッケージ化したものです。

スキルとは？

スキルは、エージェントにドメイン固有のタスクの実行方法を教える、持ち運び可能でバージョン管理されたパッケージです。スキルには、エージェントがツールを使って利用できるスクリプト、テンプレート、リファレンスを含めることができます。

スキルの仕組み

Cursor の起動時に、スキルディレクトリからスキルが自動的に検出され、エージェント で利用できるようになります。エージェントには利用可能なスキルが提示され、コンテキストに応じて必要かどうかを判断します。

エージェント チャットで / を入力し、スキル名を検索して手動で呼び出すこともできます。この方法で呼び出したスキルは、1 つのメッセージに添付されます。セッション全体でスキルを有効にしておくには、Option+EnterAlt+Enter (Mac) または Alt+Enter (Windows) でカスタムモードとして使用します。カスタムモードを参照してください。

Cursor 組み込みスキル

Cursor には、一般的なワークフローを効率化するための組み込みスキルがいくつか用意されています。これらのスキルは Cursor によって管理され、自分で追加したスキルとともに表示されます。

Agent チャット で / を入力し、スキル名を選択すると、任意の組み込みスキルを実行できます。リクエストがその目的に明確に合致する場合は、エージェントが一部の組み込みスキルを自動的に使用することもあります。

スキルディレクトリ

スキルは次の場所から自動的に読み込まれます。

互換性のため、Cursor は .claude/skills/、.codex/skills/、~/.claude/skills/、~/.codex/skills/ の Claude および Codex ディレクトリからもスキルを読み込みます。

各スキルは、SKILL.md ファイルを含むフォルダーである必要があります。

.agents/└── skills/    └── my-skill/        └── SKILL.md

スキルには、スクリプト、リファレンス、アセット用の任意のディレクトリを含めることもできます。

.agents/└── skills/    └── deploy-app/        ├── SKILL.md        ├── scripts/        │   ├── deploy.sh        │   └── validate.py        ├── references/        │   └── REFERENCE.md        └── assets/            └── config-template.json

ネストされたスキルディレクトリ

スキルディレクトリはサブディレクトリに整理できます。関連するスキルをカテゴリ、チーム、ドメインごとにグループ化するのに役立ちます。Cursor はスキルのルートディレクトリを再帰的に探索し、見つかったすべての SKILL.md を読み込みます：

.cursor/└── skills/    ├── shipping/    │   ├── land-it/    │   │   └── SKILL.md    │   └── careful-merge-conflicts/    │       └── SKILL.md    ├── debugging/    │   └── using-datadog-mcp/    │       └── SKILL.md    └── workflow/        └── tdd/            └── SKILL.md

カテゴリーフォルダーは整理目的にすぎません。スキルのIDは親カテゴリではなく、SKILL.md を含むフォルダー (ここでは land-it、tdd など) で決まります。

Cursor は、ネストされたプロジェクトのサブディレクトリ内にあるスキルも検出します。リポジトリ内のどこにある .cursor/skills/ (または .agents/skills/) フォルダーも検出されるため、モノレポではスキルを適用先のパッケージと同じ場所に配置できます。

my-monorepo/├── .cursor/skills/         # リポジトリ全体で使用するスキル│   └── land-it/SKILL.md└── apps/    └── web/        └── .cursor/skills/  # アプリ固有のスキル            └── deploy-web/SKILL.md

ネストされたプロジェクトディレクトリ内のスキルは、そのディレクトリ内のファイルに自動的に適用されます。上記の例では、deploy-web はエージェントが apps/web/ 配下のファイルを扱う場合にのみ表示され、リポジトリ全体の .cursor/skills/ 内にあるスキルはどこでも利用できます。これは paths フロントマターフィールドと同様です。ネストされたスキルをそのディレクトリに適用するために、paths を設定する必要はありません。

SKILL.md ファイルの形式

各スキルは、YAML フロントマターを含む SKILL.md ファイルで定義します。

---name: my-skilldescription: Short description of what this skill does and when to use it.---# My SkillDetailed instructions for the agent.## When to Use- Use this skill when...- This skill is helpful for...## Instructions- Step-by-step guidance for the agent- Domain-specific conventions- Best practices and patterns- Use the ask questions tool if you need to clarify requirements with the user

フロントマターのフィールド

スキルを特定のファイルに適用する

paths フィールドを使用すると、1 つ以上のグロブパターンに一致するファイルにスキルを限定できます。スキルは、エージェントが一致するファイルを読み取りまたは編集している場合にのみ表示されます。これにより、ファイル固有のガイダンスが無関係な作業のコンテキストに含まれるのを防げます。

---name: react-component-patternsdescription: Conventions for writing React components in this codebase.paths:  - "**/*.tsx"  - "packages/ui/**/*.ts"---# React component patterns...

カンマ区切りの単一の文字列を渡すこともできます：

---name: python-styledescription: Style rules for Python files.paths: "**/*.py, scripts/**/*.py"---

パターンには標準の glob 構文を使用します。開いているファイルに関係なく利用可能にするスキルでは、paths を設定しないでください。

自動呼び出しを無効にする

デフォルトでは、エージェントが関連すると判断したスキルが自動的に適用されます。disable-model-invocation: true を設定すると、スキルは従来のスラッシュコマンドのように動作し、チャットで /skill-name を明示的に入力した場合にのみコンテキストに含まれます。

スキルをカスタムモードとして使う

有効なフロントマターブロックを持つスキルは、カスタムモードとして使用でき、セッション全体を通してスキルがコンテキストに保持されます。有効なモードは、チャット入力にバッジとして表示されます。任意のiconおよびcolorフロントマターフィールドでスタイルを設定できます。

---name: tdddescription: Test-driven development playbook for this repo.icon: beakercolor: green---

アイコンには Cursor のアイコンセットを使用します。名前は code、terminal、bug、git-branch、book-open、beaker、shield、rocket などです。認識されないアイコンや色には、稲妻アイコンのデフォルトバッジが使用されます。

スキルにスクリプトを含める

スキルには、エージェントが実行できるコードを含む scripts/ ディレクトリを含めることができます。SKILL.md では、スキルのルートを基準とした相対パスでスクリプトを参照します。

---name: deploy-appdescription: Deploy the application to staging or production environments. Use when deploying code or when the user mentions deployment, releases, or environments.---# Deploy AppDeploy the application using the provided scripts.## UsageRun the deployment script: `scripts/deploy.sh <environment>`Where `<environment>` is either `staging` or `production`.## Pre-deployment ValidationBefore deploying, run the validation script: `python scripts/validate.py`

エージェントはこれらの指示を読み取り、スキルが呼び出されると、参照先のスクリプトを実行します。スクリプトは、Bash、Python、JavaScript のほか、エージェント実装でサポートされる任意の実行可能な形式で記述できます。

オプションのディレクトリ

スキルでは、以下のオプションのディレクトリをサポートしています。

メインの SKILL.md は要点に絞り、詳細なリファレンス資料は別ファイルに移してください。エージェントは必要なときにのみリソースを段階的に読み込むため、コンテキストを効率的に利用できます。

スキルを表示する

検出されたスキルを確認するには、サイドバーで カスタマイズする を開き、Skills に移動します。プラグインまたはプロジェクトからインストールしたスキルは、Agent Decides セクションにルールとともに表示されます。

GitHub からスキルをインストールする

GitHub リポジトリからスキルをインポートできます。

1. サイドバーで カスタマイズする を開く
2. ルールに移動し、ルールを追加をクリックする
3. **リモートルール (GitHub) **を選択する
4. GitHub リポジトリの URL を入力する

ルールとコマンドをスキルに移行する

Cursor 2.4 には、既存の動的ルールとスラッシュコマンドをスキルに変換するための組み込み /migrate-to-skills スキルが用意されています。

移行スキルで変換される項目:

• 動的ルール: 「Apply Intelligently」設定を使用するルール、つまり alwaysApply: false (または未定義) で、globs パターンが定義されていないルールです。これらは標準スキルに変換されます。
• スラッシュコマンド: ユーザーレベルとワークスペースレベルのコマンドはいずれも、明示的に呼び出す挙動を維持したまま、disable-model-invocation: true を設定したスキルに変換されます。

移行するには:

1. エージェント チャットで /migrate-to-skills と入力します
2. エージェントが対象となるルールとコマンドを特定し、スキルに変換します
3. .cursor/skills/ で生成されたスキルを確認します

詳しく見る

Agent Skillsはオープン標準です。詳しくはagentskills.ioをご覧ください。