Can I target specific parts of my project?

Yes, you can provide additional context in your command, such as 'docs-diagram er for user and order tables', to focus the analysis on specific modules.

Where are the generated diagrams stored?

Diagrams are saved as Markdown files within your project's 'docs/' folder (e.g., docs/architecture.md or docs/data-model.md) using standardized templates.

What diagram formats does it support?

It generates Mermaid-compatible code, which is widely supported by GitHub, GitLab, and various Markdown editors, covering ER, architecture, deployment, and security types.

Does it overwrite my existing documentation?

If a documentation file already exists, the skill is designed to ask for confirmation before overwriting, allowing you to preserve custom manual content.

How does this skill prevent hallucinating components?

The skill uses a strict verification workflow where parallel sub-agents must confirm the existence of files, imports, and relationships in the actual codebase before adding any element to a diagram.

Docs Diagram Generator

Name: Docs Diagram Generator
Author: mgiovani

bymgiovani

•

Learning & Documentation

Generates verified Mermaid-based system diagrams, ER models, and architecture visualizations by performing deep analysis of your actual codebase.

The Docs Diagram skill automates the creation of high-fidelity technical documentation by scanning your repository to produce verified Mermaid diagrams. Unlike standard generators, it employs strict anti-hallucination protocols and parallel sub-agents to confirm that every service, database entity, and infrastructure component in the diagram corresponds to real source code. This skill is essential for keeping documentation in sync with rapidly evolving codebases, onboarding new developers, or performing architectural audits without the manual effort of drawing diagrams.

Key Features

01Automated Mermaid syntax generation compatible with GitHub and most Markdown viewers.

022 GitHub stars

03Template-driven output for consistent, professional documentation in the docs/ directory.

04Strict anti-hallucination verification ensuring every diagram component exists in the code.

05Support for ER diagrams, system architecture, deployment maps, and security flows.

06Parallel sub-agent processing for fast and multi-faceted codebase analysis.

Use Cases

01Generating architectural overviews to help new team members visualize service relationships.

02Automatically updating data model documentation after database schema migrations.

03Creating deployment and infrastructure maps for security reviews and CI/CD planning.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mgiovani/cc-arsenal docs-diagram

For use in Claude.ai and ChatGPT

Download Skill