Claude Code Skills 実践設計ガイド｜description最適化・命名規則・チーム運用パターンの完全解説

---
name: pdf-tool
description: Helps with documents
---

---
name: pdf-tool
description: Extracts text and tables from PDF files, fills PDF forms, converts PDFs to Markdown,
  and merges multiple PDF files. Use when working with PDF files or when the user mentions
  PDFs, forms, document extraction, PDF conversion, or merging documents.
---

---
name: security-audit
description: Performs a comprehensive security audit of source code, checking for OWASP Top 10
  vulnerabilities, SQL injection, XSS, authentication flaws, and secrets exposure in environment
  files or configuration. Generates a structured report with severity levels and remediation steps.
  Use when the user asks to audit, review security, check vulnerabilities, scan for secrets,
  or before a production release.
argument-hint: "[path] [--strict]"
allowed-tools: Read, Grep, Glob, Bash(git log *), Bash(git diff *)
model: claude-opus-4-6
effort: high
context: fork
agent: Explore
disable-model-invocation: false
user-invocable: true
version: "2.1"
---

## セキュリティ監査の実施

対象パス: $ARGUMENTS（省略時はプロジェクト全体）

### 直近の変更内容
!`git log --oneline -20`

以下の観点で監査を実施し、severity（Critical/High/Medium/Low）付きのレポートを作成してください。

1. OWASP Top 10の脆弱性チェック
2. SQLインジェクション・コマンドインジェクション
3. XSSの可能性（HTMLエスケープ漏れ）
4. 認証・認可の実装ミス
5. 環境変数・設定ファイルでの秘密情報の露出
6. 依存パッケージの既知脆弱性（package.json / requirements.txt を確認）

レポートは `docs/security-audit-YYYYMMDD.md` として保存してください。

~/.claude/skills/              # 個人スキル（全プロジェクト共通）
├── my-style/
│   └── SKILL.md               # 個人のコーディングスタイル適用
├── quick-note/
│   └── SKILL.md               # よく使うメモ・スニペット
└── daily-standup/
    └── SKILL.md               # 毎日のスタンドアップ用

project/.claude/skills/        # プロジェクトスキル（チームで git 管理）
├── review-pr/
│   └── SKILL.md               # チームのPRレビュー基準
├── deploy-staging/
│   └── SKILL.md               # ステージングデプロイ手順
└── onboard-check/
    └── SKILL.md               # 新メンバー向けセットアップ確認

# Claude Code の個人設定は共有しない
.claude/settings.local.json
.claude/MEMORY.md
.claude/memory/

# スキルはチームで共有する（除外しない）
# .claude/skills/ は git add する

---
name: pr-review
description: Reviews a pull request including its diff, description, and existing comments.
  Checks for bugs, security issues, test coverage, and code style consistency.
  Use when asked to review a PR, check a pull request, or review changes before merging.
argument-hint: "[PR番号]（省略時は現在のブランチのPR）"
allowed-tools: Read, Grep, Glob, Bash(gh pr *)
---

## PR情報
- URL / 番号: $ARGUMENTS
- 差分: !`gh pr diff $ARGUMENTS`
- 既存コメント: !`gh pr view $ARGUMENTS --comments`
- 変更ファイル一覧: !`gh pr diff $ARGUMENTS --name-only`

以上の情報をもとにコードレビューを行ってください。

### レビュー観点
1. PRの説明と実際の変更内容が一致しているか
2. バグ・セキュリティ上の問題（SQLインジェクション・XSS等）
3. テストが十分か（新機能・バグ修正にはテストが必須）
4. コードスタイルが既存コードと統一されているか
5. ドキュメント・コメントの更新が必要か

---
name: smart-commit
description: Analyzes the current staged git diff and recent commit history to create a
  contextually appropriate commit message following the project's conventions.
  Runs git commit automatically after confirmation.
  Use when user asks to commit, create a commit message, or stage and commit changes.
allowed-tools: Read, Bash(git *)
---

## 現在のステージング済み変更
!`git diff --staged`

## 最近のコミット履歴（スタイル参考）
!`git log --oneline -10`

## プロジェクトのコミット規約
!`cat .gitmessage 2>/dev/null || echo "（.gitmessageなし）"`

