Project Health Check

SkillDatabases & data

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.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Project Health Check skill

What this skill tells your AI

The instructions your AI receives, as published by claude-world/director-mode-lite in skills/project-health-check/SKILL.md and read by ahel’s review.

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

CheckWhen
QuickWeekly
StandardBi-weekly
FullMonthly

Signals

GitHub stars
82
Forks
11
Last commit
Aug 2026
Advanced
Catalog kind
skill
Gateway key
project-health-check
Source
github.com/claude-world/director-mode-lite