About creating-svg-illustrations
A workflow skill for creating and validating editable SVG illustrations for slides and documents. It guides authors through layout, accessibility, portability, and renderer checks.
Key features
- 01Slide and document inspection
- 02Editable SVG construction
- 03Accessibility metadata and alt text
- 04Portable asset guidance
- 05SVG validation and rendering checks
Use cases
- 01Create diagrams for presentation slides
- 02Embed SVG illustrations in Marp
- 03Diagnose SVG rendering issues
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ narumiruna/ skills --skill creating-svg-illustrationsAfter installing, type/creating-svg-illustrationsin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
assets/examples/with-diagrams.mdreferences/core-rules.mdembedding.mdpattern-examples.mdtroubleshooting.mdDetails
From the project READMESVG Illustrations
Start with references/core-rules.md; load only the extra detail the artifact needs.
| Need | Read or use |
|---|---|
| Canvas, style, text, accessibility, validation | references/core-rules.md |
| Reusable compositions | references/pattern-examples.md |
| Marp embedding | references/embedding.md |
| Rendering failures | references/troubleshooting.md |
| Known-good deck example | assets/examples/with-diagrams.md |
Workflow
- Inspect the target slide or document, required dimensions, surrounding palette, and renderer.
- Create the smallest editable SVG that communicates the idea. Use a correct
viewBox, explicit text styles, consistent geometry, and SVG title/description where the visual carries meaning. When embedding, also provide descriptive host-level alt text or an adjacent semantic equivalent as required byreferences/embedding.md; internal SVG metadata alone is not sufficient. - Keep assets portable: avoid embedded fonts, unexplained emoji, unnecessary filters, and base64 content unless the output must be self-contained.
- Validate with
svglintwhen available, then open or embed the SVG in the target artifact and inspect clipping, scaling, contrast, text, and relative paths. - Return the SVG artifact first, followed by validation performed and any renderer or font caveat.
Use slide-authoring or color guidance only when the request also requires it. Do not claim visual inspection when only source validation ran, and do not commit or publish the artifact unless requested.
Comments
Markdown supported