MANDATORY prerequisite — load this skill BEFORE every `generate_diagram` tool call. NEVER call `generate_diagram` directly without loading this skill first. Trigger whenever the user asks to create, generate, draw, render, sketch, or build a diagram — flowchart, architecture diagram, sequence diagram, ERD or entity-relationship diagram, state diagram or state machine, gantt chart, or timeline. Also trigger when the user mentions Mermaid syntax or wants a system architecture, decision tree, dependency graph, API call flow, auth handshake, schema, or pipeline visualized in FigJam. Routes to type-specific guidance, sets universal Mermaid constraints, and tells you when to use a different diagram type or skip the tool entirely (mindmaps, pie charts, class diagrams, etc.).
94
92%
Does it follow best practices?
Impact
97%
1.51xAverage score across 3 eval scenarios
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong, well-crafted skill description that excels across all dimensions. It provides extensive trigger terms covering many natural ways users might request diagrams, clearly states both what the skill does and when to use it, and occupies a distinct niche around diagram generation with Mermaid/FigJam. The only minor concern is the imperative/instructional tone ('MANDATORY prerequisite', 'NEVER call') which reads more like internal instructions to Claude than a pure capability description, but this doesn't significantly harm its effectiveness for skill selection.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'create, generate, draw, render, sketch, or build a diagram' and enumerates specific diagram types (flowchart, architecture diagram, sequence diagram, ERD, state diagram, gantt chart, timeline). Also mentions routing to type-specific guidance, setting Mermaid constraints, and handling unsupported types. | 3 / 3 |
Completeness | Clearly answers both 'what' (routes to type-specific guidance, sets Mermaid constraints, handles unsupported diagram types) and 'when' (explicit trigger clause: 'Trigger whenever the user asks to create, generate, draw, render, sketch, or build a diagram' with extensive enumeration of diagram types and contexts like FigJam). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would say: 'create, generate, draw, render, sketch, build a diagram', plus specific types like 'flowchart, architecture diagram, sequence diagram, ERD, entity-relationship diagram, state diagram, gantt chart, timeline, Mermaid syntax, decision tree, dependency graph, API call flow, auth handshake, schema, pipeline'. These are highly natural user terms. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with a clear niche: diagram generation via the `generate_diagram` tool with Mermaid syntax in FigJam. The specific tool name, diagram types, and Mermaid/FigJam references make it very unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a strong, well-structured skill that provides clear routing, actionable constraints, and a well-sequenced 7-step workflow for diagram generation. Its progressive disclosure is excellent, with a clean overview that routes to type-specific references. The main weakness is verbosity in Steps 4 and 5, which explain context-gathering and judgment calls that Claude can largely infer, adding ~30% more tokens than necessary.
Suggestions
Trim Step 4 ('Garbage in, garbage out') significantly — the bullet list of context sources (source code, documents, Figma files, MCP servers, the user) describes general information-gathering that Claude already knows. Reduce to 2-3 sentences: 'Ground the diagram in real data — read source code, user-provided docs, or connected tools rather than guessing. If the description is thin, ask 1-2 focused questions before generating. Don't invent edges or entities to fill gaps.'
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is mostly efficient and well-structured, but Step 4 ('Garbage in, garbage out') is notably verbose with extensive explanation of context-gathering strategies that Claude already knows (read source code, ask the user, use available tools). The bullet list of context sources could be cut significantly. Step 5 also over-explains when to use hybrid workflows with signal lists that border on obvious. | 2 / 3 |
Actionability | The skill provides highly concrete, actionable guidance: specific parameter names for the tool call, exact node ID conventions (camelCase), specific error messages to avoid, a clear routing table mapping user intent to diagram type and reference file, and precise constraints like 'no emojis', 'no HTML tags', 'no \n in labels'. The tool invocation parameters are explicitly listed with required vs optional. | 3 / 3 |
Workflow Clarity | The 7-step workflow is clearly sequenced with explicit decision points: Step 1 gates whether to use the tool at all, Step 2 routes to the correct type, Step 3 applies universal constraints, Steps 4-5 are pre-generation checks, Step 6 is the actual call, and Step 7 covers post-generation including iteration strategy and a clear stopping rule ('if dissatisfied after 2 attempts, stop regenerating'). The file reuse guidance includes a validation/feedback loop. | 3 / 3 |
Progressive Disclosure | Excellent progressive disclosure structure: the main skill provides a concise routing table and universal constraints, then clearly signals one-level-deep references to type-specific guides (architecture.md, flowchart.md, sequence.md, erd.md, state.md, gantt.md, workflow.md). References are well-signaled with both inline links and the routing table. The SKILL.md works as a standalone overview while deferring detailed per-type guidance appropriately. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
a742f0a
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.