上記の変更内容と既存のコミット履歴のスタイルを参考に、適切なコミットメッセージを作成してください。
Conventional Commits形式（feat/fix/refactor/docs/test/chore）を使い、
件名は50文字以内・日本語で書いてください。

確認後、`git commit -m "メッセージ"` を実行してください。

---
name: analyze-errors
description: Analyzes recent application error logs to identify patterns, frequency, and
  root causes. Checks both application logs and system logs. Groups similar errors and
  prioritizes by frequency and severity. Use when asked to check errors, analyze logs,
  investigate issues, or troubleshoot recent problems.
argument-hint: "[ログファイルパス] [--last-n-lines=500]"
allowed-tools: Read, Grep, Bash(tail *), Bash(grep *)
---

## 直近のエラーログ
!`tail -200 logs/error.log 2>/dev/null || tail -200 /var/log/app/error.log 2>/dev/null || echo "ログファイルが見つかりません"`

## システムログ（直近1時間）
!`journalctl --since "1 hour ago" --priority=err 2>/dev/null || echo "journalctlが利用できません"`

$ARGUMENTSが指定されている場合はそのパスを優先して解析してください。

エラーを以下の形式でまとめてください:
1. エラー種別と発生回数
2. 初回・最終発生時刻
3. 推定される原因
4. 優先度（Critical/High/Medium/Low）
5. 推奨される対処法

.claude/skills/full-audit/
├── SKILL.md                        # メイン（500行以下）
├── reference/
│   ├── owasp-checklist.md          # OWASPチェックリスト詳細
│   ├── report-template.md          # レポートテンプレート
│   └── severity-guidelines.md      # 重要度判定基準
├── examples/
│   └── sample-report.md            # 出力例
└── scripts/
    └── run-semgrep.sh              # 前処理スクリプト

---
name: full-audit
description: Performs a comprehensive security audit using OWASP guidelines and generates
  a structured report with severity ratings. Reads reference files for detailed checklist
  and report format. Use when asked for a full audit, security review, or pre-release check.
