Agent Skill Search
Portable skill catalog search for AI agents. MCP server + CLI.
Skills folders eat your agent's context window — every SKILL.md loads whether the task needs it or not. Move them into a catalog and the agent fetches a skill only when it's relevant. Use grep-like search terms to find the right one for your task.
Install
# recommended — isolated tool install
uv tool install agent-skill-search
# or
pip install agent-skill-search
The PyPI distribution is
agent-skill-search— the nameskill-searchon PyPI belongs to an unrelated package. The commands stayskill-searchandskill-search-mcp.
Usage
CLI
export SKILL_CATALOG_DIRS="$HOME/.hermes/skills"
skill-search search "react performance"
skill-search view "vercel-react-best-practices"
skill-search list
# Also scan well-known agent skills dirs (opencode, claude, codex, ...).
# Same-named skills are deduplicated; off by default.
skill-search --include-known list # or SKILL_INCLUDE_KNOWN=1
# Move skills from a source dir into the catalog (frees agent context).
# Note: `add` MOVES directories out of the source tree, it does not copy.
skill-search add ~/.hermes/skills
MCP server
One command installs it into your client:
skill-search install claude-code # or codex / gemini / openclaw / hermes / pi / claude-desktop / chatgpt
See INSTALL.md for per-client details, manual config snippets, the ChatGPT remote-HTTP setup, and troubleshooting.
Agents without an MCP connection can use the CLI directly. Opt in to append a
short usage snippet to existing CLAUDE.md/AGENTS.md files (marker-checked,
append-only, never created from scratch):
skill-search install gemini --cli-hint
License
MIT — see LICENSE.
1 maintainer
Release files for agent-skill-search 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| agent_skill_search-0.1.1.tar.gz | 23.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| agent_skill_search-0.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 42.1 kB
Release files / agent_skill_search-0.1.1.tar.gz
| Download URL | agent_skill_search-0.1.1.tar.gz |
|---|---|
| Size | 23.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1c910d701aa9e0e9c08818d20a20217e5173fca580c23def73719e0b9abb598f
|
|
BLAKE2b-256 checksum How to use checksums |
5df7761a3faa87f12181817227f00357dcad3655e57a32b3fcee96fa74891897
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.13 {"installer":{"name":"uv","version":"0.12.13","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / agent_skill_search-0.1.1-py3-none-any.whl
| Download URL | agent_skill_search-0.1.1-py3-none-any.whl |
|---|---|
| Size | 18.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e56359b8ed6a1c08d5ca3cb214aefab4ad3d88c1b38e2a9c60d83ea03cc341fa
|
|
BLAKE2b-256 checksum How to use checksums |
fbe9cb9f9c9bb3027a0e2362a18f5e30dc6c2329d82b6915ed946ffd9a7f100f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.13 {"installer":{"name":"uv","version":"0.12.13","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
