CtrlK
BlogDocsLog inGet started
Tessl Logo

prp-diagram

Generate a mermaid-only visual supplement for a plan artifact - the data-model, architecture, and flow diagrams a human wants when absorbing a plan. Use when the user wants to "diagram this plan", "visualize the plan", "draw the plan's architecture", "make diagrams for this plan", or invokes $prp-diagram.

73

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

90%Weight 40%Scale 1-5

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

A tight, highly actionable skill body: concrete code, a decision table, explicit output rules, and a strict content policy, all with essentially zero padding. The only soft spots are the absence of an output-validation step and a canonical resolver block that might be better factored out.

DimensionReasoningScore

Conciseness

The body is lean and imperative throughout — "One agent, one pass, no subagents... Nothing else." and "Diagrams supplement the plan — they never editorialize it." — with no explanations of concepts Claude already knows. Every section carries a rule or a copy-paste block; nothing is padded.

5 / 5

Actionability

Fully executable: a copy-paste-ready store-resolver bash block, exact output-path rules ('strip the trailing .md, append .diagrams.md'), a plan-content-to-diagram-type mapping table, and concrete constraints ('~40 nodes max', quoting example 'A["label (with) specials"]'). Specific guidance covers the common cases.

5 / 5

Workflow Clarity

Clear sequence (resolve store → output path → content policy → diagram selection → HTML alternative → report) with a fallback for blank input and an explicit, justified overwrite decision ('derived artifact; the plan is the source of truth'). Minor gap: it instructs that 'Mermaid syntax must be valid' but includes no post-generation validation check, fitting 'clear sequence with most checkpoints; minor validation gaps'. The destructive-operation cap does not apply since the overwrite behavior is an explicit, reasoned decision on a derived file.

4 / 5

Progressive Disclosure

No bundle files exist, and the single-file body is cleanly sectioned with no content inlined that clearly belongs elsewhere. Minor gap: the 13-line canonical store resolver (marked 'keep byte-identical across skills') could live in a shared script file, and the body is slightly over the under-50-lines simple-skill threshold — 'good structure; minor organization gaps' rather than the fully optimal anchor.

4 / 5

Total

18

/

20

Passed

Description

91%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete, third-person, and niche-defined, with explicit what/when framing and a rich set of natural trigger phrases including the skill's invocation name. Only minor room to grow on action enumeration and distinctiveness from general visualization skills.

DimensionReasoningScore

Specificity

"Generate a mermaid-only visual supplement for a plan artifact - the data-model, architecture, and flow diagrams" names the domain and several concrete deliverables (diagram categories), with only minor coverage gaps (a single generate verb rather than multiple enumerated actions). It exceeds anchor 3 (more than 1-2 concrete actions) but is less comprehensive than anchor 5.

4 / 5

Completeness

Explicitly answers both: what ("Generate a mermaid-only visual supplement for a plan artifact - the data-model, architecture, and flow diagrams") and when ("Use when the user wants to 'diagram this plan', ... or invokes $prp-diagram") with concrete trigger phrases.

5 / 5

Trigger Term Quality

Four natural, synonym-rich quoted phrases — "diagram this plan", "visualize the plan", "draw the plan's architecture", "make diagrams for this plan" — plus the explicit "$prp-diagram" invocation, matching the comprehensive-synonyms anchor. A user would naturally say these exact phrases; no meaningful terms are missing.

5 / 5

Distinctiveness Conflict Risk

Clear niche (mermaid-only diagrams for plan artifacts) with distinct triggers, but minor overlap risk with general diagramming or visualization skills that could also fire on 'draw the architecture'. Anchored at 'mostly distinct; minor overlap risk with closely related skills'.

4 / 5

Total

18

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
Wirasm/prp
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.