sd0xdev/sd0x-dev-flow/claude-health

Claude Code and agent skill by sd0xdev/sd0x-dev-flow

Trust tier 1
  • community
Source check pending

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-health

SKILL.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

ArgumentDescription
--scope hygieneOnly run C1-C7 hygiene checks
--scope syncOnly run S1-S3 sync checks and the S4 plugin-copies inventory
--scope budgetOnly run the Instruction Budget Module (B1-B3)
--scope allRun every module — hygiene, sync and budget (default)

Workflow

[--scope] → Select modules → Scan → Classify → Report → Fix suggestions
│ │
┌───────┴───────┐ P0/P1/P2
▼ ▼ + fix commands
Hygiene (C1-C7) Sync (S1-S3)
Hygiene Module — Checks (7 items)
#CheckMethodCriteria
1Junk filesfind .claude/ -name ".DS_Store" -o -name "*.zip" -o -name ".tmp*"Any exists → P1
2.gitignore existsls .claude/.gitignoreMissing → P1
3.gitignore completenessRead .claude/.gitignore, compare required itemsMissing required → P2
4Naming consistencyScan all skills/*/ for reference vs referencesInconsistent → P2
5README count syncCount actual vs README descriptionMismatch → P2
6Command-Skill pairingEach core skill should have corresponding commandMissing → P1
7Cache sizedu -sh .claude/cache/> 50M → P2
Check 1: Junk Files
bash
find .claude/ -name ".DS_Store" -o -name "*.zip" -o -name ".tmp*" 2>/dev/null
  • Has results → P1: List files, suggest deletion
  • No results → ✅
Check 2-3: .gitignore
bash
ls .claude/.gitignore 2>/dev/null || echo "MISSING"

Missing → P1. If exists, read content and compare required items:

Required ItemReason
.DS_StoremacOS generates continuously
settings.local.jsonPersonal config
cache/Runtime cache
.tmp*Temp files
*.tmpTemp files (suffix variant)
*.zipBackup archives

Missing any → P2

Check 4: Naming Consistency
bash
# Scan all skill subdirectories
for dir in .claude/skills/*/; do
if [ -d "${dir}reference" ]; then echo "INCONSISTENT: ${dir}reference"; fi
done

Has reference/ (singular) → P2, suggest renaming to references/

Check 5: README Count Sync
bash
# Count actual items
ls .claude/commands/ 2>/dev/null | wc -l
ls .claude/skills/ 2>/dev/null | wc -l
ls .claude/agents/ 2>/dev/null | wc -l
ls .claude/rules/ 2>/dev/null | wc -l
ls .claude/hooks/*.sh 2>/dev/null | wc -l

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 TypeExamplesReason
Domain KBportfolio, aumReferenced by other skills, no standalone entry
Externalagent-browserNot maintained by this project

Remaining skills without command → P1

Check 7: Cache Size
bash
du -sh .claude/cache/ 2>/dev/null
  • \> 50M → P2, suggest cleanup
  • ≤ 50M → ✅
Sync Module — Checks (S1-S3)
Only runs when --scope sync or --scope all (default).
S1: Version Check
#CheckMethodCriteria
S1.1Manifest existsRead .sd0x/install-state.jsonMissing → P1
S1.2Manifest parseableJSON.parseParse error → P1
S1.3schema_version current== 1Mismatch → P2
S1.4plugin_version matchesmanifest vs .claude-plugin/plugin.json or package.jsonMismatch → P1
S1.5Manifest completenessHas rules + hook_scripts + scripts keysMissing key → P2 (MANIFEST_GAP)

Plugin version resolution (priority order):

.claude-plugin/plugin.json → package.json → "unknown"

Plugin source location (same as /install-rules Phase 1):

Glob: ~/.claude/plugins/**/sd0x-dev-flow/rules/auto-loop.md
Glob: ${REPO_ROOT}/node_modules/sd0x-dev-flow/rules/auto-loop.md
Fallback: @rules/auto-loop.md (plugin-relative)
S2: Component Classification

For each managed component (rules, hooks, scripts), compute 3 hashes and classify:

bash
manifest_hash = manifest[category][filename].hash # null if missing
local_hash = git hash-object --no-filters <local-path> # null if file missing
plugin_hash = git hash-object --no-filters <plugin-path> # source of truth

Classification table (read-only diagnostic; maps to install-rules states for delegation):

Doctor StateConditionSeverityinstall-rules Equivalent
OKlocal == manifest == plugin✅SKIP
MISSINGlocal_hash is null, plugin existsP1FRESH_INSTALL
OUTDATEDlocal == manifest, plugin != manifestP1AUTO_UPDATE
LOCAL_MODIFIEDlocal != manifest, plugin == manifest✅KEEP_LOCAL
CONFLICTlocal != manifest, plugin != manifestP2CONFLICT
LEGACYmanifest_hash is null, local existsP2LEGACY
MANIFEST_GAPmanifest category key missingP2N/A
TOMBSTONEDmanifest deleted: true, local missing✅SKIP_DELETED
RETIREDname on /install-rules' retired list, plugin file absent, local existsP2Retired (remove when unmodified, keep when modified)

Managed inventory (hardcoded):

CategoryLocal PathPlugin SourceFiles
Rules.claude/rules/*.mdrules/*.mdauto-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/*.shhooks/*.shpre-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):

#CheckSeverityDetectionRecommendation
1Override driftP2based_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"
2Policy contradictionP1An 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"
3Missing reference or baseP1For 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
4Wrong-layer editP2Base auto-loop.md has LOCAL_MODIFIED, CONFLICT, or LEGACY state while project override exists"Move customization to auto-loop-project.md"
5Duplicate headingP2Override file has multiple active ## <heading> with same text"Keep one, remove duplicates. Last occurrence takes effect."
6Legacy precedence headerP2Precedence 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"
7Git override conflictP1 / P2git-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

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
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/sd0xdev/sd0x-dev-flow/claude-health/badge)](https://verified-skill.com/skills/sd0xdev/sd0x-dev-flow/claude-health)

Something wrong with this skill or its page? Tell us.