codebase-survey

Survey codebases to inventory structure, dependencies, and programming patterns.

2|Updated Feb 4, 2026
One-click install
npx skills add https://github.com/PaulKinlan/docker-agent-test --skill codebase-survey
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codebase-survey
Source: https://github.com/PaulKinlan/docker-agent-test/tree/main/config/skills/architect/codebase-survey
Command: npx skills add https://github.com/PaulKinlan/docker-agent-test --skill codebase-survey

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps you quickly understand the structure, dependencies, and key patterns within any codebase, especially when encountering an unfamiliar project.

Core Features & Use Cases

  • Codebase Inventory: Generates a comprehensive overview of a project's directory structure, language breakdown, and entry points.
  • Dependency Mapping: Identifies project dependencies from package managers and system tools.
  • Pattern Recognition: Highlights common coding patterns like error handling, logging, and configuration loading.
  • Use Case: Before starting a new feature in a large, legacy codebase, use this Skill to get a rapid architectural overview and identify potential areas of complexity or risk.

Quick Start

Run the codebase-survey skill on the current directory to generate a survey report.

Frequently Asked Questions about codebase-survey

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

FAQPage Schema
How do I map a codebase architecture for an unfamiliar software project?

To map a codebase architecture, you can survey the project to generate an inventory of its directory structure, language distribution, entry points, and external dependencies.

What is the best way to identify dependencies and programming patterns in a codebase?

Identifying dependencies and programming patterns involves analyzing the codebase to map external libraries from package managers and recognize common conventions for error handling, logging, configuration, and testing.

Can I survey a legacy codebase to find areas of complexity before starting a new feature?

Yes, you can survey a legacy codebase to get a rapid architectural overview of its structure and patterns, which helps identify potential areas of complexity or risk before development.

How do I generate an inventory of a project's directory layout and language distribution?

You generate an inventory of a project's directory layout and language distribution by running a codebase survey on the current working directory to analyze and report its structural composition.

Does codebase analysis work without installing external dependencies or tools?

Yes, codebase analysis works without installing external dependencies, as the survey skill operates independently using its internal scripts to read and evaluate the existing project files.