filter-building

Translate natural language scopes into typed search filters for TeaRAGs MCP server.

11|3|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/artk0de/TeaRAGs-MCP --skill filter-building
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: filter-building
Source: https://github.com/artk0de/TeaRAGs-MCP/tree/main/.claude-plugin/tea-rags/skills/filter-building
Command: npx skills add https://github.com/artk0de/TeaRAGs-MCP --skill filter-building

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the issue of imprecise code search results by translating natural language intent into structured, typed filters that exclude noise and surface relevant, stable, or specific code segments.

Core Features & Use Cases

  • Intent-to-Filter Translation: Converts vague user requests like "Alice's recent Ruby work" into precise typed parameters like author, modifiedAfter, and language.
  • Granular Scoping: Allows filtering by file-level metadata (age, commit count) or chunk-level signals (test status, symbol ID) to ensure the agent learns from battle-tested code rather than hotspots.
  • Use Case: When an agent is tasked with fixing a bug in a specific domain, use this skill to filter out test files, vendor directories, and legacy code, ensuring the agent only references stable production implementations.

Quick Start

Invoke the filter-building skill to translate the user request for recent production code in the AuthService domain into the required typed filter parameters.

Frequently Asked Questions about filter-building

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

FAQPage Schema
How do I convert natural language search intent into typed filters for code search?

To convert natural language intent into typed filters for code search, this skill maps vague requests into precise typed parameters like author, modifiedAfter, and language to refine semantic retrieval results.

How does intent-aware filtering improve RAG search results in coding agent workflows?

Intent-aware filtering improves RAG search results by excluding noise from vendor directories, test files, and legacy code, ensuring the coding agent only references stable production implementations during bug fixes or domain-specific tasks.

Can I filter code search results by git history metadata like author and commit count?

Yes, you can filter code search results by git history metadata. The skill applies git-based metadata filters, allowing you to scope retrieval by specific authors, modifiedAfter dates, and commit counts to surface battle-tested code segments.

What is the best way to scope code retrieval to exclude test files and legacy directories?

The best way to scope code retrieval and exclude test files or legacy directories is by combining file-level metadata filters, such as age and commit count, with chunk-level signals like test status and path patterns to isolate stable production code.

Does the TeaRAGs MCP server support granular scoping for domain-specific code retrieval?

Yes, the TeaRAGs MCP server supports granular scoping for domain-specific code retrieval. It accepts structured typed filters combining path patterns, git-based metadata, and codegraph signals to restrict search results to relevant code segments.

Why are my semantic code search results returning unstable or irrelevant code hotspots?

Semantic code search results return unstable hotspots because they lack granular filtering. Applying typed filters for chunk-level signals like test status and symbol ID helps exclude noisy hotspots in favor of stable, specific code segments.