| name | janitor-discover |
| description | Find new skills on GitHub or check a specific skill before installing. Use when the user wants to search for skills, evaluate a skill URL, check overlap with existing skills before installing, or compare a local skill against alternatives. Trigger with '/janitor-discover'. |
| allowed-tools | Read, Bash(bash:*) |
| argument-hint | <query-or-url> [--limit N] [--compare <skill>] [--json] |
| version | 1.5.1 |
| author | Krzysztof Hendzel <krzysztoff.hendzel@gmail.com> |
| license | MIT |
| compatibility | Designed for Claude Code. Requires bash 3.2+, curl, and network access to the GitHub API (anonymous works; GITHUB_TOKEN raises rate limits). |
| tags | ["skills","discovery","github-search","pre-install","duplicates"] |
Skill Discovery & Pre-Install Check
Combined entry point for finding skills on GitHub and for evaluating a specific skill (URL or local path) before installing it.
Overview
Replaces the v1.2 split between /janitor-search and /janitor-precheck. The dispatcher picks the right mode from the argument shape. Search results are relevance-gated (a repo must carry a skill signal in its name/description/topics) and ranked by relevance before stars, so generic mega-repos don't crowd out actual skills.
| Argument | Mode | What runs |
|---|
Keyword(s) like seo or n8n workflows | Discovery | search.sh — find matching skills on GitHub |
--compare <skill-name> | Comparison | search.sh --compare — find alternatives to a local skill |
Full URL: https://github.com/user/skill | Pre-install check | precheck.sh — analyze before installing |
Short repo: user/skill | Pre-install check | precheck.sh (auto-expanded to URL) |
Local path: ~/path/to/skill | Pre-install check | precheck.sh (local folder) |
Prerequisites
- Claude Code with the skills-janitor plugin installed (provides
scripts/discover.sh, search.sh, precheck.sh, compare.sh)
- bash 3.2+ and
curl
- Network access to
api.github.com (anonymous OK; set GITHUB_TOKEN for higher rate limits and code search)
Instructions
Step 1: Dispatch on argument shape
bash ~/.claude/skills/skills-janitor/scripts/discover.sh <query-or-url> [options]
Examples:
discover.sh seo — search for SEO-related skillsdiscover.sh n8n --limit 20 — top 20 n8n skillsdiscover.sh --compare marketing-seo-audit — alternatives to a local skill
