概要
Claude Codeの設定健全性を診断するスキル。プロジェクトの複雑さを検出し、6層フレームワーク（CLAUDE.md → rules → skills → hooks → subagents → verifiers）でレビュー。設定の矛盾や不足を自動検出し、開発効率と運用安定性の両立を支援する。
主な機能
- 6層フレームワーク診断: CLAUDE.md、rules/、skills/、hooks、subagents、verifiersを体系的にチェック
- セキュリティ検査: skill securityを含む設定内容を検証
- プロジェクト複雑度の自動判定: Simple / Standard / Complexのいずれかを自動判定
- 改善提案レポート: 検出した問題に対する修復方法を提示
- 層別最適化: プロジェクト規模に応じ、必要な層のみをチェック
導入方法
グローバルインストール（推奨）:
npx skills add tw93/claude-health -a claude-code -s health -g -y
プロジェクト単位でのインストール:
npx skills add tw93/claude-health -a claude-code -s health -y
Claude Plugin:
claude plugin install health
インストール後、Claude Codeを再起動する。
使用方法
Claude Code内で /health コマンドを実行するか、「Run a health check on my Claude Code config」と指示。ツールが自動的にプロジェクト層を判定し、適切なチェックを実行する。
競合比較
| ツール | 対象範囲 | 修復支援 | 統合方式 |
|---|---|---|---|
| claude-health | Claude Code全層 | 提案あり | Skillネイティブ |
| VS Code Linter | ファイル単位 | 一部自動修正 | 拡張機能 |
| 手動設定チェック | カスタマイズ可 | 自力対応 | なし |
claude-healthの差別化点は、Claude Code特有の6層構造を前提設計したこと。ファイル単位の静的解析に留まらず、設定層全体の整合性を検証できる。
活用シーン
プロジェクト初期化時: 新規プロジェクト立ち上げ時に実行し、Claude Code環境が正しく構築されているか確認。設定漏れや誤りを本開発前に排除し、後発的なトラブルを防止。
チーム開発での環境統一: メンバーのローカル環境設定が異なる場合、このツールでスキャンすれば誰の環境が基準を満たしていないか可視化。環境構築ドキュメントの検証にも使用可能。
本番環境移行時: ステージング環境とProduction環境の設定差分を診断。意図しない設定の相違が本番でバグになることを事前防止。デプロイ前チェックリストの一部として組み込める。
こんな人におすすめ
- Claude Codeユーザー: 設定が複雑で管理に不安がある人
- チームリード: メンバーの環境構築ばらつきを統制したい責任者
- DevOps/SRE: 本番環境の設定品質を継続的に監視したい運用者
- プロダクトエンジニア: 開発から本番までの設定一貫性を重視するチーム
- Claude Code Skill開発者: 自作スキルの設定依存関係を診断したい拡張開発者