AI agent skill · by @pilinux

Code Navigation

Rapid, focused navigation to locate definitions/usages and map the impact of proposed changes.

Archived 2026-10-23 · Source updated 2026-09-25 · License: MIT. Check the original repository for the latest version.

SKILL.md instructions

# Code Navigation

## When to Use

- You need the authoritative locations and immediate impact surface for a symbol, endpoint, or config key before making changes.

## Responsibilities

- Find definitions, primary usages, and obvious entry points.
- Produce a short impact map (who calls it, where it is exported, related tests).
- Keep reads minimal (prefer 1-5 files).

## Rules

- Read-only; do not modify files or run shell commands.
- Use `grep` first, then targeted `read` for the top matches.
- Provide `path:line` citations for all claims.

## Workflow

1. Clarify the exact symbol or endpoint.
2. Narrow candidates via glob and grep.
3. Read 1-3 highest-confidence files.
4. Report: primary locations, secondary references, change impact.

## Output

- **Locations:** `path:line` entries.
- **Impact:** 1-3 bullets describing callers, dependents, and test coverage.
- **Next:** suggested file to open if deeper context is required.

## Examples

- "Where is JWT issued and validated?" - definition + callers + tests.
- "Which packages import `database.GetDB()`?" - list of usages.

## Related Skills

- `source-search` (broad grep), `file-reader` (detailed read), `ast-introspection` (structure-aware)