skills.rest
chaorenex1
chaorenex1COMMUNITY
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/chaorenex1/coding-agent-workflow --skill repo-analyzer
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
spencerbeggsspencerbeggs

/design-docs:user-docs-create-readme

Generate README.md files from project structure and package.json.

Community
Intermediate
dapperdiversdapperdivers
1

report-generator

Generate structured markdown penetration test reports from JSON security scan findings.

Community
Intermediate
delorenjdelorenj

skf-verify-stack

Verify tech stack feasibility against architecture and PRD documents.

Community
Advanced
vikisingh23vikisingh23
4

security-review

Scan codebases for security vulnerabilities and generate prioritized remediation reports.

Community
Intermediate