AI Agent Skills 2026.06.02

2026 Agent Skills 完全ガイド： SKILL.md から Cursor 再利用ワークフローへ（クラウド Mac）

JEX
JEXCLOUD エンジニアリングチーム
· 2026年6月2日 · 約 14 分で読了

コーディング Agent はリポジトリ編集、スクリプト実行、PR 作成までこなします。デプロイ・テスト・監査の長文 Prompt を毎セッション貼ると、コンテキストが繰り返し指示で埋まり、スレッド間で引き継げません。Agent Skills（agentskills.io オープン標準）は「X のやり方」をバージョン管理可能な SKILL.md モジュールとしてパッケージ化し、Cursor・Claude Code・Gemini CLI などが必要時に読み込みます。

本稿は開発者と Mac パワーユーザー向けです。① 都度 Prompt と Rule の課題、② Skill vs Rule vs MCP 比較表と三層の段階的ロード、③ SKILL.md テンプレートと六段階チェックリスト、④ クラウド Mac で Cursor Agent + Skill を 7×24 運用する理由を解説します。Hermes の「Skill Documents」（メモリ）については Hermes 永続メモリ・レンタルガイドを参照してください。Agent Skills とは別概念です。

01 Cursor Agent Skills が解決すること：繰り返し Prompt からプレイブックへ

Cursor ドキュメントによると、Skill はポータブルで Git 管理可能な能力パック（スクリプト・テンプレート・参照）です。Agent が関連と判断したとき、または /skill-name で呼び出します。Anthropic が 2025 年末に形式を OSS 化し、仕様は agentskills/agentskills にあります。

  • 繰り返しワークフロー：「lint → test → commit → gh pr create」を毎チャットで説明し直す必要があります。
  • Rule は常時オン：スタイルや「コメント禁止」は .cursor/rules に置くべきですが、200 行のデプロイ手順を Rule に入れると無関係タスクでも Token を消費します。
  • チーム再利用なし：Skill はリポジトリで PR レビュー可能。口頭 SOP にはなりません。
  • MCP ではない：MCP は外部 API を接続します。Skill は既存ツールをどの順序で使うかを指示します。

Rule は常時のオンボーディング文書。Skill はタスク一致時に開くランブックです。

02 Agent Skill と Cursor Rule：意思決定マトリクス

Rule vs Skill vs MCP（2026 実践）
観点 Rule Skill MCP
ロードタイミング glob 一致中は常時 Agent 関連性または /name サーバー接続後
典型内容 スタイル、禁止、ブランド 多段階 SOP 外部ツール API
コンテキストコスト 固定オーバーヘッド 段階的で省 Token ツール出力次第
配置 .cursor/rules/ .cursor/skills/ または .agents/skills/ MCP 設定
向く用途 「var を使わない」 「staging デプロイ全チェック」 「Jira / 内部 API 照会」

Cursor 2.4+ には /migrate-to-skills があり、一部 dynamic rules とレガシー slash command を Skill へ移行できます。ハード Rule は 10 本未満に抑え、手順は Skill へ移してください。

03 SKILL.md の書き方：構成、YAML、段階的ロード

各 Skill は最低 SKILL.md（YAML frontmatter + Markdown）を含むフォルダです。任意：scripts/、references/、assets/。一般的なパス：

  • Cursor プロジェクト：.cursor/skills/your-skill/SKILL.md
  • クロスツール：.agents/skills/your-skill/SKILL.md
  • ユーザーグローバル：~/.cursor/skills/ または ~/.agents/skills/

オープン仕様の段階的開示：① 起動時は全 Skill の name + description（各 ~100 tokens）、② 一致時に SKILL.md 全文（~5000 tokens 未満推奨）、③ 実行中に references/ や scripts/——スクリプト出力はチャットへ、ソースは必ずしも全文ロードしません。

.cursor/skills/deploy-staging/SKILL.md 
---
name: deploy-staging
description: >-
  Use when the user deploys to staging or says "pre-prod release".
  Keywords: deploy, staging, pre-prod.
