Skip to main content
skill CX Codex

codebase-search — Claude Code skill: repo navigation before edits

A skill that turns "where does this live" requests into one search packet and returns an evidence map before you edit.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add akillness/jeo-skills --skill codebase-search -a claude-code
Open on GitHub

What codebase-search does

The skill acts as a packet router, not a search tutorial. It normalizes your request into one primary packet: exact text, symbols and indexes, code structure, config and content, hosted search, or graph path tracing. Then it narrows scope and reads only the winning files.

Inside is a step-by-step flow: normalize the request, pick the packet, narrow by directory or file type, read definitions and consumers, and answer with an evidence map of paths and lines. It also knows when to hand off. Once the area is found and you need diagnosis, it routes to debugging or log-analysis; for a migration plan it points to code-refactoring.

You need access to Read, Grep, Glob and Bash. Structural search relies on tools like ast-grep or Semgrep, and symbol lookup needs an LSP or an indexed search. On a small repo you already know by heart, the skill just adds steps.

What it helps with

  • find where a function is defined and who calls it
  • separate authored files from vendor and generated folders
  • identify which files own config and template surfaces
  • size up the impact surface before a change
  • hand off from search to bug diagnosis without losing context

Example prompts for the agent

  • find where this handler is defined and who calls it
  • which files own the config and templates in this repo
  • what should I inspect before changing this schema

How to install codebase-search

1Skills CLI (Vercel)

npx skills add akillness/jeo-skills --skill codebase-search -a claude-code

2Manually: put the files in place

~/.claude/skills/codebase-search/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/codebase-search/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about codebase-search

How do I install codebase-search in Claude?

Run npx skills add akillness/jeo-skills --skill codebase-search -a claude-code. The skill lands at ~/.claude/skills/codebase-search/SKILL.md.

What does codebase-search do?

It turns a repo-navigation request into one search packet, narrows the scope, and returns an evidence map with paths and lines before you start editing.

Which tools does the skill use?

It needs Read, Grep, Glob and Bash. Structural search leans on ast-grep, Semgrep or Comby, while symbol lookup uses an LSP or indexed search.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set22

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor