Przejdź do treści
Biblioteka skilli
Projektowanie i UX · Nauka i wyjaśnianie

sketch-concept

/sketch-concept

Rysuje odręczną ilustrację SVG wyjaśniającą jeden mechanizm techniczny, np. kolejki, cache lub retry, do wpisu lub prezentacji.

Repozytorium
claude-toolkit ↗
Licencja
MIT
Ostatnia zmiana repozytorium
26.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
3
Skrypty
2
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 2 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/sketch.py, scripts/test_sketch.py

Co robi i kiedy

Rysuje odręczną ilustrację SVG wyjaśniającą jeden mechanizm techniczny, np. kolejki, cache lub retry, do wpisu lub prezentacji.

Oryginalny opis (EN)

Draw a hand-drawn SVG illustration that explains one technical mechanism or data insight — architecture, concurrency, storage, caching, queues, retries — for a blog post, doc, or slide. Use when asked for an illustration, a hand-drawn or Excalidraw-style visual, or a picture that makes one engineering idea click. Do NOT use for answering in-chat with a text diagram (use show-me), for charts of real data (use dataviz), or for an animated or interactive step-by-step walkthrough of your own system (use mechanism-viz).

Jak działa

  1. Steps
  2. Optional: an image-model draft
Sekcje z nagłówków SKILL.md, w oryginale · 106 linii, 1 041 słów
Podgląd SKILL.md
---
name: sketch-concept
description: Draw a hand-drawn SVG illustration that explains one technical mechanism or data insight — architecture, concurrency, storage, caching, queues, retries — for a blog post, doc, or slide. Use when asked for an illustration, a hand-drawn or Excalidraw-style visual, or a picture that makes one engineering idea click. Do NOT use for answering in-chat with a text diagram (use show-me), for charts of real data (use dataviz), or for an animated or interactive step-by-step walkthrough of your own system (use mechanism-viz).
compatibility: Python 3.10+, stdlib only; Chromium or Chrome for `sketch.py check`.
---

# sketch-concept

