Skip to content

claude-world/director-mode-lite / skills/project-health-check

project-health-check

Verified

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

FileKindSize
SKILL.mdskill md1.6 KB
---
name: project-health-check
description: Audit 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.
user-invocable: true
---

# 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

```markdown
# 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 |
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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall