repo-analyzer

Analyze code repositories and generate structured Markdown technical documentation.

3|Updated Oct 15, 2025

Search Tags:#automation #architecture #reports #documentation #codebase #analysis #repo

Ready to run

npx skills add https://github.com/chaorenex1/coding-agent-workflow --skill repo-analyzer

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: repo-analyzer
Source: https://github.com/chaorenex1/coding-agent-workflow/tree/main/skills/repo-analyzer
Command: npx skills add https://github.com/chaorenex1/coding-agent-workflow --skill repo-analyzer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, toml, chardet.

What problem does it solve?

This Skill helps teams quickly understand a codebase by generating a structured analysis report including project overview, directory responsibilities, tech stack, core modules, workflows, risk points, and onboarding guidance.

Core Features & Use Cases

Repository Global Scan: Gathers directory stats, identified languages, and key documentation/config files.
Structure & Tech Analysis: Maps directory responsibilities, dependencies, and architecture patterns.
Onboarding & Risk: Produces onboarding guidance and risk/technical debt insights.

Quick Start

Use the repo-analyzer to generate a comprehensive repository report for a given path:

python repo_analyzer.py /path/to/repository
python repo_analyzer.py /path/to/repository --output report.md --depth 3

Frequently Asked Questions about repo-analyzer

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

FAQPage Schema

How do I generate documentation from a code repository automatically?▼

Repository analysis automates the creation of structured technical documentation by scanning your codebase to extract architecture, dependencies, and workflows. repo-analyzer generates comprehensive Markdown reports including project overview, directory structure, tech stack, core modules, and onboarding guidance in a single command.

Can I analyze a multi-language repository and get a tech stack report?▼

Yes. repo-analyzer detects languages by file extensions across multi-language projects and produces a tech stack analysis alongside directory responsibilities and dependency mapping, outputting all findings in a single configurable Markdown report.

What does repo-analyzer output and how do I customize the report?▼

repo-analyzer outputs a Markdown report containing project overview, directory responsibilities, identified languages, dependencies, core modules, execution flows, risk assessment, and onboarding guidance. Customize output filename and analysis depth using --output and --depth flags.

How do I identify technical debt and risk points in my codebase?▼

repo-analyzer includes risk assessment as part of its eight-step analysis pipeline, detecting maintenance risks, technical debt indicators, and architectural concerns. The generated report surfaces these risk points alongside onboarding guidance and workflow analysis.

Does repo-analyzer work with configuration files and README detection?▼

Yes. repo-analyzer identifies README and configuration files during its global scan phase, incorporating these into the analysis. It recognizes common config formats and documents them as part of the repository structure and tech stack assessment.

What file formats and dependencies does repo-analyzer require?▼

repo-analyzer processes source code repositories and works with projects using pyyaml, toml, and chardet dependencies. It analyzes multi-language codebases by file extension and outputs Markdown reports compatible with standard documentation workflows.