before-file-search

Redirect exploratory file searches to the codebase-locator agent before using grep or glob.

10|2|Updated Dec 23, 2025
One-click install
npx skills add https://github.com/eveld/claude --skill before-file-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: before-file-search
Source: https://github.com/eveld/claude/tree/main/skills/before-file-search
Command: npx skills add https://github.com/eveld/claude --skill before-file-search

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The skill enforces a disciplined search workflow by prioritizing the codebase-locator agent over basic grep/glob tools.

Core Features & Use Cases

  • Guided search: Redirects file-discovery tasks to the codebase-locator agent to improve accuracy and efficiency.
  • Safe tooling doctrine: Reduces reliance on potentially noisy or risky shell searches in large repositories.
  • Use Case: When locating authentication modules, configuration files, or implementation files, follow the codebase-locator-first approach.

Quick Start

Always perform file searches with the codebase-locator first before running any grep or glob commands.

Frequently Asked Questions about before-file-search

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

FAQPage Schema
How do I locate implementation files in a large repository without noisy grep results?

To locate implementation files accurately, redirect exploratory file searches to the codebase-locator agent instead of using basic grep or glob commands. This enforces a disciplined search workflow by validating results and avoiding irrelevant matches across large codebases.

What is the best way to find authentication modules and configuration files in a codebase?

The best way to find authentication modules and configuration files is using a codebase-locator-first approach. This guided search method improves accuracy and efficiency over basic shell searches by validating results to ensure relevant matches.

Why should I use the codebase-locator agent instead of glob for file discovery?

You should use the codebase-locator agent instead of glob for file discovery to reduce reliance on potentially noisy shell searches in large repositories. This safe tooling doctrine enforces search discipline and validates results to avoid irrelevant matches.

When do I need to use a codebase-locator for repository searches?

You need to use a codebase-locator for repository searches when performing exploratory file discovery tasks such as locating authentication modules, configuration files, and implementation files. Always perform file searches with the codebase-locator first before running any grep or glob commands.

Can I still run grep commands if the codebase-locator finds the files I need?

Yes, but always perform file searches with the codebase-locator first before running any grep or glob commands. The workflow enforces search discipline by validating results from the codebase-locator agent to avoid irrelevant matches before proceeding.