AutoSkillit: Skill for Claude Code

Verify Diagram Skill

Verify an architecture diagram's factual accuracy against the actual codebase. Adapted from the dry-walkthrough methodology for diagram validation.

When to Use

• After generating an arch lens diagram
• User says "verify diagram", "verify diag", "check diagram"
• Before finalizing diagram examples or documentation

Critical Constraints

NEVER:

• Modify source code files
• Modify the diagram during verification (report findings only)

ALWAYS:

• Verify every named component exists in the codebase
• Trace actual code paths for every connection
• Determine read/write directionality for every connection
• Report findings to terminal, not to files

---

Verification Workflow

Step 0: Validate Mermaid Syntax (Rendering Check)

This step runs BEFORE semantic verification. Extract every mermaid code block and check for syntax errors that would prevent rendering.

For each ```mermaid block, validate:

1. Node label quoting:

• [...] node content must NOT contain unescaped double quotes
• BAD: A["value = "hello""] — inner quotes break the parser
• GOOD: A["value = hello"] or A[value = hello]
• Check: scan all [...] and (...) node definitions for " inside content

2. Bracket balance:

• Every [ has a matching ] on the same line (for node definitions)
• Every ( has a matching ) on the same line
• Exception: ([...]) stadium shapes have nested brackets — count outer pair

3. Special characters in node labels:

• Parentheses () inside [...] labels break parsing — rephrase or remove
• Pipe | inside node labels conflicts with edge label syntax
• Curly braces {} inside node labels conflict with rhombus/decision syntax
• Hash # at start of label can be misinterpreted

4. Edge label syntax:

• Edge labels must use -->|"label"| or -->|label| format
• Unmatched pipe chars on edge lines break parsing

5. Subgraph naming:

• subgraph NAME ["Display Title"] — the ["..."] is valid mermaid syntax
• But subgraph NAME [Display Title] without quotes is NOT valid if title has spaces