janitor-discover

Original：🇺🇸 English

Translated

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'.

10installs

Sourcekhendzel/skills-janitor

Added on2026-07-20

NPX Install

npx skill4agent add khendzel/skills-janitor janitor-discover

SKILL.md Content

View Translation Comparison →

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

bash ~/.claude/skills/skills-janitor/scripts/discover.sh <query-or-url> [options]

Examples:

```
discover.sh seo
```
— search for SEO-related skills
```
discover.sh n8n --limit 20
```
— top 20 n8n skills

discover.sh --compare marketing-seo-audit

— alternatives to a local skill

discover.sh https://github.com/user/my-skill

— check before installing

```
discover.sh user/my-skill
```
— same, short form

Step 2: Present results per mode

Discovery mode — ranked list of GitHub repos with skill name, description, stars, last updated, and a one-line verdict.

Pre-install mode — overlap analysis: which of the user's existing skills (including plugin skills) overlap with the candidate by description, and a recommendation to install / skip / replace.

Output

Discovery: a numbered table (repository, stars, updated, INSTALLED/AVAILABLE status). Pre-install: overlap buckets (HIGH ≥60%, MODERATE 30–59%, LOW <30%) with shared keywords and a final verdict line (

HIGH_OVERLAP

/

MODERATE_OVERLAP

/

SAFE

).

Error Handling

Error:
```
GitHub API rate limit exceeded
```
Solution: Set the
```
GITHUB_TOKEN
```
environment variable (any classic token, no scopes needed) and re-run; anonymous search allows only a few requests per minute.
Error:
```
Could not fetch SKILL.md from <url>
```
Solution: The repo keeps its SKILL.md at a non-standard path — pass a direct URL to the SKILL.md file, or a local clone path instead.
Error: No results for a valid topic Solution: The relevance gate drops repos without any skill signal. Broaden the keyword (e.g.
```
n8n skill
```
→
```
n8n
```
) or check the cached results note — results are cached for 24h in
```
data/search-cache.json
```
.

Examples

Example 1: Find skills by topic

Input: "Find me an n8n skill."

Output: Run

discover.sh n8n

, present the ranked table, and flag any result already installed.

Example 2: Check before installing

Input: "Is github.com/user/seo-helper worth installing?"