positron-abstract-svg

Create or update abstract SVG illustrations for the Positron IDE -- for use in documentation, walkthrough steps, onboarding images, and feature previews. Use this skill whenever someone asks to make, update, or redesign an SVG image for Positron docs, walkthroughs, or any visual asset representing the Positron IDE UI. Also use it when asked to make images "consistent" with existing Positron walkthrough images, or to add a new image to match an existing set. Trigger on: "make an SVG for the walkthrough", "create an abstract image for the notebook feature", "update the hero image", "make it look like the other Positron SVGs", "add a docs image for X feature".

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

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

The body is well-structured and highly actionable, with executable code and real, one-level-deep references that keep the overview lean. It is slightly more verbose than strictly necessary in a few explanatory passages and relies on visual rather than programmatic validation, but the structure and guidance are strong.

Suggestions

Tighten the prose rationale sections (e.g., 'The activity bar always gets real icons' and the Seti color discussion) to bullet-level rules so each token more directly drives an action.

Make the preview/validation checkpoint in the workflow more explicit (e.g., 'Preview is the validation gate: do not save until the render matches the intended layout on both light and dark backgrounds').

Consider moving the large color-palette table into references/patterns.md and keeping only the handful of load-bearing colors (accent, illustration blue, icon gray, placeholder grays) inline.

Dimension	Reasoning	Score
Conciseness	Content is dense and largely assumes Claude's competence with SVG and IDE concepts, with necessary reference material (palette table, font stacks) earning its place; a few prose passages (activity-bar rationale, Seti color discussion) are slightly more explanatory than strictly required, keeping it just below the leanest anchor.	4 / 5
Actionability	Provides fully executable, copy-paste-ready guidance: concrete hex values, SVG snippets for placeholders and syntax highlighting, a complete runnable fontTools script for Seti extraction, and pointers to copy-pasteable component patterns covering the common cases.	5 / 5
Workflow Clarity	A clear 6-step workflow (gather, plan, sketch, preview, iterate, save) with an explicit preview checkpoint and iterate loop plus a cleanup-before-save step; validation is visual rather than programmatic, which fits an image-generation skill but leaves the validation checkpoint slightly less explicit than the top anchor.	4 / 5
Progressive Disclosure	SKILL.md is a concise overview that pushes bulk detail (icon paths in references/codicons.md, component snippets in references/patterns.md, ground-truth examples in references/examples/) one level deep, with clearly signaled section names for navigation; all referenced paths resolve to real bundle files.	5 / 5
	Total	18 / 20 Passed

Description

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

The description is a strong, third-person statement that pairs a concrete capability statement with explicit, natural-language trigger guidance and example phrases. It clearly answers both what the skill does and when to invoke it, with minimal conflict risk against other skills.

Dimension	Reasoning	Score
Specificity	Lists concrete actions ('Create or update abstract SVG illustrations') and enumerates concrete use contexts (documentation, walkthrough steps, onboarding images, feature previews), giving comprehensive coverage of the skill's capabilities.	5 / 5
Completeness	Explicitly answers both 'what' (create/update abstract SVG illustrations for the Positron IDE) and 'when' ('Use this skill whenever...' plus concrete 'Trigger on' phrases), matching the top anchor.	5 / 5
Trigger Term Quality	Provides natural user phrases plus a dedicated 'Trigger on:' list ('make an SVG for the walkthrough', 'update the hero image', 'make it look like the other Positron SVGs', 'add a docs image for X feature'), covering synonyms and variations users would actually say.	5 / 5
Distinctiveness Conflict Risk	Carves a clear niche (abstract SVGs of the Positron IDE specifically) with distinct triggers like 'make it look like the other Positron SVGs', minimizing overlap with generic image or documentation skills.	5 / 5
	Total	20 / 20 Passed

Validation

100%

Warnings & errors only

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
Path: .claude/skills/positron-abstract-svg/SKILL.md
Commit: 9bb0f27

Reviewed: about 22 hours ago

Table of Contents

Discovery Implementation Validation

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.