Development

/project-health-check

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.

claude-world@claude-world

GitHub

From plugin

director-mode-lite See the plugin

8136 skills14 agents6 hooks

shell

$ npx -y skills add claude-world/director-mode-lite --skill project-health-check --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.
You can call itInvoke it directly when you want it.
Slash command/project-health-check

How auto-invocation works

Context preview

The summary Claude sees to decide when to auto-load this skill.

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.

SKILL.md

project-health-check.SKILL.md

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

# 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]

---