repo-navigator

导航和映射此monorepo结构。查找文件、包和依赖项。当被要求定位代码、理解包关系、查找定义位置或探索仓库结构时使用。

📖 中文导读:导航和映射此monorepo结构。查找文件、包和依赖项。当被要求定位代码、理解包关系、查找定义位置或探索仓库结构时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: repo-navigator description: 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. allowed-tools: Read, Grep, Glob

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