janitor-report

Health Report

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

As of v1.3, the report covers plugin-namespaced skills (e.g. marketing-skills:image, figma:figma-use) in addition to user and project scope — these were invisible to the v1.2 report.

Modes

• /janitor-report (default) — full health check: inventory + lint + duplicates + broken
• /janitor-report --brief — inventory only (replaces the old /janitor-audit)

How to Run

Full report:

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

Brief mode (inventory only):

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

What the Full Report Covers

Inventory (scan.sh)

• All skills across user, project, codex, plugin, and source scopes
• Plugin skills appear with their full invocation name (<plugin>:<skill>)
• 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)

• Name collisions — two distinct skills with the same qualified name at different paths
• Description overlap — Jaccard similarity >30%, with cross-scope user-vs-plugin pairs explicitly surfaced (e.g. marketing-seo-audit (user) ↔ marketing-skills:seo-audit (plugin))

Report Format

Present a unified report with severity levels:

| Skill                            | Scope    | Status      | Issues                                   |
|----------------------------------|----------|-------------|------------------------------------------|
| marketing-copywriting            | user     | DUPLICATE?  | 90% overlap with marketing-skills:copywriting |
| seo-audit                        | user     | WARNING     | Description too short                    |
| old-deploy-helper                | user     | CRITICAL    | Broken symlink                           |
| figma:figma-use                  | plugin   | OK          | -                                        |

Recommended Actions

For each issue found, suggest:

• Broken symlinks → /janitor-fix --prune
• Quality issues → /janitor-fix
• User-vs-plugin duplicates → uninstall the user-scope copy and rely on the plugin (or vice versa)
• Token waste → /janitor-value

Related Skills

• /janitor-report --brief — inventory only
• /janitor-fix — auto-fix issues
• /janitor-value — token cost + usage (combined)
• /janitor-discover — find or evaluate new skills