← AI開発 資料アーカイブ
スキル作成

スキル完全マニュアル v1:AIエージェント時代のスキルとは何か

元ファイル: てるさんパート/スキルマニュアル v1.md

要約

技術レベル不問でスキルの全体像を3軸で整理する完全マニュアル(2026-04-15)。スキルの本質を「人間がやっている仕事の一部をAIに移管したもの」と定義し、技術的にはSKILL.md+scripts/references/assetsのフォルダ構成だと説明。Agent Skillsがオープンスタンダードとして30以上のツールに対応し、1つのSKILL.mdを使い回せる時代であることを示し、スキルの種類を整理する。

要点

スキルマニュアルSKILL.mdAgentSkillsClaudeCodeCodexCursor非技術者向け

スキルとは何か — AIエージェント時代のスキル完全マニュアル

作成日: 2026-04-15
対象: AIを活用したい全ての人(技術レベル不問)


はじめに — なぜこのマニュアルが必要か

「スキル」と言われても、幅が広すぎて何のことかわからない。

定期実行するやつ?専門的な仕事をするやつ?勝手に動くやつ?手動で呼ぶやつ?全部「スキル」と呼ばれている。

このマニュアルは、スキルの全体像を3つの軸で整理し、「自分に何が必要か」が見えるようにするためのもの。


第1章: スキルの本質

スキルとは何か

人間がやっている仕事の一部を、AIでもできるように移管したもの。

これだけ。

スキルは「AIにできることを増やす」のではなく、**「あなたがやっている仕事をAIに渡す」**行為。だからスキルの中身は、あなたの仕事そのもの。

技術的には何か

SKILL.mdというファイルに「この仕事はこうやる」と書いたもの。

my-skill/

├── SKILL.md ← メインの指示書(必須)

├── scripts/ ← 実行スクリプト(任意)

├── references/ ← 参考ドキュメント(任意)

└── assets/ ← テンプレート等(任意)

AIがこのファイルを読むと、その仕事ができるようになる。

どのツールで使えるか

2026年4月現在、Agent Skills というオープンスタンダードに30以上のツールが対応:

ツール スキルの仕組み 備考
Claude Code ~/.claude/skills/ or .claude/skills/ SKILL.md + フロントマター。最も高機能
Codex (OpenAI) .agents/skills/ SKILL.md対応。Progressive Disclosure(必要時のみ全文読込)
Cursor .cursor/rules/ .mdcファイル。4つの適用モード
Gemini CLI Agent Skills対応 SKILL.md互換
GitHub Copilot VS Code 1.108〜 SKILL.md実験的対応
Windsurf .windsurf/rules/ 4つのアクティベーションモード
Cline .clinerules/ .md/.txtファイル。トグルON/OFF可能

重要: 一つのSKILL.mdを書けば、複数のツールで使い回せる時代に入っている。


第2章: スキルの種類 — 3つの軸で理解する

「スキルって何の種類があるの?」と聞かれたら、3つの軸で説明できる。

軸1: 何をするか(ドメイン)

ドメイン 何をするスキルか
開発 コードを書く、レビューする、テストする、デプロイする コードレビュー、自動テスト、デプロイ
コンテンツ制作 文章・画像・動画・スライドを作る YouTube台本、インフォグラフィック、4コマ漫画
リサーチ 調べる、分析する、レポートにまとめる Web検索、SNS分析、競合調査
ビジネス業務 請求書、経費精算、日程調整、CRM管理 請求書自動作成、営業パイプライン
SNS/マーケ 投稿する、分析する、ブーストする X自動投稿、ブックマーク整理
ドキュメント PDF/Excel/PPTXを作る、変換する、読み取る PDF変換、スプレッドシート操作
Google連携 Gmail/Calendar/Drive/Sheets等を操作する メール送信、予定登録、ファイルアップロード
知識管理 知識を蓄積する、構造化する、検索する 日記、概念抽出、講座取り込み
メタ/統治 スキル自体を作る、品質を管理する、AIを管理する スキル作成、レビュー、コスト最適化

軸2: いつ動くか(トリガー)

トリガー いつ動くか
手動 自分で「やって」と言った時 /invoice(請求書作って)
キーワード 会話の中で特定の言葉が出た時に自動発動 「日程調整して」→ schedule-managerが起動
定時 毎日○時、毎週○曜に自動実行 毎日22時にジャーナル記録、毎朝9時にニュース収集
イベント 外部から通知が来た時(Discord mention等) ブックマーク追加 → 自動トリアージ
連鎖 別のスキルが終わった後に自動で次が起動 レビュー → テスト → ドキュメント(3段連鎖)

軸3: どれだけ任せるか(自律度)

レベル どこまでやるか あなたの役割
L1 道具 1つの操作を実行するだけ 全部指示する PDFを開く、メールを送る
L2 助手 指示を解釈して複数ステップを実行 結果を確認する リサーチして要約する、請求書を作って送る
L3 代理人 ゴールだけ渡すと自律的に計画・実行 最終結果を見るだけ 「品質改善して」→ レビュー→テスト→ドキュメント
L4 指揮者 他のAIエージェントを生成して束ねる 何もしない Agent Teamsで5体のAIを並列起動
L5 自己進化 スキル自体を生み出す・改善する 承認するだけ スキルが足りない → 自動生成

3軸の組み合わせで全てのスキルが説明できる

例:

スキル ドメイン トリガー 自律度
請求書自動作成 ビジネス業務 手動 L2 助手
毎朝ニュース収集 リサーチ 定時 L3 代理人
コードレビュー→テスト→ドキュメント 開発 手動 L3 代理人(連鎖)
Agent Teamsで並列開発 メタ 手動 L4 指揮者
スキルを自動生成 メタ イベント L5 自己進化

