概要

claude-health は、Claude Code の設定を「六層フレームワーク」（CLAUDE.md → rules → skills → hooks → subagents → verifiers）に沿って横断的に監査する Claude Code スキルです。プロジェクトの階層（Simple / Standard / Complex）を自動判定し、判定結果に基づいてチェックの幅と深さを調整します。並列に動作する3つの診断エージェント（Context Layer、Control + Verification Layer、Behavior Pattern）が設定の欠陥や構成ミスを検出し、優先度付きのレポート（問題レベル・修正案）を出力して開発者の修正を支援します。

リポジトリの統計情報

スター数: 3
フォーク数: 1
ウォッチャー数: 3
コミット数: 3
ファイル数: 2
メインの言語: 未指定

主な特徴

六層フレームワークに基づく横断的な設定監査（CLAUDE.md → rules → skills → hooks → subagents → verifiers）
プロジェクト階層（Simple / Standard / Complex）を自動判定して診断の強度を調整
Context / Control+Verification / Behavior Pattern の3並列エージェントで包括的にチェック
優先度付きレポートと修正提案を出力して運用改善を促進

技術的なポイント

claude-health は設定監査をスキルとして実装することで、既存の Claude Code ワークフローへ組み込みやすい設計が想定されます。中核となる考え方は「六層フレームワーク」による分解です。まず CLAUDE.md はプロジェクト全体の意図や高レベルのポリシーを表現し、rules や skills は実際の動作ルールと能力（スキル）を定義します。hooks はイベントやトリガー、subagents は役割分担された小さなエージェント群、verifiers は期待値検証のための仕組みです。claude-health はこれらの各レイヤーを自動的に走査して、以下のような診断を行うと読み取れます。

階層判定：ファイル構成や定義の量・複雑さから Simple/Standard/Complex を判定し、例えば Simple なら基本的な整合性チェックのみ、Complex なら追加の振る舞い検査や多段検証を行う。
並列診断エージェント：Context Layer はコンテキストの過不足（例：CLAUDE.md とスキル定義の齟齬）を検出。Control + Verification Layer はルールや verifiers の存在・妥当性を確認。Behavior Pattern はスキルやサブエージェントの期待される振る舞いパターンから逸脱がないかを評価する。これらは並列に実行され、問題を相互参照して優先順位を付ける。
出力と優先度付け：検出した問題は重大度（例：🔴 致命的、🟡 要注意、🟢 情報）で分類され、修正手順や推奨事項を提示する。CI への組み込みや PR コメントで自動フィードバックする運用も想定される設計思想です。
拡張性：skills ディレクトリや subagents、verifiers といった分離された構成要素は、プロジェクト固有のチェックや追加検証ロジックをプラグイン的に追加できる余地があります。README の記述からは詳細実装は読み取りにくいものの、スキルとしての性質上、カスタムルールの追加や診断ポリシーの調整が可能であることが期待されます。

実運用では、リポジトリ設定の静的解析、期待値（verifiers）に基づく動的検証、そして振る舞い異常のルールベース検出を組み合わせることで、Claude Code の設定健全性を高める役割を果たします。現在のリポジトリは小規模（ファイル数・コミット数少）ですが、設計思想としては大型プロジェクトにも適用できる柔軟性を持たせる余地があります。

プロジェクトの構成

主要なファイルとディレクトリ：

README.md: file
skills: dir

まとめ

Claude Code 設定の健全性を自動診断し、優先度付きで改善案を提示するスキルです（導入は容易で拡張性あり）。

リポジトリ情報：

名前: claude-health
説明: Claude Code skill: audit your Claude Code config health across all layers
スター数: 3
言語: null
URL: https://github.com/tw93/claude-health
オーナー: tw93
アバター: https://avatars.githubusercontent.com/u/8736212?v=4

READMEの抜粋：

claude-health

A Claude Code skill that audits your Claude Code configuration health across all layers.

What it does

Systematically reviews your project’s Claude Code setup using the six-layer framework: CLAUDE.md → rules → skills → hooks → subagents → verifiers

Detects project tier (Simple / Standard / Complex) and calibrates checks accordingly
Runs three parallel diagnostic agents: Context Layer, Control + Verification Layer, Behavior Pattern
Outputs a prioritized report: 🔴 Cr…

claude-health — Claude Code 設定ヘルス監査ツール