search-first
Research-before-coding workflow. Search for existing tools, libraries, and patterns before writing custom code. Invokes the researcher agent.
Security Assessment
About search-first
The `search-first` skill streamlines the workflow of researching existing solutions before writing custom code. It addresses the common problem of developers reinventing the wheel by ensuring that known libraries, tools, and patterns are evaluated before new implementations are created. By systematizing the search and evaluation process, this skill helps maintain code quality, reduces development time, and ensures that solutions are aligned with best practices and community standards.
This skill offers a structured five-step workflow: need analysis, parallel search, evaluation, decision-making, and implementation. It leverages a researcher agent to perform searches across npm, PyPI, GitHub, and internal MCP/skill repositories. The skill includes a decision matrix to guide whether to adopt, extend, compose, or build custom solutions based on factors such as functionality, maintenance, documentation, community support, and licensing. Users can employ a quick mental checklist for common scenarios or invoke a full agent mode for more complex requirements, producing structured comparisons and recommendations. It also provides category-specific search shortcuts for development tooling, AI/LLM integration, data and APIs, and content processing.
Typical use cases include starting new features with potential existing solutions, adding dependencies or integrations, or creating new utilities and helpers. The target users are developers, technical leads, and software engineers who want to ensure efficient and informed coding practices. Additionally, integration with planner agents allows for informed architecture planning by incorporating available tools early in the development process, avoiding redundant implementations and improving project efficiency.
FAQ
How do I use the search-first skill before writing custom code?
You can use the quick mode to mentally check if a solution exists in the repository, npm/PyPI, MCP servers, or GitHub. For non-trivial features, launch the researcher agent to perform a structured search and get recommendations.
Which platforms or repositories does this skill search?
It searches across npm for JavaScript/Node packages, PyPI for Python packages, GitHub for open-source implementations, and internal MCP/Claude Code skill repositories.
Can this skill integrate with other agents?
Yes, it integrates with the planner agent to provide tool recommendations during architecture review and planning phases, ensuring implementations are informed by existing solutions.
Are there limitations or prerequisites for using this skill?
Users should have access to the relevant package repositories and MCP/skill directories. The skill does not generate code on its own; it provides guidance for evaluating and adopting existing solutions.
What languages and frameworks are supported?
The skill is language-agnostic but commonly used with JavaScript/TypeScript and Python. Searches consider language and framework constraints provided by the user.
Install search-first
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
affaan-m/everything-claude-code