{"id":48085186,"url":"https://github.com/khendzel/skills-janitor","last_synced_at":"2026-04-20T01:00:42.160Z","repository":{"id":346473562,"uuid":"1189461004","full_name":"khendzel/skills-janitor","owner":"khendzel","description":"Audit, track usage, and compare your Claude Code skills. 9 actions, zero dependencies.","archived":false,"fork":false,"pushed_at":"2026-04-17T06:28:01.000Z","size":1536,"stargazers_count":68,"open_issues_count":0,"forks_count":9,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-17T08:28:56.624Z","etag":null,"topics":["agent-skills","claude-code","claude-code-skills","cli","developer-tools","productivity"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/khendzel.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-23T10:47:47.000Z","updated_at":"2026-04-17T06:28:05.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/khendzel/skills-janitor","commit_stats":null,"previous_names":["khendzel/skills-janitor"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/khendzel/skills-janitor","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khendzel%2Fskills-janitor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khendzel%2Fskills-janitor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khendzel%2Fskills-janitor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khendzel%2Fskills-janitor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/khendzel","download_url":"https://codeload.github.com/khendzel/skills-janitor/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khendzel%2Fskills-janitor/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32028547,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T00:18:06.643Z","status":"ssl_error","status_checked_at":"2026-04-20T00:17:31.068Z","response_time":55,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","claude-code","claude-code-skills","cli","developer-tools","productivity"],"created_at":"2026-04-04T15:14:13.314Z","updated_at":"2026-04-20T01:00:42.153Z","avatar_url":"https://github.com/khendzel.png","language":"Shell","funding_links":[],"categories":["💻 Coding \u0026 Developer Tools","Plugins"],"sub_categories":["All Plugins"],"readme":"# Skills Janitor\n\n\u003e Audit, track usage, and manage your AI coding skills - 7 focused skills, zero dependencies.\n\nWorks with **Claude Code** and **OpenAI Codex**.\n\n![Skills Janitor](demo.gif)\n\nA plugin that keeps your skills ecosystem clean, organized, and healthy. Automatically detects and scans skills from both Claude Code (`~/.claude/skills/`) and OpenAI Codex (`~/.agents/skills/`).\n\n## What's New in v1.1\n\n- **Cross-platform** - works with both Claude Code and OpenAI Codex\n- **Pre-install overlap check** - check if a new skill duplicates existing ones before installing\n- **Context window token cost** - see how many tokens each skill consumes and find unused waste\n- **Consolidated from 9 to 7 commands** - fewer commands, same coverage\n\n## Skills\n\n| Command | What it does |\n|---------|-------------|\n| `/janitor-audit` | Full inventory of all installed skills |\n| `/janitor-report` | Health check: lint, duplicates, broken skills, recommendations |\n| `/janitor-fix` | Auto-fix issues + `--prune` to remove broken skills |\n| `/janitor-usage` | Track which skills you use and which you never use |\n| `/janitor-tokens` | Show context window token cost per skill |\n| `/janitor-search` | Search GitHub for skills + `--compare` for market analysis |\n| `/janitor-precheck` | Check overlap before installing a new skill |\n\n## Install\n\n**Plugin install (recommended):**\n```\n/plugin marketplace add khendzel/skills-janitor\n/plugin install skills-janitor\n```\n\n**Or clone directly:**\n```bash\ngit clone https://github.com/khendzel/skills-janitor ~/.claude/skills/skills-janitor\n```\n\n## Usage examples\n\nEach skill has its own slash command with autocomplete:\n\n```\n/janitor-audit          -\u003e full skill inventory\n/janitor-report         -\u003e health check (lint + duplicates + broken)\n/janitor-usage          -\u003e which skills you actually invoke\n/janitor-tokens         -\u003e context window cost per skill\n/janitor-search         -\u003e find skills on GitHub\n/janitor-search --compare my-skill  -\u003e market analysis vs alternatives\n/janitor-precheck https://github.com/user/skill  -\u003e check before installing\n/janitor-fix            -\u003e auto-fix (dry-run by default)\n/janitor-fix --prune    -\u003e find and remove broken skills\n```\n\nOr use natural language:\n```\n\"audit my skills\"\n\"which skills do I use?\"\n\"how many tokens do my skills cost?\"\n\"check this skill before installing\"\n\"search for n8n skills\"\n```\n\n## Usage tracking\n\nParses your conversation history to show which skills you invoke and which you never use:\n\n```\n=== Skills Janitor - Usage Report ===\nPeriod: 2026-02-24 to 2026-03-23 (4 weeks)\n\nActive skills: 4 / 36 (11%)\nUnused skills: 32 (89%)\nMost used: n8n-workflows (17 total)\nRecommendation: Remove 32 unused skills\n```\n\n## Token cost analysis\n\nShows how many context window tokens each skill consumes:\n\n```\n=== Skills Janitor - Context Window Cost ===\nBudget: 200,000 tokens\n\n  Skill                               Tokens  Budget  Used?\n  marketing-copywriting                2,340   1.2%    yes\n  marketing-seo-audit                  1,560   0.8%     NO\n  ...\n\n  Total token cost: 18,720 (9.4% of budget)\n  Unused skill cost: 14,300 (7.2% of budget wasted)\n```\n\n## Pre-install check\n\nCheck if a new skill overlaps with existing ones before installing:\n\n```\n=== Skills Janitor - Pre-Install Check ===\n\n  Checking: marketing-seo-v2\n  Scanned 35 installed skills\n\n  --- HIGH OVERLAP (likely duplicates) ---\n    [72%] marketing-seo-audit (user)\n         Shared: seo, audit, ranking, meta\n\n  VERDICT: High overlap detected - likely duplicate\n```\n\n## What it won't do\n\n- Never deletes anything without explicit confirmation\n- Never modifies plugin/marketplace skills\n- Respects that some overlap is intentional\n- Dry-run by default for all destructive operations\n\n## Supported Platforms\n\n| Platform | User skills | Project skills | Usage tracking |\n|----------|-------------|----------------|----------------|\n| Claude Code | `~/.claude/skills/` | `./.claude/skills/` | Full (history.jsonl) |\n| OpenAI Codex | `~/.agents/skills/` | `./.agents/skills/` | Keyword matching |\n\nSkills Janitor auto-detects which platforms are installed and scans all of them.\n\n## Requirements\n\n- Bash, Python 3, `curl`\n- No pip installs, no node modules\n\n## Structure\n\n```\nskills-janitor/\n├── .claude-plugin/\n│   └── marketplace.json      # Plugin manifest (7 skills)\n├── skills/\n│   ├── janitor-audit/SKILL.md\n│   ├── janitor-report/SKILL.md\n│   ├── janitor-fix/SKILL.md\n│   ├── janitor-usage/SKILL.md\n│   ├── janitor-tokens/SKILL.md\n│   ├── janitor-search/SKILL.md\n│   └── janitor-precheck/SKILL.md\n├── scripts/                  # Shared bash+python scripts\n├── demo.gif\n├── LICENSE                   # MIT\n└── README.md\n```\n\n## Migrating from v1.0\n\nIf you used v1.0 (9 skills), here's what changed:\n\n| Old command | New equivalent |\n|-------------|---------------|\n| `/janitor-check` | `/janitor-report` (includes lint checks) |\n| `/janitor-duplicates` | `/janitor-report` (includes duplicate detection) |\n| `/janitor-cleanup` | `/janitor-fix --prune` |\n| `/janitor-compare` | `/janitor-search --compare \u003cname\u003e` |\n\n## Contributing\n\nPRs welcome. Each skill is self-contained in `skills/janitor-*/SKILL.md`.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkhendzel%2Fskills-janitor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkhendzel%2Fskills-janitor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkhendzel%2Fskills-janitor/lists"}