rawq — Agent Usage Guide

Return ranked code chunks with file paths, scope labels, and confidence percentages.

52|10|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/auyelbekov/rawq --skill rawq-agent-usage-guide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rawq — Agent Usage Guide
Source: https://github.com/auyelbekov/rawq/tree/main
Command: npx skills add https://github.com/auyelbekov/rawq --skill rawq-agent-usage-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This guide teaches agents to avoid reading entire codebases by letting rawq surface the most relevant code chunks with metadata, so they stop wasting tokens on irrelevant files.

Core Features & Use Cases

  • Hybrid semantic + lexical search to fuse embeddings with BM25 and adaptively weight queries for conceptual and identifier-driven intent.
  • Contextual filtering and controls for languages, exclusion globs, reranking, token budgets, and daemon-backed embedding models tailored to agent workflows.
  • Operational command recipes covering rawq map, search, diff, and the daemon, plus JSON/stream outputs for integration with agent pipelines.

Quick Start

Tell the agent to run rawq search "how does authentication failure handling work" ./testdata to receive ranked code snippets with file scopes and confidence scores.

Frequently Asked Questions about rawq — Agent Usage Guide

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

FAQPage Schema
How do I search an unfamiliar codebase without reading entire repository files?

Hybrid semantic and BM25 code search returns ranked code chunks with file paths, scope labels, and confidence percentages for descriptive queries. This avoids reading entire repositories by surfacing only the most relevant snippets to save tokens.

What is hybrid semantic and lexical code search and when do I need it?

Hybrid semantic and lexical code search fuses embedding-based retrieval with BM25 ranking to adaptively weight queries for both conceptual intent and identifier-driven lookups. It is needed when exploring unfamiliar repositories without preidentifying relevant files.

Can I filter code search results by programming language and exclude specific file patterns?

Code search supports contextual filtering through language filters and exclusion globs. You can restrict retrieval to specific programming languages and exclude unwanted file patterns to ensure results match your agent workflow and token budget requirements.

How do I search for code changes within a specific git diff?

Diff-restricted queries allow you to search for code changes within a specific git diff. The tool applies hybrid semantic and BM25 retrieval directly to the diff output, returning ranked code chunks scoped to only the modified portions of the repository.

Does the code search daemon support caching for repeated agent queries?

The daemon supports caching for repeated agent queries using daemon-backed embedding models. It maintains an indexed context map of the repository, enabling faster subsequent searches and structured JSON or NDJSON streaming outputs for pipeline integration.

What are the limitations of using confidence scoring for code retrieval?

Confidence scoring in code retrieval provides percentage-based relevance rankings for returned chunks, but relies on adaptive hybrid weighting. If queries lack descriptive intent or target highly fragmented code, confidence percentages may not accurately reflect contextual relevance.