Search Skill Authoring

What problem does it solve?

Search skill authors often lose focus on discovery, evidence, and output format when answering repository questions, and this guide anchors them in an evidence-first mode that avoids premature implementation recommendations.

Core Features & Use Cases

• Focus statement: Start by naming the discovery goal so the AI knows whether to trace implementations, summarize documentation, or map relationships.
• Search surfaces & strategy: Prioritize repository files, docs, and logs, expand keywords with synonyms, and use decision trees to keep the order consistent and relevant.
• Evidence handling & output contract: Require short, sourced excerpts, rank results by authority, define JSON or table contracts, and stop when the contract is satisfied to prevent endless searching.
• Use case: When asked how a feature handles authentication, the skill quickly maps configs, docs, and handlers, ranks each source type, and emits a structured summary of paths, relevance, and excerpts.

Quick Start

Ask this guide to map the most relevant docs and code paths for your question by naming the focus, search surfaces, query strategy, evidence handling rules, and desired output format.