Find Skills
Discover available skills in the builtin library by keyword.
Install
one command, takes just this skill from the repositorynpx skills add https://github.com/HezaoHezao/poirot --skill find-skillsWhat it tells the agent to use
found in the instruction textThe instruction itself
13 sections, as written by the authorFind Skills
This skill helps you discover skills available in Poirot's builtin library
and install user-contributed skills.
When to Use (PROACTIVE — call before starting work)
Call this skill OR the skill_search tool when:
- User asks for ANY specialized task (not just "find a skill")
- You're about to start coding/research and haven't checked for relevant skills
- Keywords in user message match skill categories: frontend/chart/diagram/github/debug/tdd/...
PROACTIVE CHECK (before starting work)
- Identify task keywords (frontend, chart, github, debug, tdd, ...)
- Call
skill_search("<keywords>") - If matches found → read the SKILL.md → follow its workflow
- If no matches → proceed with general capabilities
Common keywords → skill categories
| Keyword | Likely skill |
|---|---|
| frontend / UI / React / Vue | frontend-design |
| chart / graph / visualization | chart-visualization |
| diagram / architecture | architecture-diagram |
| github / PR / code review | github-code-review / github-pr-workflow |
| debug / bug | systematic-debugging / python-debugpy |
| test / TDD | test-driven-development |
| plan / spike | plan / spike |
| simplify / refactor | simplify-code |
Legacy When to Use (still valid)
Use this skill when the user:
- Asks "how do I do X" where X might be a common task with an existing skill
- Says "find a skill for X" or "is there a skill for X"
- Asks "can you do X" where X is a specialized capability
- Wants to search for tools, templates, or workflows
- Mentions they wish they had help with a specific domain
Builtin skill library
Poirot ships a builtin library at:
poirot/backend/agents/skill/builtin_skills/
├── core/ # meta-skills, loaded at agent startup
├── research/ # research & intelligence skills
├── software-development/ # coding & GitHub skills
├── creative/ # visualization & design skills
└── productivity/ # docs & office skills
Only core/ skills are auto-loaded at startup (registered as active). Skills
under other categories are searchable but not auto-injected — use the
skill_search tool or /skill search <query> command to find and load them
on demand.
How to find a skill
Step 1: List categories
list_dir("poirot/backend/agents/skill/builtin_skills/")
Step 2: Search by keyword
Use bash with grep to find skills whose name or description matches:
bash("grep -rl '<keyword>' poirot/backend/agents/skill/builtin_skills/ --include='SKILL.md'")
Or read a category directory and inspect each SKILL.md frontmatter:
list_dir("poirot/backend/agents/skill/builtin_skills/research/")
Then read a candidate:
read_file("poirot/backend/agents/skill/builtin_skills/research/deep-research/SKILL.md")
Step 3: Activate a non-core skill
Non-core skills are not auto-loaded. To use one this turn:
- Read its
SKILL.mdcontent - Follow its guidance for the current task
- (Future:
/skill search <query>will surface + inject matched skills
automatically once the search tool is wired)
To permanently install a user skill from an external path:
/skill install <path> [name]
This copies it into skills/ (user skill storage, gitignored) and re-discovers.
Presenting options to the user
When you find relevant skills, present them with:
- The skill name and what it does (from
descriptionfrontmatter) - The category it lives in
- Whether it needs explicit activation
Example:
I found a skill that might help. "deep-research" (research category) guides
multi-step web research with evidence cross-verification. It's not auto-loaded
— I'll follow its guidance for this task. Want me to proceed?
When no skills are found
If no builtin skill matches:
- Acknowledge that no existing skill was found
- Offer to help with the task directly using general capabilities
- Suggest the user could create a new skill with
/skill installor by
authoring skills/<name>/SKILL.md (see the skill-creator skill)
Common categories
| Category | Example keywords |
| -------------------- | ----------------------------------------- |
| research | arxiv, deep-research, literature, osint |
| software-development | debug, github, pr, codebase, subagent |
| creative | chart, diagram, frontend, visualization |
| productivity | docs, ppt, documentation |
| core | plan, debugging, tdd, review, skill |
Other skills for the same job
different authors, same section of the catalogue
Comprehensive web quality audit covering performance, accessibility, SEO, and best practices in a single review. Use when asked to "audit my site", "review web quality", "run lighthouse audit", "check page quality", or "optimize my website" across multiple areas at once. Orchestrates specialized skills for depth. Do NOT use for single-area audits — prefer core-web-vitals, web-accessibility, seo, or web-best-practices for focused work.
| Use when launching a new product end-to-end from market research through post-launch monitoring. Orchestrates 15+ specialist agents across 5 phases in a 10-week coordinated workflow including research, development, marketing, sales preparation, launch execution, and ongoing optimization. Employs hierarchical coordination with parallel execution for efficiency and comprehensive coverage.
Analyze Copilot session history for standup reports, usage tips, session search, and session reindexing. Use when the user asks for a standup, daily summary, usage tips, workflow recommendations, wants to search or find past sessions by keyword/file/PR, wants to reindex their session store, or asks about deleting session data.
| Create visually strong landing pages, websites, and app UIs with restrained composition. OpenAI's production frontend playbook.
Pre-build product and feature risk review for founders, product managers, and AI-assisted builders. Use this skill when the user is about to build a landing page, MVP, SaaS product, internal tool, agent workflow, or major feature and needs to check demand, positioning, monetization, retention, trust, distribution, and adoption risk before implementation starts.
This skill helps users extract structured best-selling product data from Amazon via the BrowserAct API. Agent should proactively apply this skill when users express needs like search for best selling products on Amazon, extract Amazon product data based on keywords, find top rated Amazon products, monitor Amazon competitor prices and sales, discover trending products on Amazon marketplace, extract Amazon product titles prices and ratings, gather Amazon product sales volume for market research, search Amazon best sellers in specific region, collect Amazon product reviews and promotion details, analyze Amazon product availability and badges, get Amazon product data for market analysis.
This skill is designed to help users automatically extract product data from Amazon search results. The Agent should proactively apply this skill when users request searching for products related to keywords, finding best-selling items from specific brands, monitoring product prices and availability on Amazon, extracting product listings for market research, collecting product ratings and review counts for competitive analysis, finding specific products with a maximum count, searching Amazon in different languages for localized results, tracking monthly sales estimates for brand products, gathering product URLs and titles for a product catalog, scanning Amazon for Best Seller tags in a specific category, monitoring shipping and delivery information for brand items, building a structured dataset of Amazon search results.
This skill is designed to help users automatically extract reviews from Google Maps via the Google Maps Reviews API. Agent should proactively apply this skill when users request to find reviews for local businesses (e.g., coffee shops, clinics), monitor customer feedback for a specific brand or location, analyze sentiment of reviews for competitors, extract reviews for a chain of stores or services, track reputation of a local restaurant, gather user testimonials for a specific venue, conduct market research on service quality of local businesses, monitor reviews for a new retail location, collect feedback on public attractions or parks, identify common complaints for a specific service provider, research the best-rated places in a city, analyze recurring themes in reviews for a specific industry.
How to use it
Take hezaohezao/find-skills from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.