skills.rest
apsulli
apsulliCOMMUNITY
Explore all skills by this author →
GitHub

GSD Codebase Mapper

Analyzes codebase structure, dependencies, patterns, and technical debt to generate ARCHITECTURE.md and STACK.md.

Updated Mar 11, 2026
Search Tags:#technical debt#codebase analysis#project onboarding#dependency mapping#architecture documentation#powershell#code scanning
One-click install
npx skills add https://github.com/apsulli/gsd-extended --skill gsd-codebase-mapper-apsulli
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: GSD Codebase Mapper
Source: https://github.com/apsulli/gsd-extended/tree/main/.agent/skills/codebase-mapper
Command: npx skills add https://github.com/apsulli/gsd-extended --skill gsd-codebase-mapper-apsulli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When starting work on an existing or unfamiliar codebase, developers lack a clear picture of its structure, dependencies, and technical debt, making planning risky and slow. This Skill scans the project and produces structured documentation that enables informed planning. ## Core Features & Use Cases - Structure and Dependency Mapping: Detects project type (Node.js, Python, Rust, Go, .NET), scans directories, and extracts runtime and development dependencies. - Pattern and Integration Analysis: Identifies naming conventions, API routes, state management patterns, external APIs, databases, and third-party services. - Technical Debt Discovery: Surfaces TODOs, FIXMEs, deprecated code, missing tests, and leftover debug statements. - Use Case: Before planning a new feature in a legacy repository, run the mapper to generate ARCHITECTURE.md and STACK.md so the AI assistant and developer share an accurate understanding of the system. ## Quick Start Ask the AI to map this codebase and generate ARCHITECTURE.md and STACK.md documenting its structure, dependencies, and technical debt.

Frequently Asked Questions about GSD Codebase Mapper

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze an unfamiliar codebase before planning new features?▼

Run a codebase mapping pass that detects the project type, scans the directory structure, extracts dependencies, and identifies patterns and technical debt. This Skill generates ARCHITECTURE.md and STACK.md so planning decisions are grounded in documented facts.

What project types does codebase mapping support?▼

It detects Node.js and JavaScript via package.json, Python via requirements.txt or pyproject.toml, Rust via Cargo.toml, Go via go.mod, and .NET via .csproj files. Dependency extraction is then tailored to each ecosystem.

How do I find technical debt in an existing project?▼

Search the source tree for TODO, FIXME, HACK, and XXX markers, deprecated annotations, and leftover console statements. The mapper compiles these findings into a technical debt checklist inside ARCHITECTURE.md.

Does codebase mapping work on Windows with PowerShell?▼

Yes, the scanning commands are written in PowerShell, using Test-Path, Get-ChildItem, and Select-String for structure, dependency, and pattern discovery. Equivalent commands would be needed on other shells.

What are the limitations of automated codebase analysis?▼

Static scanning cannot capture runtime behavior, dynamic imports, or undocumented business logic. Generated documentation should be reviewed by a developer and updated as the codebase evolves.

Related Skills

Explore More Software Engineering Skills→
kagentikagenti
292

onboard:link

Clone Git repositories into the Kagenti hub and verify skill discoverability.

Official
Basic
hq-opensourcehq-opensource
7

gsd-research

Generate planning artifacts and phase-specific RESEARCH.md files for implementation options.

Official
Advanced
AsiaOstrichAsiaOstrich
70

discover

Assess project health, architecture, and risks in existing codebases.

Community
Intermediate
pingqLINpingqLIN

java

Guide Java application development with static analysis and build verification.

Community
Intermediate