janitor-report

Featured

Full health check of all your skills in one report. Use when the user wants to check for errors, find duplicates, detect broken skills, or get a complete overview of skill health. Pass --brief for inventory only. Trigger with '/janitor-report'.

Data & Documents 117 stars 19 forks Updated 1 months ago MIT

Install

View on GitHub

Quality Score: 88/100

Stars 20%
69
Recency 20%
75
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Health Report Generate a comprehensive health report combining inventory, quality checks, duplicate detection, and broken skill findings. ## Overview One report covering every place a skill lives: user, project, codex, plugin, and source scopes. Plugin skills appear with their full invocation name (e.g. `marketing-skills:image`, `figma:figma-use`) — these were invisible to the v1.2 report. The scan JSON also includes an `agents` array (subagents from `~/.claude/agents` — their descriptions are always-loaded too) and per-plugin `update_available` (installed commit vs marketplace HEAD) — surface stale plugins and heavy agents in the report. Modes: - **`/janitor-report`** (default) — full health check: inventory + lint + duplicates + broken - **`/janitor-report --brief`** — inventory only (replaces the old `/janitor-audit`) ## Prerequisites - Claude Code with the skills-janitor plugin installed (provides `scripts/scan.sh`, `lint.sh`, `detect_dupes.sh`) - bash 3.2+ (the stock macOS bash works; no external dependencies) - Read access to `~/.claude/skills`, `~/.claude/agents`, and installed plugin metadata - No authentication or API keys required — the scripts read local files only ## Instructions ### Step 1: Run the scripts Full report: ```bash 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 bash ~/.claude/sk...

Details

Author
khendzel
Repository
khendzel/skills-janitor
Created
5 months ago
Last Updated
1 months ago
Language
Shell
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category