{
  "markdown": "# Agent Discovery\n\n**Discover, browse, and install AI agents from curated catalogs — in Claude Code and GitHub Copilot.**\n\n[![npm](https://img.shields.io/badge/npm-v0.2.0-blue)](https://www.npmjs.com/package/agent-discovery) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE) [![GitHub stars](https://img.shields.io/github/stars/svmnikhil/agent-discovery?style=flat&color=yellow)](https://github.com/svmnikhil/agent-discovery/stargazers) [![Anthropic Marketplace](https://img.shields.io/badge/Anthropic%20Marketplace-Accepted-blueviolet)](https://github.com/svmnikhil/agent-discovery)\n\n> **Accepted into Anthropic's official Claude Code plugin marketplace** — proving real developer demand for AI agent discovery tooling.\n\n## The Problem\n\nDevelopers spend hours searching for the right AI agent configurations. The awesome-copilot catalog has 390+ entries, but finding the right one means browsing GitHub repos, reading docs, and manually copying files. And once you find the right agents — there's no way to share that setup with your team.\n\nAgent Discovery solves both problems:\n\n1. **Instant Search** — BM25-ranked search over 390+ agents, skills, and instructions from awesome-copilot and GitHub's Agent Factory. No runtime fetching, no API keys.\n2. **One-Command Install** — Download agents directly to `.claude/agents/`, skills to `.claude/skills/`, instructions to `.github/instructions/`.\n3. **Team Portability via APM** — Generate an `apm.yml` manifest so every developer who clones your repo gets the same agent setup with `apm install`.\n\n---\n\n## Install\n\n### Option 1 — GitHub Copilot Chat (VS Code)\n\nType `@agent-discovery` in the GitHub Copilot Chat panel.\n\n**Prerequisites:** VS Code 1.100+, GitHub Copilot subscription.\n\n**Install from source (dev mode):**\n\n```bash\ngit clone https://github.com/svmnikhil/agent-discovery.git\ncd agent-discovery/extensions/vscode-copilot\nnpm run prepare   # exports catalog + builds\ncode --extensionDevelopmentPath=$(pwd) /your/project\n```\n\nThen open GitHub Copilot Chat and type `@agent-discovery`.\n\n### Option 2 — Claude Code (plugin marketplace)\n\n**Prerequisites:** Claude Code v1.0.33+ (`claude --version`).\n\n```bash\n/plugin marketplace add svmnikhil/agent-discovery\n/plugin install agent-discovery\n```\n\nRestart Claude Code (or `/reload-plugins`).\n\n**Verify:**\n```\n/agent-discovery:recommend\n```\n\n<details>\n<summary>Local development install (Claude Code)</summary>\n\n```bash\ngit clone https://github.com/svmnikhil/agent-discovery.git\ncd agent-discovery\nnpm run build\nclaude --plugin-dir .\n```\n\n</details>\n\n---\n\n## Usage\n\n### GitHub Copilot Chat (`@agent-discovery`)\n\n| Command | What it does |\n|---|---|\n| `@agent-discovery <query>` | Search the catalog and return ranked results |\n| `@agent-discovery /install <name>` | Download and install an agent to your workspace |\n| `@agent-discovery /apm` | Generate an `apm.yml` manifest for your installed agents |\n\n**Examples:**\n```\n@agent-discovery code review\n@agent-discovery react frontend testing\n@agent-discovery azure deployment\n@agent-discovery /install grumpy-reviewer\n@agent-discovery /apm\n```\n\n### Claude Code (slash commands)\n\n| Slash Command | What it does |\n|---|---|\n| `/agent-discovery:recommend [query]` | Discover, review, install, or assemble agents from catalog |\n| `/agent-discovery:list` | List installed agents, skills, instructions, and teams |\n| `/agent-discovery:edit <name>` | Edit an installed entry or modify a team |\n\n---\n\n## Team Portability with APM\n\nAfter discovering and installing the agents your team needs, generate a portable manifest:\n\n```\n@agent-discovery /apm\n```\n\nThis produces an `apm.yml` like:\n\n```yaml\nname: my-project\nversion: 1.0.0\ndependencies:\n  apm:\n    - github/awesome-copilot/agents/grumpy-reviewer.agent.md\n    - github/awesome-copilot/agents/expert-react-frontend-engineer.agent.md\n```\n\nCommit it to your repo. Every developer who clones it runs `apm install` and gets the same agent setup — portable, reproducible, security-scanned.\n\n**APM is zero-install for you.** The VS Code extension downloads and caches the APM binary automatically on first use — click \"Install agents now\" in the `/apm` response and it just works, the same way the C# or Python extensions auto-install their language servers.\n\n---\n\n## Architecture\n\n```\nagent-discovery/\n├── .claude-plugin/\n│   ├── plugin.json                    # Claude Code plugin manifest\n│   └── marketplace.json               # Marketplace listing\n├── .mcp.json                          # MCP server config\n├── apm.yml                            # APM manifest for this project\n├── AGENTS.md                          # Agent instructions for AI working in this codebase\n├── extensions/\n│   └── vscode-copilot/\n│       ├── src/\n│       │   ├── extension.ts           # VS Code chat participant\n│       │   ├── catalog.ts             # BM25 search (pure JS, no WASM)\n│       │   └── catalog-data.json      # Pre-exported catalog (164KB)\n│       ├── scripts/\n│       │   └── export-catalog.mjs     # Build: catalog.db → catalog-data.json\n│       └── package.json\n├── skills/\n│   ├── recommend/SKILL.md             # Interactive discover+install flow\n│   ├── list/SKILL.md                  # List installed entries\n│   └── edit/SKILL.md                  # Edit entries/teams\n├── src/\n│   ├── mcp-server.ts                  # MCP tools (5 total)\n│   ├── catalog.ts                     # SQLite BM25 catalog reader\n│   └── types.ts                       # TypeScript interfaces\n└── catalog/\n    └── catalog.db                     # Pre-built SQLite catalog (687 entries)\n```\n\n### Catalog\n\n- **Sources:** awesome-copilot (380 entries) + GitHub gh-aw Agent Factory (12 entries)\n- **Search:** BM25-style scoring — name 10x, tags 8x, description 1.5x per hit\n- **Deduplication:** Jaccard similarity clustering across sources\n- **Zero runtime fetch:** Catalog loads instantly (SQLite in Claude Code; JSON bundle in VS Code extension)\n\n### MCP Tools (Claude Code)\n\n| Tool | Description |\n|------|-------------|\n| `search_agents` | Search catalog by query and type filter |\n| `recommend` | Get recommendations based on project context |\n| `get_agent_details` | Get full agent content |\n| `download_agent` | Download and install an entry |\n| `catalog_info` | Get catalog statistics and source info |\n\n---\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Build TypeScript (Claude Code plugin)\nnpm run build\n\n# Rebuild catalog from sources (requires GITHUB_TOKEN for gh-aw)\nnpm run build-catalog\n\n# Build VS Code extension\ncd extensions/vscode-copilot\nnpm run prepare      # export catalog JSON + compile\nnpm run build        # compile only\nnpm run package      # create .vsix\n```\n\n---\n\n## License\n\nMIT\n",
  "bytes": 6727,
  "sha": "8791d97ac5d6c1b33bf7d957ea63a9dab9a6984b18705b26b13a1b40d33bea92",
  "repo_slug": "svmnikhil/agent-discovery",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_svmnikhil_agent_discovery_agent_discover_9cecf2a7/readme"
}