Agent skill

codebase-navigation

Stars 1
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/abdullah1854/ClaudeSuperSkills/tree/main/codebase-navigation

SKILL.md

codebase-navigation

Project structure exploration and mapping. Analyzes codebase architecture, identifies patterns, maps dependencies, and creates mental models. Use when: onboarding to new project, understanding architecture, finding relevant code.

Metadata

  • Version: 1.0.0
  • Category: analysis
  • Source: workspace

Tags

navigation, exploration, architecture, mapping, structure

MCP Dependencies

None specified

Inputs

  • scope (string) (optional): Scope: full, directory, file, function
  • path (string) (optional): Path to analyze
  • focus (string) (optional): Focus area: structure, dependencies, patterns, all

Chain of Thought

  1. Identify entry points (package.json, main files). 2. Map directory structure and conventions. 3. Identify key patterns (MVC, modules, services). 4. Trace dependency graph. 5. Find configuration files. 6. Document architecture insights.

Workflow

No workflow defined

Anti-Hallucination Rules

None specified

Verification Checklist

None specified

Usage

typescript
// Execute via MCP Gateway:
gateway_execute_skill({ name: "codebase-navigation", inputs: { ... } })

// Or via REST API:
// POST /api/code/skills/codebase-navigation/execute
// Body: { "inputs": { ... } }

Code

typescript
// Codebase Navigation Skill
const scope = inputs.scope || 'full';
const focus = inputs.focus || 'all';

const explorationSteps = {
  structure: [
    '1. List root directory structure',
    '2. Identify src/lib/app directories',
    '3. Map module organization',
    '4. Find entry points',
    '5. Locate configuration files'
  ],
  dependencies: [
    '1. Read package.json/requirements.txt',
    '2. Map internal imports',
    '3. Identify shared modules',
    '4. Trace dependency chains',
    '5. Find circular dependencies'
  ],
  patterns: [
    '1. Identify architectural patterns (MVC, Clean, etc.)',
    '2. Find design patterns in use',
    '3. Map naming conventions',
    '4. Identify testing patterns',
    '5. Document code style'
  ]
};

console.log(`## Codebase Navigation - ${scope}

### Focus: ${focus}

### Exploration Steps:
${focus === 'all' ? 
  Object.entries(explorationSteps).map(([k, v]) => `#### ${k}\\n${v.join('\\n')}`).join('\\n\\n') :
  explorationSteps[focus]?.join('\\n') || 'Invalid focus area'}

### Quick Commands:
- \`tree -L 3 -I node_modules\` - Directory structure
- \`grep -r "import" --include="*.ts" | head -50\` - Import analysis
- \`find . -name "*.config.*"\` - Configuration files
- \`cat package.json | jq '.dependencies'\` - Dependencies

### Key Files to Check:
- README.md - Project overview
- package.json / requirements.txt - Dependencies
- tsconfig.json / pyproject.toml - Build config
- .env.example - Environment variables
- CLAUDE.md - AI instructions
`);

Created: Tue Dec 23 2025 00:30:24 GMT+0800 (Singapore Standard Time) Updated: Tue Dec 23 2025 00:30:24 GMT+0800 (Singapore Standard Time)

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