simplediagrams-basic-shape-skill
/simplediagrams-basic-shape-skill
Creates and revises hand-drawn SVG shapes for SimpleDiagrams, with the data-sd-fill / data-sd-stroke color markings used by Convert to Editable Shape. Use for flat or isometric shapes, matching sets, reference redraws, and fill or line-color repairs.
- Author
- mcquilleninteractive ↗
- Repository
- simplediagrams-basic-shape-skill ↗
- Licence
- MIT
- Last repository change
- 23.10.2026
Assessment and security
- Files in this package
- 6
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 23.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Creates and revises hand-drawn SVG shapes for SimpleDiagrams, with the data-sd-fill / data-sd-stroke color markings used by Convert to Editable Shape. Use for flat or isometric shapes, matching sets, reference redraws, and fill or line-color repairs.
Original author description
Creates and revises hand-drawn SVG shapes for SimpleDiagrams, with the data-sd-fill / data-sd-stroke color markings used by Convert to Editable Shape. Use for flat or isometric shapes, matching sets, reference redraws, and fill or line-color repairs.
How it works
- References
- Workflow
- Rules
- Paint recipes
SKILL.md preview
---
name: simplediagrams-basic-shape-skill
description: Creates and revises hand-drawn SVG shapes for SimpleDiagrams, with the data-sd-fill / data-sd-stroke color markings used by Convert to Editable Shape. Use for flat or isometric shapes, matching sets, reference redraws, and fill or line-color repairs.
license: MIT
---
# Create SimpleDiagrams hand-drawn SVGs
Deliver SVG files that SimpleDiagrams for macOS (5.0.7 or later; checked against 5.1.0) turns into editable shapes through **Convert to Editable Shape**, with fills and outlines that follow the diagram's fill and line colors. The same file works dropped on the canvas or added to a library.
## References
- [references/simplediagrams-svg-contract.md](references/simplediagrams-svg-contract.md): color markings, paint roots, starting colors and library settings, the authoring subset and the app's limits, unmarked files, failure patterns. Read before writing or repairing markings.
- [references/hand-drawn-geometry.md](references/hand-drawn-geometry.md): line construction, isometric projection, visual check. Read before drawing or changing linework.
- [references/request-patterns.md](references/request-patterns.md): reference redraws, revisions, sets, fixed accents, cutouts, labels.
- [assets/shape-template.svg](assets/shape-template.svg) is the structural starting point; [assets/example-potted-plant.svg](assets/example-potted-plant.svg) is a complete example.
Never present output as legally cleared, and do not trace or adapt SimpleDiagrams stock shapes or third-party artwork for redistribution. A substantial copy of a bundled asset keeps its MIT notice.
## Workflow
1. Settle the subject, view, placed size and details. Defaults: one shape per SVG, transparent background, white fills, black strokes of width 1, subtly wavy lines. Save where asked, otherwise in `output/`. Ask only when a missing choice changes the result materially.
2. Build clean baseline geometry. For isometric work, fix the projection and shared edges first. Wherever one part sits in front of another, work out what a viewer would actually see and remove the rest.
3. Give every part one of the paint recipes below.
4. Add the hand-drawn character in the path coordinates.
5. Validate, and again after every edit. The script is in this skill's directory and needs Python 3.10+:
```bash
python3 scripts/validate_svg.py path/to/shape.svg --strict
```
6. Render at placed size, about 2×, and thumbnail size, and run the visual check in the geometry reference.
7. If SimpleDiagrams is available, run the import test in the contract.
8. Deliver the SVG, a preview if one was rendered, and a statement of which checks were actually performed: validator, visual, real import. If a tool was unavailable, deliver anyway and name the unperformed check; for example, "Validator passed; preview inspected; import not tested."
## Rules
- Root `<svg>`: SVG namespace, positive `width` and `height`, matching `viewBox`.
- Only `path`, `rect`, `circle`, `ellipse`, `polygon`, `polyline`, `line` and `g`, plus `title` / `desc`. No CSS, references, clipping, masks, filters, gradients, patterns, images, text, scripts or `vector-effect`.
- Colors are `none`, `black`, `white` or hex.
- Every drawable has an explicit `fill` and `stroke`, its own or inherited. An absent paint is `none`, never zero width or transparent.
- Every painted channel carries a `data-sd-fill` / `data-sd-stroke` marking. Write `keep` on fixed parts.
- An element with a chip marking declares both `fill` and `stroke` itself. It is a paint root and inherits neither.
- A body's fill and outline are on the same closed drawable: `fill="#ffffff"`, `stroke="#000000"`. No fill-only face under a separate outline.
- `stroke-width="1"`, round caps and round joins on every stroke, and at least one stroked drawable per file.
- Path data: commands and plain numbers, separated by spaces or commas. Start every subpath with an absolute `M`, including the one after a `Z`.
- Faces that share an edge use identical coordinates for it.
- Draw only what is visible. Never paint a nearer part over a farther one: cut hidden lines and areas out of the geometry.
- Transparent background. No canvas-sized rectangle.
- Waviness lives in path coordinates and never changes an edge's average direction or endpoints.
## Paint recipes
Body, following the fill and line colors:
```xml
<g data-sd-fill="fill-chip" data-sd-stroke="stroke-chip"
fill="#ffffff" stroke="#000000" stroke-width="1"
stroke-linecap="round" stroke-linejoin="round">
<path d="...Z"/>
</g>
```
Open line, following the line color:
```xml
<g data-sd-fill="keep" data-sd-stroke="stroke-chip"
fill="none" stroke="#000000" stroke-width="1"
stroke-linecap="round" stroke-linejoin="round">
<path d="..."/>
</g>
```
Solid ink detail such as a dot, following the line color:
```xml
<g data-sd-fill="stroke-chip" data-sd-stroke="keep"
fill="#000000" stroke="none">
<path d="...Z"/>
</g>
```
Fixed accent. The color stays as drawn; it is not a third editable color, so say so when a user asks for one:
```xml
<path d="...Z" data-sd-fill="keep" data-sd-stroke="stroke-chip"
fill="#f2a900" stroke="#000000" stroke-width="1"
stroke-linecap="round" stroke-linejoin="round"/>
```
If SimpleDiagrams behaves differently from the contract, keep the artwork, report what was observed, and trust the real import.
Files in this package (6)
- .gitignore 1 KB
- LICENSE 1 KB
- PRIVACY.md 1 KB
- README.md 4 KB
- SECURITY.md 1 KB
- SKILL.md 5 KB
Versions
The database has no other skills named simplediagrams-basic-shape-skill.
Database snapshot: 13.11.2026 · package version bb150991b4c2 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100svg-design
Generates and edits SVG logos, icons, and graphics. Use for writing path data, combining shapes, applying transforms, optimizing SVGs, and managing GPU acceleration techniques. Always uses hand-written SVG code like clean markup, never exports from design tools. - 100svg-animation
This skill should be used when the user asks to "animate an SVG", "make a line draw itself on", "do a stroke draw-on / signature animation", "morph one shape into another", "move an element along a path", "animate an icon/logo", or "animate an SVG gradient or filter". Covers… - 100svg-animations
Animate SVGs with SMIL, CSS keyframes, stroke drawing, shape morphing, and motion paths. Use when adding motion to SVGs such as spinners, logos, draw-in effects, or morphing icons, not for static drawing or icon layout. - 100image-to-svg
Convert raster images (photos, paintings, illustrations, line art) into SVG vector reproductions. Use when the user uploads an image and asks to reproduce, vectorize, trace, or convert it to SVG. Also use when asked to decompose an image into shapes, create an SVG version of a…