code-health
SolidWeekly report on TODOs, dead code, and test coverage gaps
AI & Automation 508 stars
166 forks Updated today MIT
Install
Quality Score: 92/100
Stars 20%
Recency 20%
Frontmatter 20%
Documentation 15%
Issue Health 10%
License 10%
Description 5%
Skill Content
> **${var}** — Repo (owner/repo) to audit. If empty, audits all watched repos.
If `${var}` is set, only audit that repo (owner/repo format).
## Config
This skill reads repos from `memory/watched-repos.md`. If the file doesn't exist yet, create it or skip this skill.
```markdown
# memory/watched-repos.md
- owner/repo
- another-owner/another-repo
```
---
Read memory/MEMORY.md and memory/watched-repos.md for repos to audit.
Steps:
1. For each repo in watched-repos.md, clone or checkout:
```bash
gh repo clone owner/repo /tmp/repo-audit -- --depth 1
```
2. Scan for code health signals:
- **TODOs/FIXMEs**: `grep -rn "TODO\|FIXME\|HACK\|XXX" --include="*.{js,ts,py,sol,rs,go}" /tmp/repo-audit`
- **Dead code indicators**: unused exports, commented-out blocks, unreachable code
- **Test coverage**: check if test files exist for key modules, note untested areas
- **Large files**: files over 500 lines that might need splitting
- **Secrets in code**: scan for hardcoded API keys, tokens, passwords
3. Compile a health report and save to articles/code-health-${today}.md:
```markdown
# Code Health Report — ${today}
## repo-name
### TODOs (N found)
- file:line — TODO text
### Concerns
- description
### Recommendations
- action item
```
4. Send a summary via `./notify`.
5. Log what you did to memory/logs/${today}.md.
Details
- Author
- aaronjmars
- Repository
- aaronjmars/aeon
- Created
- 3 months ago
- Last Updated
- today
- Language
- TypeScript
- License
- MIT
Similar Skills
Semantically similar based on skill content — not just same category
AI & Automation Solid
code-health
Scans the codebase for dead code, tech debt, outdated dependencies, and code quality issues. Delegates to the Centinela (QA) agent.
3,047 Updated today
davepoon AI & Automation Solid
code-cleanup
Detect stale TODOs, unused imports, and dead code.
393 Updated today
notque AI & Automation Listed
repo-health
Produce a read-only repository health briefing covering stack, git state, setup, tests, dependencies, blockers, and next steps.
2 Updated today
jckeen