claude-world/director-mode-lite / skills/project-health-check
project-health-check
VerifiedAudit project health across 7 dimensions (documentation, test coverage, security, code quality, dependencies, database, build/deploy) producing a scored report with prioritized fixes. Use for periodic checkups, before releases, or when the user runs /project-health-check.
Project Health Check
Comprehensive 7-point audit for project health.
7-Point Audit
1. Documentation
- README is accurate
- API docs exist
- Code comments explain "why"
2. Test Coverage
- Coverage > 80%
- Critical paths tested
- Edge cases covered
3. Security
- No secrets in code
- No vulnerable dependencies
- Input validation exists
4. Code Quality
- Linting passes
- No large files (> 500 lines)
- Consistent naming
5. Dependencies
- No outdated majors
- No unused deps
- Compatible licenses
6. Database
- Schema documented
- Migrations versioned
- Indexes documented
7. Build/Deploy
- Build succeeds
- CI/CD exists
- Env vars documented
Health Score Template
# Project Health Report - [Date]
## Overall Score: [X]/100
| Area | Score | Status |
|------|-------|--------|
| Documentation | /15 | |
| Test Coverage | /15 | |
| Security | /20 | |
| Code Quality | /15 | |
| Dependencies | /15 | |
| Database | /10 | |
| Build/Deploy | /10 | |
### Critical Issues
1. [Fix immediately]
### Warnings
1. [Fix this week]
### Suggestions
1. [Consider]
Frequency
| Check | When |
|---|---|
| Quick | Weekly |
| Standard | Bi-weekly |
| Full | Monthly |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |