Discovery Scanner
Run a full freshie ecosystem discovery scan via rebuild-inventory.py and report plugin, skill, and pack delta against the previous run stored in the SQLite inventory database. Use when refreshing the inventory after adding plugins or tracking ecosystem growth over time. Trigger with \"run discovery scan\", \"scan the inventory\".
- Type
- Subagent
- Repository
- jeremylongshore/tons-of-skills-marketplace
- GitHub stars
- 2.8k
- License
- MIT
- Repo last updated
- Sep 27, 2026
- Model
- inherit
- Version
- 1.0.0
- Author
- Jeremy Longshore <[email protected]>
What Discovery Scanner is
Discovery Scanner is a subagent published in the jeremylongshore/tons-of-skills-marketplace repository on GitHub, which has about 2.8k stars. The repository describes itself as: “Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com.”
A subagent is a specialist assistant that Claude can hand part of a task to. It is a markdown file whose frontmatter sets a name, a description that tells Claude when to delegate, and optionally the tools and model it may use; the body becomes the subagent's own system prompt.
Because a subagent works in its own context, it keeps the main conversation focused: Claude can send a narrow job, such as a review or a specialised analysis, to Discovery Scanner and get back a compact result.
How to install Discovery Scanner
Claude Code
- Download discovery-scanner.md from the repository.
- Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control.
- Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.
Claude Cowork
- Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent.
- Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.
New to extending Cowork? Our plugins guide and Customize guide explain how skills, plugins, and connectors fit together.
Inside the source file
An excerpt from plugins/database/freshie-inventory-manager/agents/discovery-scanner.md, shared under the repository's MIT license. Read the full file on GitHub.
You are a freshie ecosystem scanner. Your job is to run a full discovery scan of the claude-code-plugins repository and report what changed.
Process
- Show current state before scanning:
sqlite3 freshie/inventory.sqlite "SELECT id, run_date, total_plugins, total_skills, COALESCE(total_packs, 0) as total_packs FROM discovery_runs ORDER BY id DESC LIMIT 1;"- Run the scan:
python3 freshie/scripts/rebuild-inventory.py- Report the delta — compare new run vs previous:
sqlite3 freshie/inventory.sqlite "
SELECT
d1.id as new_run, d1.total_plugins as new_plugins, d1.total_skills as new_skills,
COALESCE(d1.total_packs, 0) as new_packs,
d2.id as old_run, d2.total_plugins as old_plugins, d2.total_skills as old_skills,
COALESCE(d2.total_packs, 0) as old_packs,
d1.total_plugins - d2.total_plugins as plugin_delta,
d1.total_skills - d2.total_skills as skill_delta
FROM discovery_runs d1
JOIN discovery_runs d2 ON d2.id = d1.id - 1
ORDER BY d1.id DESC LIMIT 1;
"Output Format
DISCOVERY SCAN COMPLETE
========================
New Run: #{id} ({date})
Previous: #{id} ({date})
Plugins: {old} → {new} ({+/-delta})
Skills: {old} → {new} ({+/-delta})
Packs: {old} → {new} ({+/-delta})
Scan duration: {time}Error Handling
- If rebuild-inventory.py fails, report the error output verbatim
- If this is the first run (no previous), just report absolute counts
- If DB doesn't exist, the script will create it
Before you install
- Read the whole file first. Skills, commands, and subagents are instructions Claude will follow, so make sure they match what you want.
- Check which tools, scripts, or MCP servers it uses. Local servers and scripts run with your permissions.
- Try it in a test project or a copy of your files before pointing it at real work.
- Pin the version you tested, and review changes before updating.
- Watch for instructions that fetch web content or run shell commands; those are where prompt injection risks start. See our prompt injection guide.
FAQ
What is Discovery Scanner?
Discovery Scanner is a subagent for Claude Code and Claude Cowork from the jeremylongshore/tons-of-skills-marketplace repository on GitHub. Run a full freshie ecosystem discovery scan via rebuild-inventory.py and report plugin, skill, and pack delta against the previous run stored in the SQLite inventory database. Use when refreshing the inventory after adding plugins or tracking ecosystem growth over time. Trigger with \"run discovery scan\", \"scan the inventory\".
How do I install Discovery Scanner in Claude Code?
Download discovery-scanner.md from the repository. Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control. Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.
Can I use Discovery Scanner in Claude Cowork?
Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent. Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.
Is Discovery Scanner safe to install?
It is a third-party community resource, not reviewed by Anthropic or this site. Read the source file first, check which tools and connectors it uses, and install only from sources you trust.
Similar resources
- Reporting Narrative Compiles specialist agent outputs into tiered analytics narratives (mini pulse, daily brief, full deep-dive) in an advisory business voice — never touches raw data. Use when generating a polished analytics report for console, email, or Slack. Trigger with \"generate analytics report\", \"compile analytics brief\". Subagent · jeremylongshore/tons-of-skills-marketplace
- Resource Usage Tracker Track and optimize resource usage across the stack Plugin · jeremylongshore/tons-of-skills-marketplace
- Response Time Tracker Track and optimize application response times Plugin · jeremylongshore/tons-of-skills-marketplace
- Resp Writes incident response playbooks, containment runbooks, and post-incident reviews following the PICERL framework — contain first, preserve evidence, never blame. Use when building IR readiness or handling an active incident. Trigger with \"write an incident response playbook\", \"design containment procedures\". Subagent · jeremylongshore/tons-of-skills-marketplace
- Distribution Plans and generates multi-platform content distribution strategies with platform-specific metadata, timing, and cross-promotion linking. Use when publishing a video across YouTube, TikTok, LinkedIn, and more. Trigger with \"distribute my content\", \"plan multi-platform release\". Subagent · jeremylongshore/tons-of-skills-marketplace
- Derivatives Agent Track and analyze crypto derivatives markets — funding rates, open interest, liquidation heatmaps, implied volatility, and options flow across Binance, Bybit, Deribit, and DEX perps. Use when researching perpetual positioning, basis-trade opportunities, or options sentiment. Trigger with \"analyze derivatives\", \"funding rates\". Subagent · jeremylongshore/tons-of-skills-marketplace
- Docker Specialist Analyzes Dockerfiles and produces optimized multi-stage builds, .dockerignore files, and docker-compose configs that shrink image size by 80-90% and enforce security best practices. Use when optimizing container builds or starting a new Dockerfile. Trigger with \"optimize my dockerfile\", \"reduce docker image size\". Subagent · jeremylongshore/tons-of-skills-marketplace
- Deployment Specialist Deployment strategy and release management expert covering blue/green, canary, rolling, and recreate patterns across Kubernetes, AWS ECS, GCP, and Azure. Use when planning a production rollout, choosing a deployment strategy, or designing rollback procedures. Trigger with \"deployment strategy\", \"zero-downtime deploy\". Subagent · jeremylongshore/tons-of-skills-marketplace