About

Imported from jeremylongshore/tons-of-skills-marketplace (plugins/community/skills-janitor/skills/janitor-discover/SKILL.md). Install upstream with npx skills add jeremylongshore/tons-of-skills-marketplace --skill janitor-discover. Copyright stays with the author (MIT).

Skill Discovery & Pre-Install Check

Name: janitor-discover
Author: jeremylongshore

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 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?"

Output: Run discover.sh https://github.com/user/seo-helper, then summarize: overlap with existing skills, the verdict (e.g. "MODERATE_OVERLAP — 45% with marketing-skills:seo-audit"), and a recommendation.

Resources

Dispatcher (plugin-relative): {baseDir}/../../scripts/discover.sh
Search cache: data/search-cache.json (24h TTL)
/janitor-report — health check of currently installed skills
/janitor-value — are existing skills earning their context cost
/janitor-fix — fix issues with installed skills

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/jeremylongshore-tons-of-skills-marketplace-janitor-discover/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

jeremylongshore-tons-of-skills-marketplace-janitor-discover.ocm.jsonjson

{
  "ocm": "1",
  "id": "jeremylongshore-tons-of-skills-marketplace-janitor-discover",
  "kind": "skill",
  "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'.",
  "publisher": "jeremylongshore",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "skills",
      "discovery",
      "github-search",
      "pre-install",
      "duplicates",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "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'."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/jeremylongshore/tons-of-skills-marketplace",
      "path": "plugins/community/skills-janitor/skills/janitor-discover/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/HEAD/plugins/community/skills-janitor/skills/janitor-discover/SKILL.md",
      "key": "jeremylongshore/tons-of-skills-marketplace/plugins/community/skills-janitor/skills/janitor-discover/SKILL.md"
    },
    "compatibility": "Designed for Claude Code. Requires bash 3.2+, curl, and network access to the GitHub API (anonymous works; GITHUB_TOKEN raises rate limits).",
    "allowed_tools": [
      "Read,",
      "Bash(bash:*)"
    ],
    "license": "MIT"
  },
  "instructions": "# Skill Discovery & Pre-Install Check\n\nCombined entry point for finding skills on GitHub and for evaluating a specific skill (URL or local path) before installing it.\n\n## Overview\n\nReplaces 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.\n\n| Argument | Mode | What runs |\n|---|---|---|\n| Keyword(s) like `seo` or `n8n workflows` |",
  "cost": {
    "context_tokens": 980
  }
}

Fetch it by URL: GET /api/v1/registry/jeremylongshore-tons-of-skills-marketplace-janitor-discover/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.