codebase-summary

Analyze a codebase and generate architecture and workflow documentation.

Updated Jan 29, 2026
One-click install
npx skills add https://github.com/Happyverse-Team/video-content-generator --skill codebase-summary-happyverse-team
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codebase-summary
Source: https://github.com/Happyverse-Team/video-content-generator/tree/main/.claude/skills/codebase-summary
Command: npx skills add https://github.com/Happyverse-Team/video-content-generator --skill codebase-summary-happyverse-team

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The SOP analyzes a codebase and generates comprehensive documentation including structured metadata files that describe the system architecture, components, interfaces, and workflows. It can create targeted documentation files like AGENTS.md (README for AI agents), README.md, CONTRIBUTING.md, or generate a complete documentation ecosystem. The documentation is organized to make it easy for AI assistants to understand the system and help with development tasks.

Core Features & Use Cases

  • Automated analysis of a codebase to produce architecture, components, interfaces, and workflows documentation.
  • Generate targeted docs like AGENTS.md, README.md, CONTRIBUTING.md, or a complete documentation ecosystem.
  • Supports configurable parameters such as output_dir, consolidate, consolidate_target, consolidate_prompt, check_consistency, check_completeness, update_mode, and codebase_path to control analysis and updates.

Quick Start

Use the codebase-summary tool to analyze the repository and generate documentation in the default output directory. Example: codebase-summary --codebase_path . --output_dir .sop/summary

Frequently Asked Questions about codebase-summary

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

FAQPage Schema
How do I generate documentation from an existing codebase automatically?

To generate documentation from a codebase automatically, you need a tool that analyzes system architecture, components, interfaces, and workflows to produce structured metadata files. This skill outputs targeted files like AGENTS.md, README.md, and CONTRIBUTING.md into a configured output directory.

What is an AGENTS.md file and when do I need it for my repository?

An AGENTS.md file serves as a README specifically designed for AI assistants to understand a codebase. You need it when integrating AI into development tasks, as it structures system architecture and workflows metadata to help AI agents parse the repository efficiently.

How do I consolidate multiple codebase documentation files into a single overview?

To consolidate codebase documentation into a single overview, use the consolidate parameter with a consolidate_target and consolidate_prompt. This guides the analysis to merge the generated architecture and component docs into one targeted file.

Can I check the consistency and completeness of my codebase documentation?

Yes, you can check documentation consistency and completeness by enabling the check_consistency and check_completeness parameters. This verifies that the generated architecture, components, interfaces, and workflows metadata accurately reflects the analyzed codebase.

Does automated codebase documentation support updating existing files instead of overwriting them?

Yes, automated codebase documentation supports updating existing files via the update_mode parameter. This allows the tool to analyze the repository and modify targeted documentation files incrementally without overwriting the entire documentation ecosystem.