repo-research

Analyze a codebase and generate a research/ folder with 10 documents and Mermaid diagrams.

20|5|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/nasrulhazim/agent-skills --skill repo-research-nasrulhazim
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repo-research
Source: https://github.com/nasrulhazim/agent-skills/tree/main/skills/repo-research
Command: npx skills add https://github.com/nasrulhazim/agent-skills --skill repo-research-nasrulhazim

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deep repository research and analysis that automatically studies any codebase end-to-end and outputs a complete research/ folder with 10 structured documents and Mermaid diagrams.

Core Features & Use Cases

  • Produces a complete research/ folder with 10 structured documents and 50+ Mermaid diagrams that explain architecture, workflows, algorithms, frontend, configuration, deployment, testing, limitations, and SaaS opportunity analysis.
  • Always generates all 10 documents together — never partial output.
  • Useful for onboarding new engineers, documenting complex codebases, reverse-engineering architectures, and planning product improvements.

Quick Start

Provide the target repository path or URL and I will generate a complete research/ folder with 10 documents and diagrams.

Frequently Asked Questions about repo-research

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

FAQPage Schema
How do I generate architecture documentation and Mermaid diagrams for a repository?

To generate repository architecture documentation and Mermaid diagrams, provide the target codebase path or URL. The tool analyzes the codebase and outputs a complete research/ folder containing 10 structured documents with 50+ diagrams covering workflows, algorithms, configuration, and deployment.

Can I reverse-engineer a microservices codebase to understand its workflows and algorithms?

Yes, you can reverse-engineer microservices codebases to understand workflows and algorithms. The analysis applies across repo types from monoliths to microservices, reading README.md and CLAUDE.md files to tailor the extracted architectural research documents.

What's the best way to onboard new engineers to a complex codebase?

The best way to onboard new engineers to a complex codebase is generating structured research docs. This produces 10 comprehensive documents explaining architecture, frontend, testing, and limitations, providing a complete end-to-end study of the repository.

Does the repository analysis always generate all 10 documents together?

Yes, repository analysis always generates all 10 research documents together without partial output. This ensures a complete end-to-end structural analysis, covering architecture, configuration, deployment, testing, limitations, and SaaS opportunities.

How do I identify SaaS opportunities when analyzing a codebase?

To identify SaaS opportunities when analyzing a codebase, the research process extracts key files and studies structural limitations. It automatically outputs a dedicated document evaluating potential SaaS opportunities within the analyzed repository.

Can I document an undocumented monolith repository without manually reading every file?

Yes, you can document an undocumented monolith repository without manually reading every file. The analysis reads core configuration files, extracts key source files, and builds 10 structured documents with Mermaid diagrams covering the complete architecture automatically.