Stats
Actions
Tags
This skill should be used when the user asks to "ベスプラチェックして", "ベストプラクティスチェック", "設定を監査して", "CLAUDE.mdを見直したい", "Claude Codeの設定がベストプラクティスに沿っているか確認", "設定チェック", "設定の見直し", "CLAUDE.mdのチェック", "CC設定の診断". グローバル/プロジェクトのClaude Code設定を公式ドキュメントと比較し、ギャップと改善提案をレポートする。
How this skill is triggered — by the user, by Claude, or both
Slash command
/cc-bestpractice-check:cc-bestpractice-checkThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Anthropic公式ドキュメント（code.claude.com）をリファレンスとして、ユーザーのClaude Code設定を比較し、ギャップと改善提案をレポートする。
Anthropic公式ドキュメント（code.claude.com）をリファレンスとして、ユーザーのClaude Code設定を比較し、ギャップと改善提案をレポートする。
$ARGUMENTS — ユーザーがスキル呼び出し時に渡した引数文字列ベストプラクティスの参照元として、以下の公式ドキュメントを WebFetch で取得する。
.md 拡張子付きURLを使用すること（HTMLタグが含まれず効率的）。
| カテゴリ | URL |
|---|---|
| Best Practices（総合） | https://code.claude.com/docs/en/best-practices.md |
| CLAUDE.md | https://code.claude.com/docs/en/memory.md |
| Settings | https://code.claude.com/docs/en/settings.md |
| Hooks | https://code.claude.com/docs/en/hooks-guide.md |
| Skills | https://code.claude.com/docs/en/skills.md |
| Subagents | https://code.claude.com/docs/en/sub-agents.md |
| MCP | https://code.claude.com/docs/en/mcp.md |
| Commands | https://code.claude.com/docs/en/slash-commands.md |
| Plugins | https://code.claude.com/docs/en/plugins.md |
| Permissions | https://code.claude.com/docs/en/permissions.md |
| .claudeディレクトリ構造 | https://code.claude.com/docs/en/claude-directory.md |
| Permission modes / Sandboxing | https://code.claude.com/docs/en/permission-modes.md |
| Status line | https://code.claude.com/docs/en/statusline.md |
| GitHub Actions / CI | https://code.claude.com/docs/en/github-actions.md |
| Environment variables | https://code.claude.com/docs/en/env-vars.md |
このスキルの最重要ルール。必ず守ること。
以下の分類はレポート出力・フィルタリング・比較のすべてで適用する唯一の定義:
| ラベル | 対象 | 意味 |
|---|---|---|
| [GAP] | 利用中の機能 | 明確な問題や欠落（セキュリティリスク、動作に影響する設定ミス等） |
| [推奨] | 利用中の機能 | あると良いが必須ではないプラクティス（CLAUDE.local.md、settings.local.json等） |
| [参考] | 未利用の機能 | 有益そうな機能・パターンの情報提供。導入を強く勧めない |
| (省略) | 未利用かつ関連性の薄い機能 | レポートに含めない |
$ARGUMENTS にプロジェクトパスが指定されていれば、そのパスを対象プロジェクトとする。
AskUserQuestion ツールでユーザーに確認する:
「チェック対象を選んでください:」
- カレントディレクトリ（{CWD}）のプロジェクトをチェック
- グローバル設定のみ —
~/.claude/配下だけチェック
以下のファイル/ディレクトリを読み取る。存在しないものはスキップ。
| 対象 | パス |
|---|---|
| CLAUDE.md | ~/.claude/CLAUDE.md |
| Settings | ~/.claude/settings.json |
| Settings (local) | ~/.claude/settings.local.json |
| Hooks | ~/.claude/hooks/ 配下のファイル一覧と内容 |
| Commands | ~/.claude/commands/ 配下のファイル一覧 |
| Agents | ~/.claude/agents/ 配下のファイル一覧 |
| Skills | ~/.claude/skills/ 配下のディレクトリ一覧 |
| Plugins | ~/.claude/plugins/ 配下のディレクトリ一覧 |
| .claudeディレクトリ全体 | ~/.claude/ のディレクトリ構造 |
| 対象 | パス |
|---|---|
| CLAUDE.md | {project}/.claude/CLAUDE.md または {project}/CLAUDE.md |
| Settings | {project}/.claude/settings.json |
| Settings (local) | {project}/.claude/settings.local.json |
| Commands | {project}/.claude/commands/ |
| Agents | {project}/.claude/agents/ |
| Skills | {project}/.claude/skills/ |
| MCP設定 | {project}/.mcp.json |
| GitHub Actions | {project}/.github/workflows/ 内のClaude Code関連ワークフロー |
| .claudeディレクトリ全体 | {project}/.claude/ のディレクトリ構造 |
プロジェクトが指定された場合、設定収集後にプロジェクトの実態を把握する:
チェック対象の利用状況に基づき、関連する公式ドキュメントのみを WebFetch で取得し、ユーザー設定と意味的に比較する。 完全一致を求めるのではなく、欠落しているベストプラクティスや改善余地を検出する。
| カテゴリ | 取得する公式ドキュメント | 検証対象 |
|---|---|---|
| 総合（必須取得） | Best Practices | — |
| .claudeディレクトリ構造 | .claudeディレクトリ構造 | ディレクトリ構成が推奨パターンに沿っているか |
| CLAUDE.md構成・メモリ管理 | CLAUDE.md | 配置場所、内容の簡潔さ、@importの活用 |
| Settings設定 | Settings, Permissions | グローバル/プロジェクト分離、permission rules |
| Permission modes / Sandboxing | Permission modes / Sandboxing | auto mode、sandbox設定の有無 |
| Hooks活用 | Hooks | フォーマッタ・リンター等の自動化設定 |
| Commands活用 | Commands | カスタムコマンドの有無と構成 |
| Subagents活用 | Subagents | カスタムエージェントの有無と構成 |
| Skills活用 | Skills | スキルの有無と構成 |
| MCP設定 | MCP | MCP接続の有無と構成 |
| Plugins活用 | Plugins | プラグインの有無 |
| Status line | Status line | コンテキスト監視用ステータスライン設定 |
| GitHub Actions / CI | GitHub Actions / CI | Claude Code CI連携の設定有無 |
| Environment variables | Environment variables | 推奨env var設定 |
各カテゴリで以下を確認する:
チェック対象のスコープに応じてレポート構造を変える。
## cc-bestpractice-check レポート
**対象**: {プロジェクト名}（プロジェクトスコープ）
**リファレンス**: Claude Code公式ドキュメント（code.claude.com）
---
### プロジェクト Settings
- **[GAP]** {ギャップの説明}
- **提案**: {具体的な修正内容}
- **参照**: {公式ドキュメントURL}
- **[推奨]** {推奨事項の説明}
- **提案**: {具体的な修正内容}
- **参照**: {公式ドキュメントURL}
### プロジェクト CLAUDE.md
...
### プロジェクト Agents
...
---
**ギャップ合計**: {N}件（GAP: {n1}件、推奨: {n2}件）
---
### 参考: グローバル設定への推奨（情報提供のみ・このスキル実行では適用しません）
- {グローバル側で改善すると良い点}
## cc-bestpractice-check レポート
**対象**: グローバル設定
**リファレンス**: Claude Code公式ドキュメント（code.claude.com）
---
### Settings
- **[GAP]** / **[推奨]** ...
### Hooks
...
---
**ギャップ合計**: {N}件（GAP: {n1}件、推奨: {n2}件）
ギャップが0件の場合:
全カテゴリでベストプラクティスに準拠しています。
レポート出力後、AskUserQuestion ツールでユーザーに確認する:
「修正を適用しますか？」
- すべて適用 — レポート内の全提案を適用
- 選択して適用 — 適用する提案を番号で選択
- 適用しない — レポートの確認のみで終了
「選択して適用」の場合は、適用する提案の番号をユーザーに入力してもらう。
適用時は Edit ツールで既存ファイルを修正、または Write ツールで新規ファイルを作成する。
npx claudepluginhub jun-suzuki1028/cc-plugins --plugin cc-bestpractice-checkAudits Claude Code configurations for best practices in skills, instructions, MCP servers, hooks, plugins, security, over-engineering, and context efficiency via file scans and focused checks. Invoke with /claudit [focus-area].
Reviews or designs Claude Code project configuration including `.claude/` directories and `CLAUDE.md` files. Assesses structural rationality, identifies gaps, and suggests improvements.
Audits Claude Code project configuration for drift and collaboration issues across six layers (CLAUDE.md, rules, skills, hooks, subagents, verifiers), tiered by project complexity.