diagram-cli

Generate Mermaid architecture diagrams and refresh context packs for repositories.

8|4|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/jscraik/Agent-Skills --skill diagram-cli
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: diagram-cli
Source: https://github.com/jscraik/Agent-Skills/tree/main/utilities/diagram-cli
Command: npx skills add https://github.com/jscraik/Agent-Skills --skill diagram-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @brainwav/diagram, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill helps users quickly understand complex codebases by generating architecture diagrams and providing concise explanations, reducing onboarding time and improving code review efficiency.

Core Features & Use Cases

  • Architecture Diagram Generation: Creates visual representations of code structure using Mermaid syntax.
  • Context Pack Refresh: Updates agent-readable context packs based on current code.
  • Drift Detection: Identifies architectural changes between code versions for CI/CD pipelines.
  • Use Case: Onboarding a new developer by providing them with a clear, visual map of the project's architecture and key components.

Quick Start

Use the diagram-cli skill to generate an architecture map for the current repository.

Frequently Asked Questions about diagram-cli

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

FAQPage Schema
How do I generate architecture diagrams for repository understanding?▼

Architecture diagram generation for repository understanding is done by analyzing code structure and dependencies to output Mermaid syntax visualizations and manifest files. This provides deterministic, path-stable architecture artifacts for onboarding and code review.

Can I detect architecture drift in my CI pipeline?▼

You can detect architecture drift in your CI pipeline by using this Skill to analyze structural changes between code versions. It performs CI drift checks and uses manifest gates to validate artifact quality assurance during continuous integration.

How do I refresh context packs for agent-readable code visualization?▼

Refreshing context packs for agent-readable code visualization involves running this Skill to update context files based on current code. It analyzes the repository structure and dependencies to generate concise explanations and visual architecture maps for onboarding.

Do I need the @brainwav/diagram CLI to generate Mermaid diagrams?▼

Yes, generating Mermaid diagrams requires the @brainwav/diagram CLI because this Skill depends on it to produce deterministic, path-stable outputs. The CLI provides the core processing logic for validating and rendering the architecture artifacts.

What is the best way to analyze PR impact on code architecture?▼

The best way to analyze PR impact on code architecture is using this Skill to perform drift detection and compare code structure changes between versions. It generates updated architecture artifacts and context packs to visualize and validate structural modifications.

Does diagram generation work for large codebases with complex dependencies?▼

Diagram generation for large codebases with complex dependencies works by analyzing code structure to produce Mermaid diagrams and context packs. It supports onboarding and PR impact analysis by validating architecture artifacts through manifest gates for quality assurance.