sd0xdev/sd0x-dev-flow/claude-health
Claude Code and agent skill by sd0xdev/sd0x-dev-flow
- community
Checking that the SKILL.md file is still in the repository.
Claude Code config health check + plugin sync. Use when: auditing .claude/ structure, checking naming, verifying hook setup, detecting plugin version drift, syncing installed assets. Not for: skill quality (use skill-health-check), code review (use codex-code-review). Output: health report + fix recommendations.
Install
npx vskill@latest install sd0xdev/sd0x-dev-flow/claude-healthSKILL.md
Claude Health Check
Trigger
- Keywords: health check, .claude check, config audit, lint .claude, claude health, plugin sync, version drift, upgrade check, doctor
When NOT to Use
- Code review (use
/codex-review-fast) - Doc review (use
/codex-review-doc) - Security review (use
/codex-security)
Scope
| Argument | Description | |
|---|---|---|
--scope hygiene | Only run C1-C7 hygiene checks | |
--scope sync | Only run S1-S3 sync checks and the S4 plugin-copies inventory | |
--scope budget | Only run the Instruction Budget Module (B1-B3) | |
--scope all | Run every module — hygiene, sync and budget (default) |
Workflow
Hygiene Module — Checks (7 items)
| # | Check | Method | Criteria | |
|---|---|---|---|---|
| 1 | Junk files | find .claude/ -name ".DS_Store" -o -name "*.zip" -o -name ".tmp*" | Any exists → P1 | |
| 2 | .gitignore exists | ls .claude/.gitignore | Missing → P1 | |
| 3 | .gitignore completeness | Read .claude/.gitignore, compare required items | Missing required → P2 | |
| 4 | Naming consistency | Scan all skills/*/ for reference vs references | Inconsistent → P2 | |
| 5 | README count sync | Count actual vs README description | Mismatch → P2 | |
| 6 | Command-Skill pairing | Each core skill should have corresponding command | Missing → P1 | |
| 7 | Cache size | du -sh .claude/cache/ | > 50M → P2 |
Check 1: Junk Files
- Has results → P1: List files, suggest deletion
- No results → ✅
Check 2-3: .gitignore
Missing → P1. If exists, read content and compare required items:
| Required Item | Reason | |
|---|---|---|
.DS_Store | macOS generates continuously | |
settings.local.json | Personal config | |
cache/ | Runtime cache | |
.tmp* | Temp files | |
*.tmp | Temp files (suffix variant) | |
*.zip | Backup archives |
Missing any → P2
Check 4: Naming Consistency
Has reference/ (singular) → P2, suggest renaming to references/
Check 5: README Count Sync
Extract counts from README.md, compare. Mismatch → P2
Check 6: Command-Skill Pairing
Scan all skills/*/SKILL.md, exclude these types, then check for corresponding command:
| Exclude Type | Examples | Reason | |
|---|---|---|---|
| Domain KB | portfolio, aum | Referenced by other skills, no standalone entry | |
| External | agent-browser | Not maintained by this project |
Remaining skills without command → P1
Check 7: Cache Size
- \> 50M → P2, suggest cleanup
- ≤ 50M → ✅
Sync Module — Checks (S1-S3)
Only runs when--scope syncor--scope all(default).
S1: Version Check
| # | Check | Method | Criteria | |
|---|---|---|---|---|
| S1.1 | Manifest exists | Read .sd0x/install-state.json | Missing → P1 | |
| S1.2 | Manifest parseable | JSON.parse | Parse error → P1 | |
| S1.3 | schema_version current | == 1 | Mismatch → P2 | |
| S1.4 | plugin_version matches | manifest vs .claude-plugin/plugin.json or package.json | Mismatch → P1 | |
| S1.5 | Manifest completeness | Has rules + hook_scripts + scripts keys | Missing key → P2 (MANIFEST_GAP) |
Plugin version resolution (priority order):
Plugin source location (same as /install-rules Phase 1):
S2: Component Classification
For each managed component (rules, hooks, scripts), compute 3 hashes and classify:
Classification table (read-only diagnostic; maps to install-rules states for delegation):
| Doctor State | Condition | Severity | install-rules Equivalent | |
|---|---|---|---|---|
OK | local == manifest == plugin | ✅ | SKIP | |
MISSING | local_hash is null, plugin exists | P1 | FRESH_INSTALL | |
OUTDATED | local == manifest, plugin != manifest | P1 | AUTO_UPDATE | |
LOCAL_MODIFIED | local != manifest, plugin == manifest | ✅ | KEEP_LOCAL | |
CONFLICT | local != manifest, plugin != manifest | P2 | CONFLICT | |
LEGACY | manifest_hash is null, local exists | P2 | LEGACY | |
MANIFEST_GAP | manifest category key missing | P2 | N/A | |
TOMBSTONED | manifest deleted: true, local missing | ✅ | SKIP_DELETED | |
RETIRED | name on /install-rules' retired list, plugin file absent, local exists | P2 | Retired (remove when unmodified, keep when modified) |
Managed inventory (hardcoded):
| Category | Local Path | Plugin Source | Files | |
|---|---|---|---|---|
| Rules | .claude/rules/*.md | rules/*.md | auto-loop.md, codex-invocation.md, testing.md, security.md, git-workflow.md, logging.md, docs-writing.md, docs-numbering.md, self-improvement.md, context-management.md, discretion.md, scope-discipline.md, override-contract.md | |
| Hooks | .claude/hooks/*.sh | hooks/*.sh | pre-edit-guard.sh, pre-bash-codex-launch-guard.sh, post-edit-format.sh, post-skill-auto-loop.sh, post-compact-auto-loop.sh, stop-guard.sh, user-prompt-review-guard.sh | |
| Retired rules | .claude/rules/*.md | — (no longer shipped) | Every name on /install-rules' Retired table — today fix-all-issues.md, framework.md. Classified RETIRED when the local file exists, TOMBSTONED when the manifest marks it deleted, and nothing when neither | |
| Scripts | .claude/scripts/ | scripts/ | precommit-runner.js, verify-runner.js, review-state.js, dep-audit.sh, commit-msg-guard.sh, pre-push-gate.sh, protected-branches.sh, lib/utils.js, lib/tree-digest.js |
S2.5: Override Safeguard Checks
7 checks for project override files (e.g., auto-loop-project.md):
| # | Check | Severity | Detection | Recommendation | |||||
|---|---|---|---|---|---|---|---|---|---|
| 1 | Override drift | P2 | based_on hash comment in project file vs the hash of the base file that comment names (derived, never hard-coded — auto-loop-project.md, testing-project.md and git-workflow-project.md all ship) — only when the override file has active content; a scaffold with every section still commented out has no overrides to review, so drift is not reported | "Base <rule> updated since override authored; review your overrides" | |||||
| 2 | Policy contradiction | P1 | An overridden section omits a required check command that the same section of the base rule contains | "Override drops a required check command its base section carries" | |||||
| 3 | Missing reference or base | P1 | For each shipped override file (auto-loop-project.md, testing-project.md, git-workflow-project.md): .claude/CLAUDE.md has @rules/<file> but the file is missing, OR the file exists but is not referenced (by @rules/<file>, or — for a template carrying paths: frontmatter — by a plain rules/<file> mention; an @ import of a path-scoped template is reported P2 instead, because it loads the file at launch and defeats the scoping), OR the file exists but the base rule its Based on: comment names is missing from .claude/rules/ | /install-rules to recreate the missing file or base, or add the reference | |||||
| 4 | Wrong-layer edit | P2 | Base auto-loop.md has LOCAL_MODIFIED, CONFLICT, or LEGACY state while project override exists | "Move customization to auto-loop-project.md" | |||||
| 5 | Duplicate heading | P2 | Override file has multiple active ## <heading> with same text | "Keep one, remove duplicates. Last occurrence takes effect." | |||||
| 6 | Legacy precedence header | P2 | Precedence declaration exists only inside an HTML comment (<!-- Precedence: present, no live Precedence: line before the first ##) — HTML comments are stripped from model context (R8), so the declaration never reaches its only reader | "Header predates the live-precedence contract; migrate the precedence line to live text by hand or regenerate via /install-rules --customize <rule> --reset. This check is read-only — it never edits the user-owned file" | |||||
| 7 | Git override conflict | P1 / P2 | git-workflow-project.md only. P1 whenever the file exists, active content or not — two empty duplicate ## Protected Branches headings are already a parse error: when /bin/bash -p -- <resolver> --root <repo> --list exits 2, where <resolver> is the plugin install's copy — ${CLAUDE_PLUGIN_ROOT}/scripts/protected-branches.sh when that variable is set and its real path lies outside the audited repository, else ~/.claude/plugins/**/sd0x-dev-flow/scripts/protected-branches.sh (one match) — never a copy inside the audited repository (.claude/scripts/, scripts/, node_modules/), because this check is read-only and the repository controls those files; no plugin install found → execute nothing and report check #7 as not run (P2), while S2 still classifies the local copy by hash — a removal attempt (- !main), a malformed bullet or a duplicate heading in ## Protected Branches, which makes every branch read as protected; an omitted default is never reported, since the set only widens. P2, active content only, when a ## Deploy Workflow line matches neither `merge <source> -> <target> [--no-ff\ | --ff-only] nor run <path> [args…] with every token in ^[A-Za-z0-9._/@:=+,-]+$, or when ## Offer Mode / ## Run Steps carries a value outside on\ | commit-only\ | off / print\ | execute` | "Fix the named line; until then the protected set reads every branch as protected / the deploy block is ignored / the setting keeps its default" |
Policy contradiction detection: For each ## <heading> section the override restates, extract the backticked check commands (/codex-review-fast, /codex-review-doc, /precommit) from the same-heading section of the base `auto-loop.md` and require the restated section to keep every one of them. A verbatim copy therefore never flags; only a restatement that drops a command its base section carries is P1. (The base's Auto-Trigger table was retired by R3 — code/doc routing now lives in the unheaded terminal-invariant paragraph, which the exact-##-heading override mechanism cannot restate, so routing itself is not overridable and is out of this check's scope.) No restated section → check passes vacuously.
This is the start of the file. Read the full SKILL.md on GitHub.
Security
- Security scanPassedPattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/claude-health/SKILL.md
Popularity
- Repository stars
- 188
- Repository forks
- 24
- 7-day trend score
- 26
Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 21 Mar 2026, 8 months ago.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/sd0xdev/sd0x-dev-flow/claude-health)