healthlisted
Install: claude install-skill AreteDriver/ai-skills
# /health - Project Health Audit
Comprehensive project health check covering tests, coverage, dependencies, security, and documentation.
## Usage
```
/health # Full health audit
/health --quick # Quick check (skip slow operations)
/health --fix # Attempt to fix issues found
```
## What This Skill Does
1. **Test Health** - Run tests, check coverage percentage
2. **Dependency Health** - Outdated deps, security vulnerabilities
3. **Code Quality** - Lint issues, type coverage
4. **Documentation** - README, docstrings, CHANGELOG
5. **CI/CD** - Workflow existence and status
6. **Security** - Secrets scanning, dependency audit
## Health Report Format
```markdown
# Project Health Report: [Project Name]
## Summary
| Category | Status | Score |
|----------|--------|-------|
| Tests | Pass | 85% coverage |
| Dependencies | Warning | 3 outdated |
| Code Quality | Pass | No lint errors |
| Documentation | Warning | Missing CHANGELOG |
| Security | Pass | No vulnerabilities |
**Overall Health: Good (4/5)**
---
## Tests
- **Status**: Passing
- **Coverage**: 85% (target: 80%)
- **Test Count**: 127 tests
- **Issues**: None
## Dependencies
- **Outdated Packages**:
- `requests`: 2.28.0 → 2.31.0 (minor)
- `pytest`: 7.2.0 → 7.4.0 (minor)
- **Security Vulnerabilities**: None
- **Unused Dependencies**: None detected
## Code Quality
- **Lint Errors**: 0
- **Type Coverage**: 72%
- **Complexity Issues**: None
## Documentation
- [x] README.md exists