paths:
  - "apps/web/**"
---

# Deploy to staging

## Steps
1. Run `scripts/validate.py`
2. Run `scripts/deploy.sh staging`
3. curl health URL; stop if not 200

description はルーティングキーであり要約ではありません。 いつ発火するか、ユーザーが何と言うかを書きます。name はフォルダ名と一致、小文字・数字・ハイフンのみ、最大 64 文字です。

04 最初の Cursor Agent Skill を作る六段階

  1. 単一ジョブを選ぶ：例「PR 作成」「セキュリティ監査」——「コード+デプロイ+ブログ」を一 Skill にしない。
  2. チャットで下書き：/create-skill でトリガーと手順を説明します。
  3. レイアウトをコミット：.cursor/skills/pr-release/ を作り name: pr-release をフォルダ名と一致させます。
  4. 検証可能な手順：Gather → Act → Verify：git status を読み、gh pr create、gh pr view で確認。失敗時（gh auth login など）も記載します。
  5. （任意）scripts：繰り返し bash は scripts/ へ。本文は「なぜ実行するか」を prose で書きます。
  6. トリガーをテスト：実際のユーザー文言で試し、Cursor Settings → Rules で発見を確認。/migrate-to-skills で旧 Rule を移行し重複を削除します。

用語統一、パスはスラッシュ、コア SKILL.md は ~500 行以内。詳細は references/ へ。

05 引用可能な仕様と 2026 エコシステム

  • 必須 frontmatter：name（≤64 文字）、description（≤1024 文字、非空）——Agent Skills Specification。
  • 段階的ロード：メタデータ ~100 tokens、全文 <5000 tokens、リソースはオンデマンド——同上仕様。
  • Cursor 拡張：paths glob、手動のみ disable-model-invocation: true——Cursor Skills ドキュメント。
  • クロスプラットフォーム：Claude Code ~/.claude/skills、Codex ~/.codex/skills、Cursor .cursor/skills。一リポジトリで複数ツール共有可能です。
  • 2026 テーマ：PR 自動化、TDD ループ、React/Next 監査 Skill——Marketplace 署名ソースを優先し、未監査スクリプトを安易に実行しないでください。

FAQ：Skill はモデルの自律性を奪いません。グローバルは ~/.cursor/skills/、プロジェクトはリポジトリ内。Cursor 2.4+ で安定しています。

06 クラウド Mac 上の Cursor Agent + Skills：JEXCLOUD まとめ

Skill には常時オンラインの macOS ホストが必要です。ノート PC はスリープします。個人 Mac では Telegram/OpenClaw ゲートウェイが落ちます。CI と Cursor を同一 Apple ID で混在すると証明書問題が起きます。

Agent + Skills の三つのホスト
ホスト 利点 リスク
MacBook 最低の IDE レイテンシ 7×24 不可、高い CAPEX
過剰販売 VPS / 非公式 macOS 安く見える 本物 macOS/Xcode/Metal なし、長時間リンク不安定
JEXCLOUD ベアメタル Mac 本物 macOS、Git 内 Skill、SSH Agent 鍵とリース計画（ヘルプ）

推奨トポロジ：ノート PC で日常編集と /create-skill；レンタル Mac で同一リポを clone し launchd でゲートウェイ常駐（OpenClaw launchd ガイド）；PR Skill はサーバーで gh pr create を実行しスリープによる途中失敗を防ぎます。CI 分離は ハイブリッド CI ガイドを参照してください。

過剰販売ホストの弱点：① IO 競合で Skill 検証スクリプトがタイムアウト、② SSH 切断で長時間 Agent ループが中断、③ 非ベアメタルでは xcodebuild が再現不能。

本番 Agent 自動化には、月次リースの JEXCLOUD 多リージョン ベアメタル Mac とリポジトリ内 .cursor/skills が適しています。Dedicated Apple Silicon、7×24、弾性リース。料金と 注文をご覧ください。

ブログ一覧へ戻る
タグ： Agent Skills Cursor SKILL.md agentskills.io クラウド Mac