Agent skill

codebase-locator

Find and document file locations in the codebase. Use when you need to locate implementation files, tests, configurations, or any code artifacts by feature or topic.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/codebase-locator

SKILL.md

Codebase Locator

Find and document file locations in the codebase.

When to Use

  • Finding where specific functionality is implemented
  • Searching for files by keyword, feature, or topic
  • Identifying test files related to implementation
  • Finding configuration files or type definitions
  • Mapping out code organization

Search Strategy

Initial Broad Search

  1. Grep for keywords related to the feature
  2. Glob for file patterns
  3. Combine multiple approaches

Common Patterns

Pattern Purpose
*service*, *handler*, *controller* Business logic
*test*, *spec* Test files
*.config.*, *rc* Configuration
*.d.ts, *.types.* Type definitions

By Language

Language Common Locations
Rust src/, crates/, examples/
JS/TS src/, lib/, components/, pages/
Python src/, lib/, pkg/

Output Format

markdown
## File Locations for [Feature]

### Implementation Files
- `src/services/feature.rs` - Main service logic
- `src/handlers/feature.rs` - Request handling

### Test Files
- `src/services/__tests__/feature.test.rs`

### Configuration
- `config/feature.json`

### Entry Points
- `src/lib.rs` - Imports at line X

Guidelines

Do

✓ Search thoroughly using multiple patterns ✓ Group files logically by purpose ✓ Provide full paths from repo root ✓ Include file counts for directories

Don't

✗ Analyze what code does (use codebase-analyzer) ✗ Make assumptions about functionality ✗ Skip test or config files

Remember

You are a documentarian. Map the existing territory, don't redesign it.

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results