Setup Project Health — Development skill for Claude Code
Read-only report on whether this repo's /setup-project artifacts have drifted or gone stale.
How to install Setup Project Health
Installs to ~/.claude/skills/adnanmokhtar-refract-setup-project-health/SKILL.md
mkdir -p ~/.claude/skills/adnanmokhtar-refract-setup-project-health && curl -fsSL https://raw.githubusercontent.com/adnanmokhtar/refract/HEAD/commands/setup-project-health.md -o ~/.claude/skills/adnanmokhtar-refract-setup-project-health/SKILL.md Restart Claude Code, or start a new session, for it to be picked up.
What Setup Project Health does
description: Read-only report on whether this repo's /setup-project artifacts have drifted or gone stale. Dead files, budget breaches, missing ADRs, unconfirmed claims. Trigger on 'is my setup stale', 'check setup health', 'are the conventions still in sync with the code', 'why does /setup-project say there is no work to do'. Do NOT trigger on any ask to FIX drift (/setup-project --refresh) or when the caller expects a write of any kind. It grades setup artifacts, not product code — that is
Alternatives in Development
- Obsidian Health — Run a vault health check — grouped by severity, detects contradictions, concept gaps, stale claims, and struct 277 ★
- Bm Doctor — Diagnose and recover basemind when it isn't working (MCP tools missing/erroring, "no index", dead server) — ru 94 ★
- Full Review — Complete patent application review (claims + specification + formalities in parallel) 91 ★
Full documentation available on GitHub
View Source RepositoryRelated Skills
Coord Recover
Reconcile a row when the board and reality disagree — stale claims, dead sessions, blocked rows, overlapping w
ADR Walk
Enforce ADR supersession. Find dead ADRs (status=superseded but still in active context), validate that supers
Sp.Adr
Review planning artifacts for architecturally significant decisions and create ADRs.
Critical Thinking
A Claude skill for end-of-session critical thinking reviews. Surfaces unverified claims, missing perspectives,
Omit Edit
Run an editor's pass over the current diff: flag bloat, uncited claims, missing footnotes, and cut opportuniti
Obsidian Ingest
Ingest a source into the vault — the vault rewrites itself around new knowledge. Every ingest updates entities
Related Agents
Bh Drift
Drift lens of Black Heron audit. Promise-vs-delivery signals — TODO accumulation, commits that reference missi
Selfish Integrity Contradiction
Protect reputation by detecting unsupported claims, contradictions, plagiarism risk, privacy breaches, inflate
Knowledge Gardener
Surveys the graph and notes what has gone leggy or stale — never prunes. Use this agent for read-only knowledg