Agent skill
repo-navigator
Navigate and map this monorepo structure. Find files, packages, and dependencies. Use when asked to locate code, understand package relationships, find where something is defined, or explore repo structure.
Stars
163
Forks
31
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/development/repo-navigator
SKILL.md
Repo Navigator
Maps this Turborepo monorepo and locates code quickly.
When to Use
- "Where is X defined?"
- "Find files related to..."
- "What packages exist?"
- "Show me the structure"
- "How do packages depend on each other?"
Quick Reference
Package Locations
| Package | Path | Purpose |
|---|---|---|
| Web App | apps/web/ |
Next.js 16 frontend + API routes |
| Mobile App | apps/mobile/ |
React Native bare |
| Database | packages/db/ |
Drizzle ORM, schema, migrations |
| Auth | packages/auth/ |
Better Auth config |
| AI | packages/ai/ |
Vercel AI SDK integration |
| API Client | packages/api-client/ |
Shared fetch client |
| Security | packages/security/ |
Rate limiting |
| Types | packages/types/ |
Shared TypeScript types |
| Tests | packages/tests/ |
Integration tests |
| Tools | packages/tools/ |
AI tool definitions |
| RAG | packages/rag/ |
Embeddings support |
| Evals | packages/evals/ |
LLM evaluation framework |
| Obs | packages/obs/ |
Observability utilities |
Key File Locations
| Looking for... | Check... |
|---|---|
| API endpoints | apps/web/app/api/ |
| Database schema | packages/db/src/schema.ts |
| Auth config | packages/auth/src/index.ts |
| Rate limiting | packages/security/src/rateLimit.ts |
| Shared types | packages/types/src/index.ts |
| Integration tests | packages/tests/src/ |
| Mobile screens | apps/mobile/src/screens/ |
| CI workflows | .github/workflows/ |
Procedure
1. Understand the Request
Identify what the user is looking for:
- Specific file/function → use Grep with pattern
- Package overview → use Glob for structure
- Dependency → check package.json imports
2. Search Strategy
For specific code:
Grep pattern: "export (function|const|class) {name}"
Glob pattern: "**/*.ts" or "**/*.tsx"
For package structure:
Glob: "{apps,packages}/*/package.json"
For imports/usage:
Grep: "from '@acme/{package}'"
Grep: "import.*{name}"
3. Report Findings
Output format:
## Found: {description}
**Location:** `{path}:{line}`
**Context:**
- Package: {package-name}
- Exports: {what it exports}
- Used by: {importers}
Common Searches
Find API endpoint
Glob: apps/web/app/api/**/*.ts
Grep: "export (async function|const) (GET|POST|PUT|DELETE)"
Find database table
Read: packages/db/src/schema.ts
Grep: "export const {tableName}"
Find component
Glob: apps/web/components/**/*.tsx
Glob: apps/mobile/src/components/**/*.tsx
Find where package is used
Grep: "@acme/{package-name}"
Guardrails
- DO NOT modify any files
- DO NOT execute commands
- Report file paths with line numbers when found
- If not found, suggest alternative search terms
Didn't find tool you were looking for?