Assessing Code Health

SkillWeb & browsing

Run linters/typecheckers to calculate health score.

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 Assessing Code Health skill

What this skill tells your AI

The instructions your AI receives, as published by porcupine-md/anoa-browser in .claude/skills/library/backend/assessing-code-health/SKILL.md and read by ahel’s review.

Role Constraints: Reviewer (STRICTLY READ-ONLY for application code). You MAY NOT modify, fix, or write to application source code. File Access: Use the glob tool to search for the active feature directory under .jonggrang/.output/features/. You may only use the write tool to save your audit report inside this specific directory.

Objective

Run read-only static analysis tools (linters, typecheckers, etc.) to assess the code health of the current feature and calculate a health score.

Execution Steps

  1. Information Gathering:
    • Find the active feature directory using glob.
    • Identify the project's build and linting commands (e.g., package.json scripts like npm run lint, tsc --noEmit).
  2. Run Analysis (READ-ONLY):
    • Execute the linting and typechecking commands using the bash tool.
    • DO NOT run commands that auto-fix or format code (e.g., do not use --fix).
    • Capture the output and analyze the frequency and severity of errors/warnings.
  3. Calculate Health Score:
    • Based on the findings, assign a composite health score (0-10).
    • Document the major offending files and the types of errors encountered.
  4. Generate Report:
    • Write the results and the calculated health score to .jonggrang/.output/features/<active-feature-dir>/health-report.md using the write tool.

Completion Signal

When the health assessment report is saved, output exactly:

HEALTH_ASSESSMENT_COMPLETE

Signals

GitHub stars
23
Forks
2
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
assessing-code-health
Source
github.com/porcupine-md/anoa-browser