find-agents
Skill15 starsChanged 8 months agoApache-2.0View on GitHub
Find, install, and manage AI agents across 43+ coding IDEs. Search the agentshq registry, install agents from GitHub repos or URLs, list/remove/update installed agents. Invoke via /find-agents or when user says "find an agent", "install agent", "search agents", "list agents", "remove agent", "update agents".
- Reads credentials
In this repository63 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- agent-browserSkill
- ast-grepSkill
- branch-review-before-prSkill
- browse-qaSkill
- browser-useSkill
- browseSkill
- bugfixSkill
- build-dmgSkill
- claude-reviewSkill
- codemapSkill
- code-simplifySkill
- codex-reviewSkill
- commitSkill
- cost-estimateSkill
- create-prSkill
- find-bugsSkill
- frontend-design-ui-uxSkill
- git-merge-expertSkill
- git-merge-expert-worktreeSkill
- kiro-reviewSkill
- laravel-filamentSkill
- laravelSkill
- lokeiSkill
- map-project-monorepoSkill
- map-projectSkill
- nextjsSkill
- plan-founder-reviewSkill
- plan-to-task-list-with-dagSkill
- pr-retroSkill
- run-parallel-agents-feature-buildSkill
- run-parallel-agents-feature-debugSkill
- rustSkill
- secretsSkill
- startSkill
- update-agent-learningsSkill
- update-claude-learningsSkill
- update-claude-settingsSkill
- update-skill-learningsSkill
- ast-grepSkill
- branch-review-before-prSkill
- codemapSkill
- code-simplifySkill
- commitSkill
- cost-estimateSkill
- create-prSkill
- find-bugsSkill
- frontend-design-ui-uxSkill
- git-merge-expertSkill
- git-merge-expert-worktreeSkill
- map-project-monorepoSkill
- map-projectSkill
- plan-founder-reviewSkill
- plan-to-task-list-with-dagSkill
- pr-retroSkill
- run-parallel-agents-feature-buildSkill
- run-parallel-agents-feature-debugSkill
- startSkill
- update-agent-learningsSkill
- The first 60 shown.
The file
Show its rules and text
We split this skill into the rules it gives an agent
13 rules. About 0 are common, 8 are distinctive, and 5 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈8
Distinctive · estimate
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 42
When the user asks to find agents, run the search and present results.
- Very specific: line 128
Run npx agentshq find <query> with the user's keywords
- Distinctive: line 130
Ask which agent(s) to install
- Distinctive: line 131
Run the install command with appropriate flags
- Very specific: line 135
Run npx agentshq add <source> with the appropriate source
- Distinctive: line 136
If the user doesn't specify IDEs, the CLI will auto-detect installed IDEs and prompt
- Distinctive: line 138
After install, confirm what was installed and where
- Distinctive: line 142
Ask what kind of task they're working on (React, Laravel, testing, DevOps, etc.)
- Very specific: line 143
Search with relevant keywords: npx agentshq find <keyword>
- Very specific: line 153
If npx agentshq fails, check if Node.js >= 18 is available
- Distinctive: line 154
If a git clone fails, check network connectivity and repo access
- Distinctive: line 155
If no agents are found in a repo, suggest checking the repo has AGENT.md files
- Very specific: line 156
If IDE detection finds nothing, suggest --ide <name> to specify manually
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Find Agents
Full CLI wrapper for agentshq -- the package manager for AI coding agents.
When to Use
Activate this skill when the user:
- Wants to find or search for agents ("find me a React agent", "search for testing agents")
- Wants to install agents ("install the laravel expert agent", "add agents from owner/repo")
- Wants to manage agents ("list my agents", "remove web-design", "update all agents", "check for updates")
- Mentions agentshq, agent definitions, or AGENT.md files
- Asks what agents are available or installed
Prerequisites
The agentshq CLI must be available. If it's not installed globally, use npx agentshq to run commands on-the-fly (no install needed).
Check availability:
npx agentshq --versionCommands Reference
Search for agents
# Interactive search (opens fzf-style picker)
npx agentshq find
# Search by keyword
npx agentshq find <query>When the user asks to find agents, run the search and present results. If they pick one, install it.
Install agents
# From a GitHub repo (discovers all agents in the repo)
npx agentshq add <owner>/<repo>
# Install a specific agent from a repo
npx agentshq add <owner>/<repo>@<agent-name>
# From any git URL
npx agentshq add https://github.com/owner/repo
# From a local directory
npx agentshq add ./path/to/agents
# Install globally (user-level, available in all projects)
npx agentshq add <source> -g
# Install to specific IDEs
npx agentshq add <source> --ide claude-code cursor windsurf
# Install all agents to all IDEs without prompts
npx agentshq add <source> --all
# List available agents in a repo without installing
npx agentshq add <source> --listList installed agents
# List project-level agents
npx agentshq list
# List global agents
npx agentshq list -g
# Filter by IDE
npx agentshq list --ide claude-code
# Machine-readable output
npx agentshq list --jsonRemove agents
# Interactive removal (shows picker)
npx agentshq remove
# Remove specific agent
npx agentshq remove <agent-name>
# Remove from global scope
npx agentshq remove <agent-name> -g
# Remove all agents
npx agentshq remove --allCheck for updates
# Check which agents have updates available
npx agentshq check
# Update all agents to latest versions
npx agentshq updateCreate a new agent
# Scaffold a new AGENT.md
npx agentshq init <name>
# Create in current directory
npx agentshq initBehavior Guidelines
When searching for agents
- Run
npx agentshq find <query>with the user's keywords - Present the results clearly -- name, description, source
- Ask which agent(s) to install
- Run the install command with appropriate flags
When installing agents
- Run
npx agentshq add <source>with the appropriate source - If the user doesn't specify IDEs, the CLI will auto-detect installed IDEs and prompt
- For non-interactive installs (CI, scripts), suggest
-yor--allflags - After install, confirm what was installed and where
When the user is unsure what they need
- Ask what kind of task they're working on (React, Laravel, testing, DevOps, etc.)
- Search with relevant keywords:
npx agentshq find <keyword> - Recommend agents based on the results
- Offer to install their picks
Private repos
The CLI works with private repos using the same syntax. Privacy is automatic -- no telemetry or audit data is sent for private repos. The user just needs git access (SSH keys or GITHUB_TOKEN).
Error handling
- If
npx agentshqfails, check if Node.js >= 18 is available - If a git clone fails, check network connectivity and repo access
- If no agents are found in a repo, suggest checking the repo has AGENT.md files
- If IDE detection finds nothing, suggest
--ide <name>to specify manually
Supported IDEs
The CLI supports 43+ IDEs. The most common ones:
| IDE | Format |
| Claude Code | .md with YAML frontmatter |
| Cursor | AGENTS.md sections |
| GitHub Copilot | .agent.md |
| Windsurf | AGENTS.md sections |
| Codex | AGENTS.md sections |
| Gemini CLI | .md with YAML frontmatter |
| Kiro | .json |
| Amp | AGENTS.md sections |
| Roo Code | AGENTS.md sections |
Agents are automatically translated to each IDE's native format on install.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

