Claude Code の Skills 機能を使いこなす — カスタムコマンドで開発を効率化

はじめに

Claude Code には Skills という機能があり、よく使う操作をカスタムコマンドとして定義・再利用できます。たとえば「コードレビュー」「テスト生成」「コミットメッセージ作成」など、繰り返し行う作業をスキルとして定義しておけば、/skill-name と入力するだけで実行できます。

さらに、Anthropic が配布している example-skills プラグインには Skill Creator（対話形式でスキルを生成してくれるスキル）が含まれており、これを使えば SKILL.md を手で書かなくてもスキルを作成できます。

この記事では、Skills の基本から Skill Creator の導入手順、実際にスキルを作成する流れまでを紹介します。VS Code 拡張版の Claude Code で動作確認し、UI 操作でハマりやすい点もあわせてまとめました。

Skills とは

Skills は、Claude Code に独自のコマンドや再利用可能なワークフローを追加する仕組みです。

• SKILL.md ファイルを配置するだけで認識される
• 関連する場面で Claude が自動で利用することもあり、/skill-name で直接呼び出すこともできる
• プロジェクト単位・マシン全体の両方で管理可能

以前使われていた .claude/commands/ のカスタムコマンドも動作しますが、現在はスキルにマージされた扱いです。新規で作る場合は Skills を使うのが推奨されます。

配置場所

SKILL.md の書き方

スキルは SKILL.md ファイルで定義します。YAML フロントマターでメタ情報を記述し、本文にスキルの指示を書きます。

---
name: my-skill
description: スキルの説明（いつ・どんな場面で使うか）
---

ここにスキルが実行する指示を書く。
例: 選択されたコードのテストを生成する、など。

フロントマターの主なオプション

フロントマターの各項目は必須ではありませんが、書いておくと動作が安定します。

Skill Creator とは

Anthropic が配布している example-skills プラグインに含まれるスキルで、対話形式でスキルを生成できます。手動で SKILL.md を書く代わりに、Skill Creator と対話しながら YAML フロントマターや本文を組み立ててくれます。

具体的な導入手順とスキル作成の流れは、後述の「実践：VS Code 拡張に Skill Creator を導入する」セクションで実体験ベースに紹介します。

組み込みスキル

Claude Code にはデフォルトで使えるスキル（bundled skills）がいくつか用意されています。

類似の機能として /schedule（リモートエージェントを cron 実行）などの組み込みコマンドもありますが、こちらはスキルではなく別の仕組みです。

便利な設定：確認プロンプトのスキップ

Skills を快適に使ううえで、権限モードの理解も重要です。Claude Code はファイル編集やコマンド実行のたびに確認を求めますが、これをスキップする方法があります。

Bypass permissions モード（CLI版のみ）

claude --dangerously-skip-permissions

内部的には bypassPermissions モードで、保護パスを除いてほぼ全ての確認プロンプトを自動承認します。危険な操作（ファイル削除、git push 等）も無確認で実行されるため、隔離されたコンテナや VM 内でのみ使用してください。

注意： これは CLI 版（npm install -g @anthropic-ai/claude-code）のコマンドです。VS Code 拡張のみを使っている場合は利用できません。

モード切替（VS Code 拡張）

Claude Code パネル下部のモード表示をクリックすると、以下のモードから選択できます。

普段の開発では Edit automatically（内部的には acceptEdits モード）にしておくと、ファイル操作のたびに確認で中断されにくくなります。

Effort（思考の深さ）

同じくパネル下部から設定できる Effort は、Claude の推論の深さを制御します。

簡単な質問やファイル操作には Low、アーキテクチャ設計やバグ調査には High、という使い分けがおすすめです。

Auto Mode（Claude が判断）

Auto Mode は、操作のたびに分類モデルがリスク評価を行い、安全と判断された操作だけを自動承認するモードです。ローカルファイルの読み書きや読み取り専用の HTTP リクエストは自動承認され、外部コードの取得・実行（curl | bash）、本番デプロイ、main への force push、IAM 権限変更などは確認を求められます。

注意： 公式発表によると、Auto Mode は Team 向けに research preview として先行提供され、Enterprise / API プランへ順次展開されています（2026年3月24日時点）。利用可否は最新のドキュメントを確認してください。

設定ファイルで細かく制御

.claude/settings.json（プロジェクト単位）または ~/.claude/settings.json（全体）に許可ルールを記述することで、ツールごとに自動承認を設定できます。

{
  "permissions": {
    "allow": [
      "Read",
      "Edit(/src/**)",
      "Bash(npm run *)"
    ]
  }
}