allowed-tools: Read, Grep, Glob, Bash(git log *), Bash(bash .claude/skills/full-audit/scripts/*)
effort: high
context: fork
agent: Explore
---

## セキュリティ監査の実施

### チェックリスト
Read(".claude/skills/full-audit/reference/owasp-checklist.md") を読み込んでから監査を始めてください。

### 出力形式
Read(".claude/skills/full-audit/reference/report-template.md") のテンプレートに従ってレポートを作成してください。

### 重要度の判定基準
Read(".claude/skills/full-audit/reference/severity-guidelines.md") を参照してください。

監査完了後、`docs/security-audit-$(date +%Y%m%d).md` として保存してください。

---
name: parallel-review
description: Runs security audit, test coverage analysis, and code style review in parallel
  as independent sub-agents. Generates a consolidated report from all three perspectives.
  Use when doing a comprehensive review before a release, major PR, or production deploy.
context: fork
agent: Explore
allowed-tools: Read, Grep, Glob, Bash(npm test), Bash(npm run lint), Bash(git diff *)
effort: high
---

## リリース前包括レビュー

以下の3つの観点で並列にコードレビューを実施してください。
各観点は独立して分析し、最後に統合レポートとしてまとめてください。

### 観点1：セキュリティ監査
- OWASP Top 10の脆弱性確認
- 認証・認可の実装ミス
- 秘密情報の誤コミット確認

### 観点2：テストカバレッジ
- !`npm test -- --coverage 2>&1 | tail -30`
- カバレッジが80%未満のファイルを特定
- テストが存在しない新規ファイルを列挙

### 観点3：コードスタイル
- !`npm run lint 2>&1 | head -50`
- チームのコーディング規約との整合性
- コメント・ドキュメントの不足箇所

### 統合レポート
3観点の結果をまとめ、優先度付きのアクションリストを作成してください。
`docs/release-review-$(date +%Y%m%d).md` として保存してください。

## スキル品質チェックリスト

### description
- [ ] 第三人称で始まっている（"Extracts..." / "Analyzes..." など）
- [ ] 200文字以上ある
- [ ] "Use when..." パターンで使用シーンを明記している
- [ ] 具体的なキーワード（ファイル形式・コマンド名・エラー名等）を含む

### SKILL.md本体
- [ ] 500行以下に収まっている
- [ ] 引数が5個未満（多い場合は分割を検討）
- [ ] !`command`の出力に機密情報が含まれないことを確認

### セキュリティ
- [ ] allowed-toolsで不要なツールを制限している
- [ ] 破壊的操作のスキルには disable-model-invocation: true を設定

### 命名
- [ ] 動詞-目的語形式になっている
- [ ] 既存スキルと重複していない
- [ ] version フィールドでメタデータを記録している

---
name: review-pr
description: Reviews a GitHub pull request by fetching the diff, description, and existing
  reviewer comments automatically. Checks for bugs, security vulnerabilities, missing tests,
  documentation gaps, and style consistency with the codebase. Provides actionable feedback
  with file names and line numbers. Use when asked to review a PR or pull request, check
  a specific PR number, or review changes before merging to main.
argument-hint: "[PR番号]"
allowed-tools: Read, Bash(gh pr *), Bash(git log *)
version: "1.0"
---

## PR情報の取得
- 番号: $ARGUMENTS
- 差分: !`gh pr diff $ARGUMENTS`
- PR概要とコメント: !`gh pr view $ARGUMENTS --comments`
- 変更ファイル: !`gh pr diff $ARGUMENTS --name-only`
- 最近のコミット: !`git log --oneline -5`

## レビュー観点

### バグ・ロジックエラー
差分を注意深く読み、潜在的なバグや論理的な誤りを指摘してください。

### セキュリティ
入力値のバリデーション・認証・SQLインジェクション・XSS・秘密情報の露出を確認してください。

### テスト
変更に対応するテストが存在するか確認してください。
新機能・バグ修正にはテストが必須です。テストが不足している場合は指摘してください。

### ドキュメント
公開APIや設定値の変更がある場合、ドキュメントの更新が必要かどうかを確認してください。

レビュー結果はファイル名と行番号を明記して日本語でまとめてください。

---
name: deploy-staging
description: Deploys the current branch to the staging environment by running build, tests,
  and the deploy script in sequence. Checks for uncommitted changes before starting.
  Use ONLY when explicitly asked to deploy to staging or push to the staging environment.
  Do NOT use for production deploys.
argument-hint: "[--skip-tests]"
allowed-tools: Bash(npm run build), Bash(npm test), Bash(bash scripts/deploy-staging.sh),
  Bash(git status), Bash(git branch)
disable-model-invocation: true
version: "2.0"
---

## デプロイ前チェック

### 現在のブランチと変更状況
!`git status --short`
!`git branch --show-current`

未コミットの変更がある場合は作業者に確認してからデプロイしてください。

## デプロイ手順

1. ビルド: `npm run build`
   エラーがあればデプロイを中止してください。

2. テスト: `npm test`（$ARGUMENTSに --skip-tests が含まれる場合はスキップ）
   テストが失敗した場合はデプロイを中止してください。

3. ステージングデプロイ: `bash scripts/deploy-staging.sh`

4. デプロイ結果を報告してください。

⚠️ 本番環境へのデプロイはこのスキルでは実行しません。

---
name: gen-api-docs
description: Generates API documentation from TypeScript source files by reading type
  definitions, JSDoc comments, and existing docs. Creates or updates docs in the docs/api/
  directory. Use when asked to generate documentation, update API docs, or document a
  TypeScript module.
argument-hint: "[ファイルパスまたはディレクトリ]"
allowed-tools: Read, Write, Glob, Grep
context: fork
agent: Explore
effort: medium
version: "1.1"
---

## APIドキュメント生成

対象: $ARGUMENTS

### 手順

1. 対象ファイルのTypeScript型定義とJSDocコメントを読み込む
2. Read(".claude/skills/gen-api-docs/reference/doc-template.md") でテンプレートを確認する
3. 既存のドキュメントがあれば読み込んで差分のみ更新する
4. ドキュメントを `docs/api/` に保存する

### ドキュメントに含めること
- 各関数・クラス・インターフェースの概要
- パラメータの型と説明
- 戻り値の型と説明
- 使用例（JSDocの @example があれば使う）
- 関連するインターフェース・型定義へのリンク

既存ドキュメントとの整合性を保ち、削除せずに更新してください。