Health Report

Generate a comprehensive health report combining inventory, quality checks, duplicate detection, and broken skill findings.

How to Run

Run all analysis scripts and combine results:

bash ~/.claude/skills/skills-janitor/scripts/scan.sh
bash ~/.claude/skills/skills-janitor/scripts/lint.sh
bash ~/.claude/skills/skills-janitor/scripts/detect_dupes.sh

What It Covers

Inventory (scan.sh)

All skills across user, project, plugin, and account scopes
Symlink status, frontmatter fields, line counts

Quality Checks (lint.sh)

Critical: Broken symlinks, missing SKILL.md, missing frontmatter
Warning: Missing/empty name or description, description too short/long, missing version
Info: No body content, no Gotchas section, large files

Duplicate Detection (detect_dupes.sh)

Keyword overlap analysis using Jaccard similarity
Flags pairs with >30% overlap
Shows shared keywords and scopes

Broken & Orphaned Skills

Broken symlinks (target deleted)
Empty directories (no SKILL.md)
Orphaned user-scope copies of plugin skills

Report Format

Present a unified report with severity levels:

| Skill              | Scope   | Status      | Issues                          |
|--------------------|---------|-------------|---------------------------------|
| marketing-copy     | user    | OK          | -                               |
| seo-audit          | user    | WARNING     | Description too short (28 chars) |
| old-deploy-helper  | user    | CRITICAL    | Broken symlink                  |
| marketing-copy-v2  | user    | DUPLICATE?  | 72% overlap with marketing-copy |

Recommended Actions

For each issue found, suggest:

Broken symlinks: /janitor-fix --prune
Quality issues: /janitor-fix
Duplicates: manual review, consider removing one
Token waste: /janitor-tokens

Related Skills

For inventory only: /janitor-audit
For auto-fixing: /janitor-fix
For usage analytics: /janitor-usage
For token cost: /janitor-tokens

janitor-report