Is this skill suitable for legacy codebases?

Absolutely; it is specifically designed to help developers establish clear mental models and identify risks in unfamiliar or complex legacy systems.

What is the 'Map First' approach used by this skill?

It involves scanning the entire repository to create a global mindmap before diving into specific modules, ensuring every chapter is contextually aware of the whole system.

Does this skill generate visual diagrams?

Yes, it automatically generates Mermaid diagrams for components, sequences, and data flows to visualize the system's architecture and logic.

How does it handle security in the generated reports?

The skill includes built-in escaping mechanisms to ensure that all code snippets and user inputs are XSS-safe when rendered in the final HTML report.

System Architecture Analyst

Name: System Architecture Analyst
Author: zjfls

byzjfls

•

Learning & Documentation

Performs deep codebase architecture analysis and generates structured, visual technical documentation using a mindmap-driven workflow.

The System Architecture Analyst skill transforms how developers understand complex codebases by utilizing a 'Map First, Deep Dive Later' methodology. It systematically scans repositories to create comprehensive mindmaps, then iteratively builds detailed technical reports chapter-by-chapter. Each section provides evidence-linked analysis, Mermaid visualizations of data flows, design trade-offs, and prioritized risk assessments, ensuring a high-depth, secure, and professional architectural audit for any project.

Key Features

01Incremental chapter-based document generation via specialized CLI tools

02Evidence-based analysis linked to specific files and code entry points

032 GitHub stars

04Mindmap-driven exploration for structured codebase discovery

05Security-conscious reporting with XSS-safe HTML output

06Automated Mermaid diagram generation for visual system flows

Use Cases

01Performing architectural reviews and technical due diligence with risk grading

02Onboarding to large, unfamiliar codebases by establishing a structured mental map

03Generating professional documentation for complex systems including data flows and trade-offs

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add zjfls/zhoujie-claude-skills skill-system-analyst

For use in Claude.ai and ChatGPT

Download Skill