跳到正文
cccskills
免费在 GitHub 公开

system-diagram-generator

Creates visual representations of system structure including architecture diagrams, data flow diagrams, deployment diagrams, and sequence diagrams. Use when Claude needs to visualize system components, infrastructure, data flows, or interactions. Supports Mermaid (recommended for Markdown/GitHub), PlantUML (for detailed UML), and Graphviz/DOT (for complex networks). Trigger when users request diagrams, visualizations, or ask to "show", "diagram", "visualize", or "map out" system architecture, infrastructure, data flows, or component interactions.

中文简介正在准备中。当前显示原文说明。

集成工具GitHubGitLabAWS
查看安装方法

包含的文件(4)

  • SKILL.md5.9 KB
  • references/graphviz-patterns.md3.0 KB
  • references/mermaid-patterns.md2.1 KB
  • references/plantuml-patterns.md2.2 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

System Diagram Generator

Generate clear, accurate visual representations of system structure using text-based diagram formats.

Quick Start

When a user requests a system diagram:

  1. Understand the system: Ask clarifying questions about components, relationships, and scope
  2. Choose the format: Select based on user preference or context (default to Mermaid for versatility)
  3. Select diagram type: Match the visualization to the information being conveyed
  4. Generate the diagram: Create the diagram code with clear labels and structure
  5. Provide context: Include a brief explanation of what the diagram shows

Format Selection

Mermaid (Default)

Use for most cases - renders in Markdown, GitHub, GitLab, and many documentation tools.

Best for:

  • Quick visualizations
  • Documentation in Markdown files
  • GitHub/GitLab README files
  • General-purpose diagrams

See: mermaid-patterns.md for examples

PlantUML

Use when detailed UML diagrams are needed or when working with Java/enterprise systems.

Best for:

  • Detailed UML diagrams
  • C4 architecture models
  • Complex component relationships
  • Enterprise documentation

See: plantuml-patterns.md for examples

Graphviz/DOT

Use for complex network topologies or when fine-grained layout control is needed.

Best for:

  • Network diagrams
  • Complex hierarchies
  • Graph structures
  • Custom layout requirements

See: graphviz-patterns.md for examples

Diagram Types

Architecture Diagrams

Show system components, services, databases, and their relationships.

Use when:

  • Explaining system structure
  • Documenting microservices
  • Showing component dependencies
  • Illustrating system boundaries

Key elements:

  • Services/components (boxes)
  • Databases (cylinders)
  • External systems
  • Communication protocols
  • Data stores

Data Flow Diagrams

Illustrate how data moves through the system.

Use when:

  • Explaining data processing pipelines
  • Documenting ETL processes
  • Showing transformation steps
  • Illustrating validation flows

Key elements:

  • Data sources
  • Processing steps
  • Transformations
  • Data stores
  • Outputs

Deployment Diagrams

Show infrastructure, servers, containers, and deployment topology.

Use when:

  • Documenting cloud infrastructure
  • Explaining deployment architecture
  • Showing network topology
  • Illustrating container orchestration

Key elements:

  • Cloud providers/regions
  • Networks/subnets
  • Servers/containers
  • Load balancers
  • Databases and caches

Sequence Diagrams

Visualize API calls, user interactions, and process flows over time.

Use when:

  • Documenting API interactions
  • Explaining authentication flows
  • Showing request/response cycles
  • Illustrating multi-step processes

Key elements:

  • Actors/participants
  • Messages/calls
  • Time sequence (top to bottom)
  • Return values
  • Conditional logic

Best Practices

Clarity

  • Use descriptive, meaningful names for all components
  • Keep diagrams focused on one aspect of the system
  • Avoid overcrowding - split complex systems into multiple diagrams
  • Use consistent naming conventions

Structure

  • Group related components using subgraphs/clusters
  • Show clear directional flow (left-to-right or top-to-bottom)
  • Use appropriate shapes for different component types
  • Include relevant protocols and technologies

Context

  • Add a title or caption explaining what the diagram shows
  • Include legends for non-obvious symbols or colors
  • Provide brief explanations of key components
  • Note any assumptions or simplifications

