スキル
スキルは、特定のタスクへの対応方法を Agent に教える、再利用可能な指示セットです。ルールよりも詳細で、複数ステップのワークフロー向けに設計されています。
スキルとは？
スキルは、Agent に特化したワークフローを教えるための Markdown ファイルです。たとえば、アプリをステージング環境にデプロイしたり、依存関係全体でセキュリティ監査を実行したりできます。会話をまたいで再利用でき、チーム内で共有することもできます。
スキルを作成するにはどうすればよいですか？
チャットで /create-skill と入力し、作成したいスキルを説明します。Cherri Code には、新しいスキルの名前付け、構成、保存を案内する組み込みスキルが用意されています。
手動で作成するには、.cursor/skills/your-skill-name/ に SKILL.md ファイルを追加します。
# Deploy to staging1. Run the test suite2. Build the production bundle3. Deploy to the staging environment4. Verify the deployment health checkスキルは、.cursor/skills/shipping/deploy-staging/SKILL.md のようにサブフォルダーに整理することもできます。Cherri Code はスキルのルートを再帰的に走査するため、関連するスキルのグループ化にはカテゴリーフォルダーを使えます。スキル名は、その上位のカテゴリではなく、SKILL.md を含むフォルダー名から決まります。
スキルは .agents/skills/、.cursor/skills/、~/.agents/skills/ (ローカルマシン上でグローバル)、および ~/.cursor/skills/ (ローカルマシン上でグローバル) から自動的に読み込まれ、モノレポ内の apps/web/.cursor/skills/ のようなネストされた project サブディレクトリも含まれます。ネストされた project ディレクトリ内のスキルは、そのディレクトリ内のファイルに対して自動的に作用域が設定されます。たとえば、apps/web/.cursor/skills/ 配下のスキルは、paths フロントマター フィールド と同様に、エージェントが apps/web/ 内のファイルを扱うときにのみ表示されます。互換性を保つため、Cherri Code は Claude および Codex のディレクトリ .claude/skills/、.codex/skills/、~/.claude/skills/、~/.codex/skills/ からもスキルを読み込みます。
Cloud Agent で個人のスキルを使うには？
~/.cursor/skills/ にある個人のスキルは、同期するまでお使いのマシン内にとどまります。Settings → Agents を開き、Context and Tools にある Sync Skills for Cloud Agents をオンにしてください。同期したスキルは自分だけが利用できます。
同期されるのは ~/.cursor/skills/ のみです。スキルをチームメンバーと共有するには、チームのマーケットプレイスに公開してください。
チームおよびエンタープライズでは、管理者が Team Settings の Security & Identity から全員の同期をオフにできます。Cloud Agent で個人のスキルを使用するを参照してください。
スキルをチームに公開するには？
Customize → Skills を開き、個人スキルを開いて Publish を選択します。Cherri Code がそのスキルをチームの Default マーケットプレイス に追加するので、チームメンバーはそこからインストールできます。スキルをチームに公開するを参照してください。
Cloud Agents とリモートワーカーでユーザーレベルのスキルは利用できますか？
~/.cursor/skills/ を同期すれば、Cloud Agents でそれらのスキルを使用できます。~/.agents/skills/ と同期していないローカルのスキルは、お使いのマシン上に留まります。これらは Cloud Agents、Agents Window のリモート SSH、または セルフホスト型ワーカーにはコピーされません。セルフホスト型ワーカーでは、リポジトリ内のプロジェクトスキルを使用するか、スキルをワーカーイメージに組み込んでください。
スキルを特定のファイルに限定するにはどうすればよいですか？
スキルのフロントマターに paths フィールドを追加します。スキルは、エージェントが一致するファイルを扱う場合にのみ適用されます：
---name: react-component-patternsdescription: Conventions for writing React components.paths: - "**/*.tsx"---# React component patterns...paths には、グロブパターンのリストまたはカンマ区切りの文字列を指定できます。開いているファイルに関係なく利用可能にするスキルの場合は、未設定のままにしてください。フロントマターの完全なスキーマについては、スキル リファレンスを参照してください。
スキルはどのように使いますか？
チャットで / の後にスキル名を入力すると実行できます (例: /write-tests) 。または @ を入力して選択し、コンテキストとして追加できます。Agent はスキルファイルを読み取り、その指示に従います。
ルールではなくスキルを使うべきなのはどんなときですか？
| ルール | スキル | |
|---|---|---|
| Purpose | 短いコーディングガイドラインや制約 | 複数ステップのワークフローや手順 |
| Length | 数行〜数百行程度 | 多くの場合より長く、詳細なステップごとの手順を含む |
| How applied | すべての会話 (または条件に一致する会話) でコンテキストとして含まれる | /skill-name または @skill-name で必要に応じて呼び出す |
| Example | 「新規ファイルはすべて TypeScript を使う」 | 「ステージングにデプロイ: テスト実行、ビルド、デプロイ、検証」 |
短い指示で十分な場合はルールを使います。Agent が従うための、詳細で繰り返し使えるプロセスが必要な場合はスキルを使います。
ルールをスキルに変換するには？
- チャットで
/create-skillと入力し、Agent にルールを新しいスキルに変換するよう依頼します (例: 「@my-ruleをスキルに変換して」) - 生成されたスキルファイルを確認します
- 元のルールファイルが不要であれば削除します
コマンドをスキルに移行するにはどうすればよいですか？
Agent chat で /migrate-to-skills と入力します。この組み込みスキル (Cherri Code 2.4 以降で利用可能) は、移行可能なルールとコマンドを特定し、自動的にスキルへ変換します。
変換されるもの:
- 動的ルール:
alwaysApply: false(または未定義) で、globsパターンがないルール。 - スラッシュコマンド: ユーザーレベルとワークスペースレベルの両方のコマンド。明示的に呼び出す動作はそのまま維持されます。
alwaysApply: true または特定の globs パターンを持つルールは、スキルの動作とは異なる明示的なトリガー条件があるため、移行されません。ユーザールールも、ファイルシステムに保存されていないため、移行されません。