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

98

1.51x
Quality

100%

Does it follow best practices?

Impact

97%

1.51x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is figma-generate-diagram in figma/mcp-server-guide

SKILL.md
Quality
Evals
Security

Quality

Content

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a well-structured, actionable routing skill that keeps the overview lean while pushing per-type detail to verified reference files, with clear sequencing and an explicit error-recovery checkpoint. It respects Claude's competence and avoids concept re-explanation.

DimensionReasoningScore

Conciseness

Lean and directive throughout; it assumes Claude knows what diagrams and Mermaid are and spends tokens only on operational constraints, routing, and failure handling rather than concept explanation.

3 / 3

Actionability

Highly actionable for an instruction/routing skill: a concrete routing table, exact universal constraints with syntax examples ('A["Process (main)"]', '-->|"O(1) lookup"|'), explicit reserved words, and named tool parameters (name, mermaidSyntax, fileKey, useArchitectureLayoutCode).

3 / 3

Workflow Clarity

A clear 7-step sequence with explicit decision checkpoints (Step 1 right-tool check, Step 5 hybrid judgment with yes/no signals) and a feedback loop in Step 7 ('If the user is dissatisfied after 2 attempts... stop regenerating. Ask what specifically is wrong').

3 / 3

Progressive Disclosure

The body is an overview that routes to one-level-deep, clearly signaled reference files (architecture.md, flowchart.md, sequence.md, erd.md, state.md, gantt.md, workflow.md), all of which exist in ./references/, with type-specific detail appropriately split out.

3 / 3

Total

12

/

12

Passed

Description

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.

The description is specific, trigger-rich, and clearly delineates both what the skill does and when to load it, with a distinctive niche that minimizes conflict risk. It is somewhat long but the length reflects genuine trigger coverage rather than fluff.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'Routes to type-specific guidance, sets universal Mermaid constraints, and tells you when to use a different diagram type or skip the tool entirely' — matching the multiple-specific-actions anchor.

3 / 3

Completeness

Explicitly answers both what (routes, sets constraints, tells when to skip) and when ('Trigger whenever the user asks to create, generate, draw, render, sketch, or build a diagram'), satisfying the explicit-trigger requirement.

3 / 3

Trigger Term Quality

Excellent coverage of natural user terms: 'create, generate, draw, render, sketch, or build a diagram', 'flowchart, architecture diagram, sequence diagram, ERD...state diagram...gantt chart, or timeline', plus 'Mermaid syntax', 'decision tree', 'dependency graph', 'API call flow', 'auth handshake'.

3 / 3

Distinctiveness Conflict Risk

A clear niche (Mermaid/FigJam diagram generation via the `generate_diagram` tool) with distinct, diagram-specific triggers and a mandatory-prerequisite framing that is unlikely to fire for unrelated skills.

3 / 3

Total

12

/

12

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 2 suspicious

Warning

Total

15

/

16

Passed

Repository
Devin-AXIS/iPolloWork
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.