🧩 Claude Code Skills 完全ガイド 2026

🧩 Section 1: Skillsの仕組み — SKILL.md と progressive disclosure

Skills とは、SKILL.md という1枚のMarkdownファイルで定義する拡張手順書です。/skill-name で手動呼び出しするか、description に書いた条件を Claude が判断して自動発動します。

ディレクトリ階層と優先度

frontmatter 主要フィールド

動的注入と旧 slash command との関係

SKILL.md 本体内では !`git diff HEAD` のような構文で、LLMではなく前処理としてシェルコマンドを実行し、出力をインライン展開できます。

旧来の .claude/commands/*.md（slash command）は Skills に統合済みです。.claude/skills/<name>/SKILL.md と等価で、後者が優先されます。

→ 次の Section 2 では CLAUDE.md / hooks / subagents / MCP との使い分けを見ます。

🔀 Section 2: 他機能との使い分け（CLAUDE.md / hooks / subagents / MCP）

使い分け指針

→ 次の Section 3 ではコミュニティで人気のスキルランキングを見ます。

🏆 Section 3: みんなの使い方 — 人気スキルランキング2026

出典: Agensi — Best Claude Code Skills 2026 (2026-03時点)

人気スキルランキング TOP7

公式同梱（bundled）スキル

Claude Code にはじめから入っているスキル: /code-review / /debug / /batch / /loop / /run / /verify / /claude-api / /run-skill-generator

Anthropic 公式配布（anthropics/skills — 17スキル）

インストール例:

/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills

代表的キュレーション

awesome-claude-skills には test-driven-development / systematic-debugging / using-git-worktrees / mcp-builder 等が収録されています。

→ 次の Section 4 では「アップデートで無駄になる」という読者の核心懸念に答えます。

🔄 Section 4: 「アップデートで無駄になる」問題への答え

この懸念は理解できますが、4つの根拠から「誤解に近い」と言えます。

1. 1

   モデル非依存

   Skills はプレーンMarkdownの宣言

   SKILL.md はモデル固有のAPIやバイナリに依存しない純粋なテキストです。Claude 4.6→5→6 とモデルが変わっても、SKILL.md の中身（禁止リスト・手順・コード例）は一切書き直す必要がありません。「モデルが更新されたらスキルが壊れる」という事態は構造上起きません。

2. 2

   ツール移行コスト低

   Agent Skills オープン標準準拠

   agentskills.io のオープン標準に準拠しており、Claude Code / Cursor / Codex CLI / Gemini CLI / Aider 等で同じスキルフォルダが動きます。Claude Code を乗り換えても資産が引き継げます。

3. 3

   model省略で継承

   model: 省略時はセッションのモデルを自動継承

   frontmatter の model: フィールドを省略すると、スキルはセッションで使われているモデルをそのまま継承します。特定モデルに固定したい時だけ明示すれば良く、「モデル名を埋め込んだスキルが古くなる」問題を避けられます。

4. 4

   git管理で更新追跡

   .claude/skills/ をコミットできる

   Project スコープのスキルはリポジトリの .claude/skills/ に置いてコミットできます。変更履歴を git で追えるので「どのバージョンで何を変えたか」が明確になります。

出典: code.claude.com/docs/en/skills / agentskills.io

→ 次の Section 5 ではあなたのスタック（Electron / Turso / SvelteKit）別のおすすめスキルを見ます。

🛠️ Section 5: あなたのスタック別おすすめスキル（Electron / Turso / SvelteKit）

⚡ SvelteKit + Svelte 5 (runes)

AI がよく間違える点

description 例

禁止リスト（SKILL.md body 抜粋）

NEVER use: export let, $:, createEventDispatcher, on:event, <slot>, writable() for local state
ALWAYS use: $state(), $derived(), $effect(), $props(), onclick={}, {@render}, callback props
$effect is for SIDE EFFECTS only — use $derived for computed values
Destructured $state loses reactivity: const { x } = $state(obj) — NEVER do this
$bindable() required for bind: on child props
load type: PageLoad vs PageServerLoad — never mix
fail() and redirect() import from '@sveltejs/kit'

🖥️ Electron

AI がよく間違える点

description 例

禁止リスト

NEVER nodeIntegration: true
NEVER contextIsolation: false
NEVER sandbox: false
NEVER expose ipcRenderer directly via contextBridge
NEVER ipcRenderer.send + ipcMain.on for request/response — use invoke + handle
ALWAYS one function per IPC channel
ALWAYS validate event.senderFrame.url in ipcMain.handle
CSP via session.defaultSession or <meta>

🗄️ Turso (libSQL)

AI がよく間違える点

description 例

禁止リスト

NEVER client.execute("BEGIN") / client.execute("COMMIT") — use client.batch([...],"write")
interactive txn locks DB, 5s timeout — prefer batch for high-latency scenarios
Edge runtime: import from '@libsql/client/http' (NOT default @libsql/client)
Embedded replica: local=file:./path, syncUrl=libsql:// or https:// (NEVER file://)
drizzle-kit push fails on table recreation — use migrate
Packages: @libsql/client (ORM), @tursodatabase/sync (push/pull), @tursodatabase/serverless (edge)

出典: Svelte5 移行ガイド / Electron セキュリティ / Turso TS SDK / Drizzle × Turso

→ 次の Section 6 ではスタック非依存・普遍的にエラーを減らすスキルを見ます。

🛡️ Section 6: 普遍的にエラーを減らすスキル（言語・FW非依存）

→ 次の Section 7 では生産性がどれだけ変わるかを数値で見ます。

📊 Section 7: 生産性はどれだけ変わるか（数値）

→ 次の Section 8 では入れるべき/避けるべきの判断基準と、まず3つ作るロードマップを見ます。

✅ Section 8: 入れるべき / 避けるべき 判断ガイド

214スキル監査の衝撃データ

出典: dev.to — I Audited 214 Claude Code Skills

入れるべき / 避けるべき

まず3つだけ作れ（スキル0個からのロードマップ）

1. 1

   最優先

   code-review 系

   公式同梱の /code-review をそのまま使うか、上述の code-reviewer スキルをインストール。毎回レビュー観点を書く手間がなくなる。

2. 2

   即効性が高い

   スタック別禁止リストスキル（Svelte5 / Electron / Turso）

   Section 5 の禁止リストを .claude/skills/svelte5/SKILL.md 等にコピペするだけで完成。CLAUDE.md の該当節を切り出せばOK。

3. 3

   品質ゲート

   commit 前チェックの手順スキル

   「コミット前に確認するチェックリスト」をスキルにする。hooks（決定的検証）と組み合わせると feature ブランチ強制・.env 混入防止の知識が常に発動する。

description は「いつ使うか」のトリガーを20語以上で具体的に書くこと。

良い SKILL.md の最小テンプレ

---
name: svelte5-runes
description: >
  Svelte 5(runes)と SvelteKit 2 を最新の正しい書き方で書く。
  Svelte 4 の古い書き方(export let / $: / createEventDispatcher / slot /
  writable store でのローカル状態)を出さない。
  .svelte / .svelte.js / .svelte.ts / +page / +layout / +server ファイルを
  編集・作成する場合に必ず使用する。バージョン: Svelte 5.x / SvelteKit 2.x
allowed-tools:
  - Read
  - Edit
  - Write
  - Bash
---

## When to use
.svelte, .svelte.ts, +page.svelte, +layout.svelte, +page.server.ts 等を
編集・作成する際に自動発動する。

## NEVER use (Svelte 4 patterns)
- export let (use $props())
- $: reactive statements (use $derived / $effect)
- createEventDispatcher (use callback props)
- on:click / on:input (use onclick / oninput)
- <slot> (use {#snippet} + {@render})
- writable() for local state (use $state())

## ALWAYS use (Svelte 5 runes)
- $state() for reactive variables
- $derived() for computed values (NOT $effect)
- $effect() for side effects only
- $props() for all props
- $bindable() for two-way bind props