find-awesome-tools

Find Awesome Tools

Curated discovery of tools, libraries, frameworks, and resources across thousands of community-maintained awesome-lists. Reach for this skill when the user is deciding what to use in a technology space — not when they already have a specific library in hand and need its API or configuration.

When to Use This Skill

Activate this skill when the user:

• Asks "what are good X for Y" or "recommend X"
• Wants a comparison of options in a category
• Explores an unfamiliar space and needs to see what exists
• Mentions "awesome list", "curated list", or names a broad category

Do not use this skill when the user already knows the library and needs docs, configuration help, or debugging for it — that belongs to a documentation skill.

Workflow

Three tools mirror one concept: find sections, search items, fetch items from a list. Pick the path based on the user's intent.

User intent	Path
"What exists in category X?"	find_awesome_section → get_awesome_items
"Find me a keyword or concept"	search_awesome_items (one-shot)
"Give me everything from list Y"	get_awesome_items directly (when repo/listId is known)

MCP callers invoke the tools directly. CLI callers use the matching subcommand: sections, search, items. Both transports hit the same backend.

Tools

find_awesome_section / context-awesome sections

Discovers sections (categories) matching a query across every indexed awesome-list. Call this before get_awesome_items unless you already know the githubRepo or listId.

Inputs:

• query (required) — search terms
• confidence (optional, default 0.3) — minimum match confidence, 0–1
• limit (optional, default 10) — maximum sections returned

MCP:

{ "query": "graph databases", "limit": 5 }