map-codebase

Analyze codebases with parallel agents and generate structured documentation.

Updated Feb 16, 2026
One-click install
npx skills add https://github.com/kingkillery/pk-qmd --skill map-codebase-kingkillery
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: map-codebase
Source: https://github.com/kingkillery/pk-qmd/tree/main/.agents/skills/map-codebase
Command: npx skills add https://github.com/kingkillery/pk-qmd --skill map-codebase-kingkillery

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires commander, chalk, fs-extra, vitest, sinon, ioredis, pino, jest, chai, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This skill solves the problem of understanding and mapping complex codebases, providing a comprehensive overview that can be used for project onboarding, refactoring, and maintaining codebase health.

Core Features & Use Cases

  • Parallel Exploration: Utilizes multiple parallel agents to analyze different aspects of the codebase simultaneously.
  • Structured Documentation: Generates structured documentation files like STACK.md, ARCHITECTURE.md, and STRUCTURE.md.
  • Custom Templates: Allows for optional templates like TESTING.md, INTEGRATIONS.md, and CONCERNS.md based on project needs.
  • Focus Areas: Can focus on specific areas such as "api", "auth", or any other part of the codebase.

Quick Start

Run the map-codebase skill with the desired focus area, e.g., /map-codebase api.

Frequently Asked Questions about map-codebase

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

FAQPage Schema
How do I map a complex codebase for project onboarding?

You can map a complex codebase for onboarding by running parallel Explore agents that analyze the technology stack, architecture, and conventions, then output structured documentation files like STACK.md and ARCHITECTURE.md.

What is the best way to generate structured documentation for an existing codebase?

The best way to generate structured documentation is to use an automated codebase analysis skill that reviews integrations and concerns via parallel exploration, producing tailored documents like TESTING.md and INTEGRATIONS.md based on project needs.

Can I focus codebase analysis on specific areas like api or auth?

Yes, you can focus codebase analysis on specific areas like api or auth by passing the desired focus area as an argument, such as running the command with the api parameter to isolate and evaluate that specific section.

How does parallel exploration work when analyzing a codebase?

Parallel exploration works by deploying multiple agents simultaneously to analyze different aspects of the codebase, such as testing frameworks and integrations, which accelerates the analysis process and ensures comprehensive coverage of conventions and structure.

Does codebase mapping support custom documentation templates?

Yes, codebase mapping supports custom documentation templates by allowing you to generate optional files like TESTING.md, INTEGRATIONS.md, and CONCERNS.md, ensuring the structured documentation aligns with specific project requirements.