What file formats does it output?

It generates structured Markdown files containing detailed reports and Mermaid.js syntax for visual UML diagrams like ER, class, and sequence diagrams.

Does it require a specific project structure?

The skill is designed to work with a project.yaml or setup.yaml file, which it uses as the Single Source of Truth for project context and requirements.

What is the main benefit of using the investigation skill?

It saves hours of manual code exploration by automatically mapping out architecture, data flows, and dependencies into standardized, readable documentation.

Can it identify technical debt or implementation risks?

Yes, it includes a specific module for risk and constraint analysis that highlights potential architectural limitations or implementation hurdles.

How does it handle multiple repositories?

It can iterate through all target repositories defined in your configuration files, creating organized investigation directories for each specific codebase.

Repository Investigation & Analysis

Name: Repository Investigation & Analysis
Author: NagasakaH

byNagasakaH

0•

Productivity & Workflow

Conducts systematic repository investigations and generates detailed technical documentation including UML diagrams and architecture reports.

This skill automates the deep-dive discovery phase of software development by analyzing target repositories against specific project requirements defined in a project.yaml file. It systematically examines system architecture, data structures, dependencies, and existing implementation patterns to produce comprehensive documentation. By generating Mermaid UML diagrams and risk analysis reports, it provides developers with a clear technical foundation before starting design or implementation tasks, ensuring all architectural constraints and existing patterns are fully understood and documented.

Key Features

010 GitHub stars

02Systematic analysis of data structures, schemas, and type definitions within the target codebase.

03Identification of existing coding patterns, implementation styles, and testing structures.

04Automated architectural mapping with Mermaid UML diagrams including Component, ER, and Sequence charts.

05Automated documentation generation and synchronization using project.yaml as the Single Source of Truth (SSOT).

06Deep dependency scanning for both internal module relationships and external package requirements.

Use Cases

01Generating standardized technical documentation and architectural diagrams for team reviews and project planning.

02Onboarding to an unfamiliar codebase to quickly understand its structure and logic before implementing changes.

03Validating technical feasibility and identifying potential implementation risks for new feature requests.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nagasakah/dev-process investigation

For use in Claude.ai and ChatGPT

Download Skill