第3章: スキルとゴールの関係

ゴールが決まれば、スキルが決まる

夢・目標(ゴール)

↓ ゴールが確定する

プロセス

↓ プロセスが確定する

タスク

↓ タスクが確定する

エージェント(担当者)

↓ エージェントが確定する

スキル(そのエージェントが持つ能力)

例: 「年商1億をデジタルコンテンツで達成したい」

ゴール: 年商1億

プロセス: SNS集客 → 教育 → 販売 → サポート

タスク: X投稿 / YouTube台本 / LP制作 / 決済 / 請求書 / ...

エージェント: マーケター / コンテンツ制作者 / 事務

スキル: x-auto-poster / youtube-booster / copy-lp / invoice / ...

ゴールが変われば、必要なスキルも変わる。
5億なら5億のスキルセット。100億なら100億のスキルセット。

スキルは何に依存するか

スキルは3つに依存している:

  1. 人に依存する — その人の専門領域・得意分野がスキルの中身になる

  2. プロジェクトに依存する — プロジェクトごとに必要なスキルが変わる

  3. タスクに依存する — タスクの粒度でスキルの範囲が変わる

1つのエージェントに何個のスキルを入れていいか

たくさん入れていい。

年商5億円クラスのデジタルビジネスなら、おそらくエージェントは3〜4体で足りる。1体あたり100個のスキルを持っていても、AIは集中力を切らさずに仕事を捌ける。

人間の場合、100個のスキルを使いこなすのは無理。でもAIは全てのスキルの手順を正確に記憶し、必要な時に必要なスキルだけ呼び出せる。


第4章: スキルの2つのフェーズ

フェーズ1: スキルは「作るもの」

最初の段階。自分が繰り返しやっている作業を:

  1. 洗い出す

  2. 手順をSKILL.mdに書く

  3. AIに読み込ませて動かす

  4. 修正を繰り返す

ここでやるべき3ステップ:

Step 0: 業務の全体像を把握する

Step 1: 業務を分解する(部署ごと、専門ごと)

Step 2: 各業務の「売上貢献度」と「うざさ(繰り返し度)」を評価する

「3回同じことを思ったら」スキル化の候補。

フェーズ2: スキルは「勝手に作られるもの」

上級の段階。プロジェクトが発足した時に:

例: 新しくFacebook広告を回すプロジェクトが立ち上がった
→ Facebook広告スキルが存在しない
→ システムが自動でスキルを生成する

ここに見えない壁がある。 フェーズ1からフェーズ2への移行は、抽象レベルが高いスキル設計力が必要。


第5章: スキル作成の実践ガイド

SKILL.mdの基本構造

---

name: my-skill

description: |

このスキルの説明。AIが自動判断に使うので具体的に書く。

「請求書作って」「インボイス作成」で発火する。

user-invocable: true

---

# スキル名

## やること

1. ステップ1

2. ステップ2

3. ステップ3

## ルール

- こういう場合はこうする

- こういう場合はやらない

## 出力形式

- ファイル名: xxx

- 保存先: xxx

配置場所

使い方 配置先
自分だけが使う ~/.claude/skills/my-skill/SKILL.md
プロジェクトで共有する .claude/skills/my-skill/SKILL.md
チーム全体で使う Enterprise管理設定

良いスキルの条件

  1. 500行以内 — 長すぎるとAIが読み切れない。詳細は別ファイルに分離

  2. descriptionが具体的 — AIが「いつ使うか」を判断する唯一の情報源

  3. トリガーワードを明記 — 「請求書作って」「インボイス」「invoice」で発火、と書く

  4. やらないことも書く — 「NOT for: 新規ドキュメント作成(→ 別のスキル)」

  5. 出力形式が明確 — 何をどこに保存するか

注意: パッシブ vs オンデマンド

Vercelの評価で重要な知見が出ている:

常にロードされているルール(CLAUDE.md等)が100%の精度を達成。オンデマンドスキルは最大53%にとどまった。

つまり、本当にクリティカルなルールはCLAUDE.mdに書く。スキルは「あると便利」レベルのもの。

AIは「いつスキルを呼び出すか」の判断がまだ苦手。だから:


第6章: ツール別の違い

特徴 Claude Code Codex Cursor Cline
スキルファイル SKILL.md SKILL.md .mdc/.md .md/.txt
設定ファイル CLAUDE.md AGENTS.md .cursor/rules/ .clinerules/
自動発動 description判定 description判定 4モード 条件付きルール
サブエージェント context: fork Subagents
動的コンテキスト !`command`
手動呼び出し /skill-name /skills @rule-name
ツール権限制御 allowed-tools

Claude Codeが最も高機能。 ただし他ツールでも基本的なSKILL.md形式は共通。


第7章: スキル化チェックリスト

自分の業務をスキル化する時のチェックリスト:

Step 0: 全体像の把握

Step 1: 優先順位づけ

Step 2: スキル設計

Step 3: 実装と改善


付録A: 業界のスキル分類フレームワーク

フレームワーク 提唱者 分類軸
AI Agent Capabilities Periodic Table Digital Twin Consortium 知覚/認知/学習/行動/対話/統治の6領域×45能力
3段階アーキテクチャ分類 Lenny Rachitsky 決定的自動化 / 推論行動エージェント / マルチエージェント
スキル獲得3モダリティ 学術論文 (arxiv) 人間作成 / 機械生成 / モデルファインチューニング
awesome-agent-skills VoltAgent (GitHub) 1,184+スキルをカテゴリ分類。Marketing/Dev/Context等
OpenClawレジストリ Linux Foundation管理 13,700+スキル登録。事実上の標準カタログ

付録B: 参考リンク

↑ トップへ戻る