CtrlK
BlogDocsLog inGet started
Tessl Logo

figma-generate-diagram

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

1.51x
Quality

92%

Does it follow best practices?

Impact

97%

1.51x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

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.

DimensionReasoningScore

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.'

DimensionReasoningScore

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
figma/mcp-server-guide
Reviewed

Table of Contents

Is this your skill?

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.