Skip to content
Skills Library
Design & UX · Building & coding

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.

Licence
MIT
Last repository change
23.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
6
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 23.10.2026, without references to retired models or APIs.

Licence

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

  1. References
  2. Workflow
  3. Rules
  4. Paint recipes
Original SKILL.md headings · 87 lines, 690 words
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…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.