Format-Specific

  • Mermaid: Use standard graph types (flowchart, sequence, C4)
  • PlantUML: Leverage UML stereotypes and C4 includes
  • Graphviz: Use clusters for grouping and rankdir for layout

Workflow

  1. Gather requirements

    • What system or process needs visualization?
    • What level of detail is needed?
    • Who is the audience?
    • Any format preferences?
  2. Choose format and type

    • Select diagram format (Mermaid/PlantUML/Graphviz)
    • Select diagram type (architecture/data flow/deployment/sequence)
    • Load relevant reference file if needed
  3. Create diagram

    • Define all components/nodes
    • Establish relationships/edges
    • Add grouping/structure
    • Include labels and protocols
  4. Validate and refine

    • Ensure all components are labeled
    • Verify relationships are clear
    • Check for visual balance
    • Add explanatory text
  5. Deliver

    • Provide the diagram code in a code block
    • Include brief explanation
    • Suggest improvements or variations if relevant

Example Usage Patterns

User: "Show me the architecture of our authentication system" → Create Mermaid architecture diagram showing auth components

User: "Diagram the data flow for user registration" → Create Mermaid flowchart showing registration data flow

User: "Visualize our AWS deployment" → Create Mermaid or Graphviz deployment diagram with AWS infrastructure

User: "Show the sequence of API calls for checkout" → Create Mermaid sequence diagram showing checkout flow

User: "I need a detailed UML component diagram" → Create PlantUML component diagram with stereotypes

User: "Map out our network topology" → Create Graphviz network diagram with clusters

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Applies abstract interpretation using different abstract domains (intervals, octagons, polyhedra, sign, congruence) to statically analyze program variables and infer invariants, value ranges, and relationships. Use when analyzing program properties, inferring loop invariants, detecting potential errors, or understanding variable relationships through static analysis.

中文简介正在准备中。当前显示原文说明。

ArabelaTso/Skills-4-SE2582026年8月21日 更新

Uses abstract interpretation to automatically infer loop invariants, function preconditions, and postconditions for formal verification. Generates invariants that capture program behavior and support correctness proofs in Dafny, Isabelle, Coq, and other verification systems. Use when adding formal specifications to code, generating verification conditions, inferring contracts for functions, or discovering loop invariants for proofs.

中文简介正在准备中。当前显示原文说明。

ArabelaTso/Skills-4-SE2582026年8月21日 更新

Performs abstract interpretation over source code to infer possible program states, variable ranges, and data properties without executing the program. Reports potential runtime errors including out-of-bounds accesses, null dereferences, type inconsistencies, division by zero, and integer overflows. Use when analyzing code for potential runtime errors, performing static analysis, checking safety properties, or verifying program behavior without execution.

中文简介正在准备中。当前显示原文说明。

ArabelaTso/Skills-4-SE2582026年8月21日 更新

Performs abstract interpretation to produce summarized execution traces and high-level program behavior representations. Highlights key control flow paths, variable relationships, loop invariants, function summaries, and potential runtime states using abstract domains (intervals, signs, nullness, etc.). Use when analyzing program behavior, understanding execution paths, computing loop invariants, tracking variable ranges, detecting potential runtime errors, or generating program summaries without concrete execution.

中文简介正在准备中。当前显示原文说明。

ArabelaTso/Skills-4-SE2582026年8月21日 更新

Create ACSL (ANSI/ISO C Specification Language) formal annotations for C/C++ programs. Use this skill when working with formal verification, adding function contracts (requires/ensures), loop invariants, assertions, memory safety annotations, or any ACSL specifications. Supports Frama-C verification and generates comprehensive formal specifications for C/C++ code.

中文简介正在准备中。当前显示原文说明。

ArabelaTso/Skills-4-SE2582026年8月21日 更新

CLI-based browser automation with persistent page state using ref-based element interaction. Use when users ask to navigate websites, interact with web pages, fill forms, take screenshots, test web applications, or extract information from web pages.

中文简介正在准备中。当前显示原文说明。

ArabelaTso/Skills-4-SE2582026年8月21日 更新

查看 ArabelaTso 的全部技能

报告此技能的问题