CtrlK
BlogDocsLog inGet started
Tessl Logo

positron-stylized-svg

Create or revise minimal, stylized SVG illustrations that accurately represent the Positron UI for documentation, tutorials, walkthroughs, onboarding, and feature previews. Use when an SVG should resemble Positron or match its walkthrough illustration style; do not use for diagrams that are not representations of the product UI.

73

Quality

90%

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

92%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.

Excellent skill body: an actionable, evidence-driven workflow with executable commands, a scene-specification checklist, hard validator gates, and well-organized one-level-deep references. The only improvement area is trimming a few multi-sentence rationale passages (button-bounds justification, rsvg-convert font caveat) that could be compressed to single lines, which is why conciseness sits at 4 while the other dimensions are at 5.

DimensionReasoningScore

Conciseness

The body is dense, prescriptive product knowledge (exact canvases, hex colors, codicon rules, ownership contracts) with zero padding about what SVG or rendering is — no 'concepts Claude already knows' violations. It sits at 4 rather than 5 because a few rationale passages run long and could be trimmed, e.g. the multi-sentence justification for data-role="button-bounds" ("a fixed-width button and an independently hand-measured label are a common source of...") and the rsvg-convert font-substitution caveat, both of which could be one line plus a pointer to references/style.md. It is well above 3 since nothing is unnecessary — every rule is Positron-specific.

4 / 5

Actionability

Fully executable, copy-paste-ready commands throughout: "python3 <skill-dir>/scripts/extract_icon.py codicon <icon-name>", the validate_svg.py --strict-alignment invocation, and rsvg-convert render commands, plus exact values like "520×260", "#3A78B1", "data-owner=\"<region>\"", and "2–5 bars per visible content region". This matches the top anchor: concrete commands covering the common cases with specific examples.

5 / 5

Workflow Clarity

The sequence is explicit and well-ordered: evidence hierarchy (1–5), scene specification checklist, canvas selection, drawing contract, then a numbered 6-step QA loop with a hard validation checkpoint ("Treat validator errors as blockers") and iterate-from-render feedback ("Iterate from rendered output, not source inspection alone"; "Remove unsupported objects"). This matches the anchor 'clear sequence with explicit validation steps; feedback loops for error recovery; checklists for complex processes' — the scene-spec bullet list is itself a checklist.

5 / 5

Progressive Disclosure

The body is a clear overview that pushes detail exactly one level deep with well-signaled markdown links — [references/style.md](references/style.md) for palette/typography/abstraction, [references/evidence.md](references/evidence.md) for pane/icon evidence, and the two scripts (extract_icon.py, validate_svg.py) which both exist in the bundle; the reference files themselves contain no further nested .md chains. Content split is appropriate: the main file holds policy and workflow, not the style-guide bulk. This matches the top anchor.

5 / 5

Total

19

/

20

Passed

Description

87%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: explicit what and when, concrete actions, natural trigger terms, and an explicit negative boundary that sharply limits wrong-skill triggering. The only weaknesses are a slightly thin action list (create/revise only) and a few missing synonyms (mockup, screenshot-style) that would otherwise earn full marks on specificity and trigger coverage.

DimensionReasoningScore

Specificity

"Create or revise minimal, stylized SVG illustrations that accurately represent the Positron UI" names two concrete, domain-specific actions with clear output characteristics, matching the 'several specific actions; minor gaps' anchor. It falls short of 5 because only two verbs are listed (create, revise) — supporting operations like icon extraction or validation are not mentioned, and the score-5 anchor expects a fuller action inventory.

4 / 5

Completeness

Both halves are explicit: the 'what' is "Create or revise minimal, stylized SVG illustrations that accurately represent the Positron UI for documentation, tutorials, walkthroughs, onboarding, and feature previews" and the 'when' is "Use when an SVG should resemble Positron or match its walkthrough illustration style" — concrete trigger phrases with an explicit negative boundary. This matches the top anchor exactly; the 'when' clause is present, specific, and unambiguous.

5 / 5

Trigger Term Quality

Natural trigger terms are well covered: "SVG", "Positron", "walkthroughs", "tutorials", "documentation", "illustration style", and the exclusion phrase "do not use for diagrams". It misses a few plausible synonyms a user might say (e.g., "mockup", "screenshot-style", "hero/getting-started image"), which keeps it at 'good keyword coverage; a few natural terms missing' rather than fully comprehensive.

4 / 5

Distinctiveness Conflict Risk

The niche is unmistakable (Positron UI stylized SVGs) and the description actively reduces conflict risk with "do not use for diagrams that are not representations of the product UI", which separates it from generic diagramming/illustration skills. It matches 'clear niche with distinct triggers; minimal conflict risk'.

5 / 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
posit-dev/positron
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.