MyVault

Claude Code Skills

Properties1
tagsclaude-code, skills, knowledge, customization

6 min read

Claude Code Skills

Claude Code に特定領域の知識・手順を与える仕組み。SKILL.md ファイルで定義し、スラッシュコマンドとして呼び出すと AI のコンテキストに注入される。

概念

  • Skills = AI への「知識パッケージ」
  • 呼び出し時に SKILL.md の内容がシステムプロンプトに追加される
  • Claude Code カスタムコマンド と組み合わせて使うのが典型パターン

ファイル構成

.claude/
  skills/
    my-skill/
      SKILL.md           → スキルの本体（手順・知識）
      references/        → 補足資料（コード例・仕様書など）
        example.md
        api-spec.md

SKILL.md の書き方

# スキル名
 
## 概要
このスキルは〜に使います。
 
## 手順
1. まず〜を確認する
2. 次に〜を実行する
 
## 注意事項
- 〜はしてはいけない

references フォルダの活用

references/ に詳細なコード例・仕様書を置き、SKILL.md から参照することで本体を簡潔に保てる。

サブエージェントとの使い分け

SkillsClaude Code サブエージェント
役割知識の提供タスクの委譲・実行
コスト軽量（コンテキスト追加のみ）重い（別インスタンス起動）
向く用途専門領域のコーディング規約・手順並列化・大規模タスク分割

スキル作成フロー（プログラミング不要）

詳細は スキル作成フロー（えがく・つくる・そだてる） を参照。

  1. えがく — Claude Codeを開く前に業務を設計。「誰の何を解決するか」「インプット・処理・アウトプット」を定義
  2. つくる — REQUESTS.md に要件を書き、/skill-creator コマンドで自動生成。最初は30点で当然
  3. そだてる — /simplify で整理、ベストプラクティスで最適化、使いながら育てる

グローバルスキル vs プロジェクトスキル

種類配置場所向く用途
プロジェクトスキル{プロジェクト}/.claude/skills/特定プロジェクト専用（推奨）
グローバルスキル~/.claude/skills/プロジェクトをまたぐ横断業務

ユースケース例

PM・非エンジニア業務（Claude Code 非エンジニア活用 参照）:

  • 昨日の出来事レポート（Slack/Notion/メール統合）
  • プロジェクト進捗・WBS可視化
  • WBSスキル群（wbs-hearing・wbs-generator・wbs-edit）— ヒアリングから生成・運用・本番反映まで全工程カバー。詳細は WBSをAIとともに管理するSkills（すぅ AI駆動PM） を参照
  • リスクチェック（期限超過・依存関係）
  • スライド・業務フロー・要件定義書の自動生成
  • 一括リマインド（期限近いタスクをSlack DMで通知）
  • /daily-schedule — Google Calendar + GitHub Projects を読み込み、15分刻みの工程表を自動生成

エンジニアリング（AI駆動開発10の実践テクニック 参照）:

  • 社内 API の使い方スキル
  • 特定フレームワークのコーディング規約スキル
  • デプロイ手順スキル / コードレビューチェックリストスキル
  • /refactoring-scan — GitHub Actions 上で定期実行し、重複処理・整理すべき箇所をIssue化
  • E2Eテスト作成Tips（test-id付与、PlaywrightMCPでDOM先取得、DnDのmouse操作など）

Skills の管理（Obsidian Bases 活用）

Skills が増えて /skills コマンドで把握しきれなくなった場合、Obsidian Bases と組み合わせて一覧管理できる。

  1. ln -s ~/.claude/skills ~/your-vault-path/skills でシンボリックリンクを作成
  2. Obsidian Skills から Bases 作成を指示すると、Skills ファイルだけを絞り込んだデータベースビューが自動生成される

詳細: Skills が増えすぎて管理に困ったら Obsidian で一覧化しよう

スキルエンジニアリング（PM視点）

すぅ AI駆動PM は PM が極めるべきスキルとして「スキルエンジニアリング」を提唱。AI技術知識より 業務設計力 こそが高品質スキルを生む本質的な能力だとする。

  • PM業務を「ヒト（マネジメント・コミュニケーション）」と「コト（定型作業・ドキュメント）」に分類
  • 「コト」をスキル化して効率化し、空いた時間を「ヒト」に充てることでプロジェクト品質が上がる
  • スキルは自分専用・プロジェクト専用でよい。他者が使えることより 自分の業務が再現できること が先決
  • 公開されているスキル集の多くは「SKILL.md 100行の抽象的なプロンプト集」に過ぎず、実務用高品質スキルとは別物
  • 詳細: スキルエンジニアリング（PM）

Agent Skills との関係

Agent Skills は Claude Code Skills と同じ SKILL.md ベースのアーキテクチャを採用している。Agent Skills はさらに「段階的開示（Progressive Disclosure）」という設計思想を明示し、MCP の上位レイヤーとしての役割を定義した Anthropic の公式コンセプト。

  • スキルの name と description は起動時にメタデータとしてのみ読み込まれ、関連タスク発生時に初めて SKILL.md 本体が読み込まれる（コンテキスト効率化の仕組み）
  • 詳細: Agent Skills

関連

Graph View

バックリンク