agentleFS
LL4nc33LL4nc33/code-workspace-engine/skills/health-dashboard/SKILL.md

health-dashboard

Skill0 starsChanged 7 months agoMITView on GitHub

Use when checking project health, code quality, dependency status, documentation freshness, or git health. Invoked via /cwe:quality health or PROACTIVELY at session start for status overview.

The file

Files
SKILL.md

Health Dashboard

Project health at a glance. Combines code quality, dependencies, documentation, git, and security metrics.

Invocation

  • /cwe:quality health — full dashboard
  • Session start — abbreviated summary (idea count, uncommitted changes, version)

Dashboard Sections

1. Code Quality

# Test coverage (detect test runner)
npm test -- --coverage 2>/dev/null    # Node.js
pytest --cov 2>/dev/null              # Python
cargo test 2>/dev/null                # Rust
go test -cover ./... 2>/dev/null      # Go
MetricHow to MeasureTarget
Test coverageTest runner with --coverage flag>80%
ComplexityCount functions >50 linesavg <10 cyclomatic
TODO/FIXME countgrep -r "TODO|FIXME" src/Track trend
Type coveragetsconfig strict, mypy, etc.>90%

2. Dependencies

# Outdated packages
npm outdated 2>/dev/null              # Node.js
pip list --outdated 2>/dev/null       # Python

# Vulnerability scan
npm audit 2>/dev/null                 # Node.js
pip-audit 2>/dev/null                 # Python
cargo audit 2>/dev/null               # Rust
MetricHow to MeasureTarget
Total depsPackage manifestTrack count
Outdated (minor)Package manager outdated<5
Outdated (major)Package manager outdated0
VulnerabilitiesAudit tool0
License issuesLicense checker0

3. Documentation

Uses project-docs skill for freshness check:

CheckMethodTarget
README currentVERSION matchcurrent
ARCHITECTURE.mdComponent list matchcurrent
API.mdEndpoint count matchcurrent
CHANGELOGLatest version matchcurrent
ADRsCount + no "Proposed" stale >30dall resolved

4. Git Health

git status --porcelain          # Uncommitted changes
git log --oneline -1            # Last commit
git branch --show-current       # Current branch
git log --format='%s' -20       # Recent commit messages for CC check
MetricHow to MeasureTarget
Current branchgit branchdescriptive name
Uncommitted changesgit status<10 files
Last commitgit log -1<24h ago
Conventional commitsParse last 20 messages>95%
Unpushed commitsgit log @{u}..HEAD<5

5. Security

CheckMethodTarget
.gitignore completeCheck required entriesall present
Secrets scanRun safety-gate patterns on codebase0 findings
Last auditCheck daily logs (memory/YYYY-MM-DD.md) for security agent run<7 days
Dependenciesnpm audit / pip-audit0 vulnerabilities

Output Format

## Project Health: <project-name> v<VERSION>

### Code Quality
- Test Coverage: XX% (trend)
- Complexity: X.X avg (target: <10)
- TODO/FIXME count: X (trend)

### Dependencies
- Total: X (Y dev)
- Outdated: X minor, X major
- Vulnerable: X
- License issues: X

### Documentation
- README: current | STALE
- ARCHITECTURE.md: current | STALE
- API.md: current | STALE | N/A
- CHANGELOG: current | STALE

### Git Health
- Branch: <branch-name>
- Uncommitted: X files
- Last commit: Xh ago
- Conventional commits: XX%

### Security
- .gitignore: complete | incomplete
- Secrets scan: clean | X findings
- Last audit: X days ago

Health Score

Calculate an overall score (0-100):

CategoryWeightScoring
Code Quality25%Coverage >80% = full, -2 per % below
Dependencies20%0 vulnerable = full, -10 per vuln
Documentation20%All current = full, -5 per stale doc
Git Health20%CC >95% + clean tree = full
Security15%Clean scan + complete .gitignore = full

Display as: Health Score: 87/100 (Good)

ScoreRating
90-100Excellent
75-89Good
60-74Needs Attention
<60Critical

CODEOWNERS Generation

Auto-generate CODEOWNERS from git history:

# For each top-level directory, find most active contributors
git log --format='%aN' -- <path> | sort | uniq -c | sort -rn | head -3

Output GitHub-compatible CODEOWNERS format:

# Auto-generated by CWE health-dashboard
/src/auth/    @developer1 @developer2
/src/api/     @developer1
/docs/        @developer3

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.