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, functionpath(string) (optional): Path to analyzefocus(string) (optional): Focus area: structure, dependencies, patterns, all
Chain of Thought
- 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)
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
dockerfile-generator
1
0
Explore
tool-design
1
0
Explore
ax-dynamics-helper
1
0
Explore
pr-summary
1
0
Explore
memory-systems
1
0
Explore
hooks-guide
1
0
Explore
Didn't find tool you were looking for?