rewriting

Rewrite ambiguous queries by clarifying terms and expanding abbreviations.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/edangx100/adaptive_rag --skill rewriting
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rewriting
Source: https://github.com/edangx100/adaptive_rag/tree/main/.claude/skills/rewriting
Command: npx skills add https://github.com/edangx100/adaptive_rag --skill rewriting

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the frustration of failed searches by automatically improving unclear or incomplete queries for better results.

Core Features & Use Cases

  • Query Enhancement: Expands abbreviations, clarifies vague terms, and adds context.
  • Adaptive Retry: Automatically rewrites queries when no relevant documents are found.
  • Use Case: When a user asks "won't work," this Skill automatically transforms it into "troubleshooting device not functioning properly."

Quick Start

Rewrite the query "fast computer" to improve search results.

Frequently Asked Questions about rewriting

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I improve search results when queries return no relevant documents?

Query rewriting automatically enhances vague or incomplete searches by clarifying terms, expanding abbreviations, and adding context. When a search fails to find relevant documents, the Skill rewrites the query to improve retrieval performance and surface better results.

What's the best way to transform ambiguous user questions into precise search queries?

This Skill rewrites ambiguous queries by incorporating synonyms, expanding context, and clarifying vague terminology. For example, 'won't work' becomes 'troubleshooting device not functioning properly,' enabling search systems to locate relevant documents.

When should I use query rewriting in a RAG pipeline?

Query rewriting works as an adaptive retry mechanism when initial searches fail to find relevant documents. It's invoked automatically when no relevant results are found, improving query clarity without requiring manual intervention or additional user input.

Does query rewriting work with retrieval-augmented generation systems?

Yes. Query rewriting integrates into RAG pipelines as a retry strategy, enhancing search performance when document retrieval fails. It clarifies queries to increase the likelihood of finding relevant documents for generation tasks.

Can query rewriting handle abbreviations and technical jargon?

Yes. The Skill expands abbreviations, clarifies vague terms, and adds context to technical or informal queries. This makes it effective for searches containing domain-specific language, acronyms, or colloquial phrasing that standard retrieval might miss.