One figure, one idea, in the notation the reader already knows, drawn with a wobbly pen. `scripts/sketch.py`
(paths are relative to this skill's directory) draws it as static SVG and checks it in a real browser at phone
and desktop width, light and dark.

## Steps

1. **Choose the story.** Write the picture as `actor → decision or absence → visible consequence`, e.g. a file
   read → one chunk is missing → only that chunk is fetched. Contrast is the lesson → a before/after pair, or
   columns that differ in one place. One data path → three objects, left to right. Layers are the lesson → a
   stack, top to bottom. A trend is the lesson → its shape, hand-drawn, without real values. Done when the line
   names one consequence a reader can point at.
2. **Pick the glyphs.** The field has a standard notation → draw it: the reader's mental map is already built
   from it, and a metaphor makes them translate. It has none → one physical metaphor per kind of thing, reused
   for every instance. Done when each glyph is the usual one or a consistent metaphor, and the claim shows in
   the composition (a colour, a position, a missing item), not only in the caption.

   | Thing | Glyph | Pen |
   |---|---|---|
   | container | box standing on a shared host-kernel bar | `box` |
   | VM, microVM | dashed boundary around the app and its own guest-kernel strip | `box(dash="7 6")` |
   | disk, object storage | cylinder | `cylinder` |
   | memory, page cache | module with pins | `memory` |
   | queue | row of slots | one `box` per slot |
   | request or data flow | straight arrow; one big curved arrow for retry, timeout or feedback | `arrow(bend=...)` |
   | more of the same | three dots | `dots` |

3. **Draw.** Write a script against `Pen`; this one passes `check`:

   ```python
   import sys; sys.path.insert(0, "<skill dir>/scripts")
   from pathlib import Path
   from sketch import Pen, page

   p = Pen(seed=3)
   for x, name in ((24, "app A"), (100, "app B")):           # containers stand on the host kernel
       p.box(x, 44, 64, 70, fill="sky")
       p.text(x + 32, 84, name, maxw=56)
   p.box(188, 16, 156, 108, fill="wash", dash="7 6")         # the VM boundary
   p.text(266, 36, "microVM", size=13, color="ink-2", maxw=140)
   p.box(204, 46, 124, 34, fill="sky")
   p.text(266, 68, "app C", maxw=110)
   p.box(204, 86, 124, 28, fill="ochre")                     # its own kernel
   p.text(266, 105, "guest kernel", maxw=110)
   p.box(16, 134, 328, 36, fill="lavender")
   p.text(180, 157, "host kernel", maxw=300)
   fig = p.svg(360, 186, label="Two containers share the host kernel; a microVM runs its own guest kernel")
   Path("kernels.html").write_text(page(fig, "Kernels", caption="Containers share the host kernel; a microVM brings its own."))
   ```

   - Units are CSS px at full size, and later calls paint on top. `text` takes the baseline: centre a label in
     a box at its middle + size × 0.35. Give every label `maxw`, the room it has.
   - Start the viewBox near 360 wide: a 375 px phone gives the figure about 343 px, and 14-unit labels must
     still render at 11 px or more.
   - Colours are palette names: `paper ink ink-2 wash card lid sky sky-2 lemon ochre coral lavender`. Ink reads
     on every fill in both modes; muted `ink-2` only on paper, wash and card. Use four or five fills, give each
     one meaning (lemon = shared), and name that meaning in the caption.
   - Labels are a word or three; sentences go in the caption. No gradients, logos, glossy UI or second claim.
   - Patrick Hand and Virgil draw Latin script only. For CJK or another script, add a hand font that covers it,
     e.g. `svg(font="'Patrick Hand', 'ZCOOL KuaiLe', sans-serif")`, and its stylesheet link to `page(head=...)`.
   - `svg()` returns one self-contained `<svg>` (no `<style>` or script) that pastes into any page and falls
     back to the light palette. A host page gets dark mode by adding `sketch.TOKENS_CSS` to its stylesheet;
     `page()` already includes it.

   Done when every label has `maxw`, the `label` alt text states the claim, and the seed is fixed: the same
   calls give the same bytes.
4. **Check.** Run it on the figure page, then on the page that embeds the figure, whose column, fonts and
   theme are what readers see. `check` opens a local file: if that page links root paths like `/style.css`,
   check a copy whose links are relative.

   ```bash
   python3 scripts/sketch.py check kernels.html --shots shots/
   ```

   Each `FAIL` line names one fault and, when it is not everywhere, the widths and modes it shows in; the last
   line is `CHECK OK` or `CHECK FAILED` (exit 1). On the embedding page it reads every `<svg>`, diagrams you
   did not draw included; act on the lines about yours. Change the drawing, not the check:

   - label too wide, overlapping or past the edge → shorter words first, then move or widen the box;
   - text below 11 px → fewer, larger labels or a narrower viewBox, never smaller text;
   - contrast → `ink`, or muted text only on paper, wash or card;
   - a font missing, or characters no listed font has → load a font that covers them;
   - drawing past the viewBox → widen the viewBox;
   - `warn … same in dark mode` → add `TOKENS_CSS` to the page.

   Then open the four screenshots: arrows point the way the system moves, and the claim reads at 375 px. Done
   when the figure page prints `CHECK OK`, no line from the embedding page is about your figure, and the
   screenshots show the story line from step 1.

## Optional: an image-model draft

When an image-generation tool is available and the composition is still open, a draft can settle it. The final
figure stays SVG drawn with `Pen`: generated text and notation drift. Treat any reference image as style only.

```text
Use case: infographic-diagram
Primary request: Explain [one mechanism] as [the story line from step 1].
Subject: [left / centre / right objects, each in its field's standard notation].
Style: hand-drawn systems sketch; thick wobbly ink outlines; handwritten lettering; flat colours on paper;
generous whitespace; palette [up to five colours].
Text (verbatim): "[label 1]"; "[label 2]".
Constraints: one takeaway; every label legible; no gradients, logos, watermark, dashboards or photorealism.
```
Pliki w paczce (3)
  • SKILL.md 7 KB
  • scripts/sketch.py 30 KB
  • scripts/test_sketch.py 9 KB

Wersje

W bazie nie ma innych skilli o nazwie sketch-concept.

Migawka bazy z 13.11.2026 · wersja paczki b922519806e6 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100excalidraw
    Tworzy i modyfikuje diagramy Excalidraw, porównuje pliki .excalidraw, rysuje szkice w stylu tablicy i architektury oraz eksportuje do SVG lub PNG.
  • 100mechanism-viz
    Planuje i buduje oparte na śladach wykonania wyjaśnienie działania mechanizmu własnego systemu: wpis z animowanymi rysunkami, interaktywny eksplorator odtwarzający jedną rzeczywistą instancję i wykresy benchmarków.
  • 100ideagram
    Zamienia koncepcję, opis funkcji, wpis lub pitch w jedną spójną z marką ilustrację, dopasowując ją do prawdziwej ilustracji unDraw z lokalnej biblioteki i przekolorowując na kolor akcentu marki.
  • 95Excalidraw
    Szkicuje diagramy w stylu odręcznym na lokalnym płótnie Excalidraw przez serwer MCP, z konwersją Mermaid i plikami .excalidraw.
  • 100tldraw
    Rysuje odręczne diagramy w stylu tablicy z opisu słownego i eksportuje je do PNG lub SVG z pętlą poprawek.
  • 90hand-drawn-diagrams
    Tworzy ręcznie rysowane diagramy Excalidraw, przepływy, wyjaśnienia, szkice interfejsów i makiety stron, domyślnie monochromatyczne, z oszczędnym kolorem tylko dla makiet.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.