この例では「ファイル読み取り」「/src/ 以下の編集」「npm run 系コマンド」が自動承認されます。それ以外は確認プロンプトが出ます。

実践：VS Code 拡張に Skill Creator を導入する

実際に VS Code 拡張で Skill Creator を導入した手順を紹介します。UI の挙動に少し癖があったので、同じ場面でハマらないよう参考にしてください。

1. /plugin で Manage Plugins を開く

チャット欄に /plugin と入力すると Manage Plugins ダイアログが開きます。タブは Plugins と Marketplaces の2つです。

私の VS Code 拡張環境では、初期状態で No marketplaces configured. と表示され、何もインストールできませんでした。環境によっては最初から公式マーケットプレイスが使える場合もあるため、まずは Plugins タブの表示を確認してください。利用可能なプラグインがすでに並んでいるなら手順2はスキップできます。

2. マーケットプレイスを追加する（必要な場合）

Marketplaces タブの入力欄には、プラグイン名ではなく マーケットプレイスのリポジトリを入れます。

• 悪い例: Skill Creator → Invalid marketplace source format. Try: owner/repo, https://..., or ./path というエラーになる
• 良い例: anthropics/skills（owner/repo 形式）

anthropics/skills を入力して Add をクリックすると、公式マーケットプレイスが追加されます。

3. Plugins タブでプラグインを選ぶ

Plugins タブに切り替えると、以下の3つが表示されます（2026年4月時点）。

Skill Creator 単体のプラグインはありません。 Skill Creator は example-skills に含まれているので、これを Install します。

4. 反映する

公式には /reload-plugins で反映できるとされています。ただし、私の VS Code 拡張環境では候補に出ませんでした。その場合は以下のいずれかで反映できます。

• Ctrl + Shift + P（コマンドパレット）→ Developer: Reload Window
• Claude Code パネルを閉じて開き直す
• VS Code を再起動

5. Skill Creator を起動する

反映後は / を入力して候補を確認します。プラグイン由来のスキルは名前空間付きで表示されることがあり、環境によっては example-skills:skill-creator のように見えます。私の環境では /skill-creator という短い形で表示されました。

選択して実行すると、対話形式でスキル作成が始まります。

6. 実際にスキルを作ってみる

試しに、learning-log プロジェクトで毎日作成する日報ファイル（daily/YYYY-MM-DD.md）を自動生成するスキル new-daily を作ってみました。

Skill Creator との対話内容：

• スキルの目的：今日の日報を templates/daily-template.md をベースに作成する
• 置き場所：プロジェクト限定（.claude/skills/new-daily/）
• 追加機能：昨日の日報の「明日やること」を今日の「今日やること」に引き継ぐ
• 既存ファイルの扱い：上書き

対話でこれらを伝えると、Skill Creator が次のような SKILL.md を生成してくれました（抜粋）。

---
name: new-daily
description: learning-log プロジェクトで今日の daily ファイル
  （daily/YYYY-MM-DD.md）を作成するスキル。
  templates/daily-template.md をベースに、昨日の daily から
  「明日やること」を今日の「今日やること」へ引き継ぐ。
---

# new-daily

## 実行手順

### 1. 今日の日付を取得
...
### 2. テンプレートの読み込み
...
### 3. 昨日の daily から「明日やること」を取得
...
### 4. ファイル作成
...

ファイルは .claude/skills/new-daily/SKILL.md に保存されました。これで「今日の daily を作って」と話しかけるだけで、テンプレートから日報が作成されるようになりました。

導入でハマりやすい点まとめ

• Marketplaces タブにプラグイン名を入れるとエラー。owner/repo 形式（anthropics/skills）で入れる
• Skill Creator 単体のプラグインはない。example-skills に含まれている
• /reload-plugins が使えない環境では VS Code のリロードで代用できる
• プラグインスキルは名前空間付きで表示されることがある（/ で候補確認が確実）

まとめ

• Claude Code の Skills は SKILL.md を配置するだけで使えるカスタムコマンド機能
• example-skills プラグイン内の Skill Creator を使えば対話形式で簡単にスキルを作れる
• VS Code 拡張ではマーケットプレイスを anthropics/skills（owner/repo 形式）で追加する必要がある点に注意
• 繰り返し行う作業をスキル化することで、開発の効率が上がる
• 個人用・プロジェクト用で使い分けられるので、チーム開発にも活用できる

参考リンク

• スキルで Claude を拡張する（公式ドキュメント 日本語）
• プラグインのインストールと発見
• 権限モードの選択
• 権限の設定
• Auto mode for Claude Code（公式ブログ）