grepai-search-boosting

Configures path-based score boosting to rank GrepAI semantic search results.

Updated May 12, 2026
One-click install
npx skills add https://github.com/eduardtomasek/codex-dev-stack --skill grepai-search-boosting-eduardtomasek
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grepai-search-boosting
Source: https://github.com/eduardtomasek/codex-dev-stack/tree/main/skills/.agents/grepai-search-boosting
Command: npx skills add https://github.com/eduardtomasek/codex-dev-stack --skill grepai-search-boosting-eduardtomasek

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Semantic code search often ranks test files, vendor code, and generated artifacts above the production source code you actually want. This Skill configures GrepAI's score boosting so relevant paths rank higher and noise ranks lower. ## Core Features & Use Cases - Penalty Configuration: Apply score reduction factors to tests, docs, vendor directories, and generated code so they rank lower without being excluded. - Bonus Configuration: Increase scores for core source directories like /src/, /lib/, /internal/, and /core/ to surface business logic first. - Ready-Made Templates: Provides tuned configurations for standard, frontend, Go, Python, and monorepo project layouts. - Use Case: A Go developer searching for "authentication" keeps getting auth_test.go results first; applying a 0.5 penalty to _test.go and a 1.1 bonus to /internal/ pushes middleware.go to the top. ## Quick Start Configure GrepAI search boosting in my project to penalize test files and vendor code while boosting the src directory.

Frequently Asked Questions about grepai-search-boosting

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

FAQPage Schema
How do I configure search result boosting in GrepAI?▼

Add a search.boost section to .grepai/config.yaml with enabled set to true, then define penalties with factors below 1.0 and bonuses with factors above 1.0. Each entry pairs a path pattern like /tests/ with a numeric factor that multiplies the original search score.

How do I stop test files from ranking first in semantic code search?▼

Add penalty patterns matching your test naming conventions, such as /tests/, _test., .spec., or .test., with a factor around 0.5. This halves their scores so production code with similar content ranks above them while tests remain searchable.

What is the difference between ignoring and penalizing files in GrepAI?▼

Ignoring completely excludes files from the index, while penalizing keeps them searchable at a lower rank. Use ignore for files you never want like node_modules, and penalties for files you rarely need like tests and documentation.

Why is my GrepAI boost pattern not matching any files?▼

Patterns match against the full file path, so /tests/ matches src/tests/auth.go but not tests.go. Check that your pattern string actually appears in the complete path, including leading and trailing slashes where appropriate.

Can GrepAI search scores go above 1.0 with boosting?▼

Yes, bonus factors above 1.0 can push final scores past 1.0, and this is expected behavior. The score is a relative ranking signal, so only the ordering of results matters, not the absolute value.