Przejdź do treści
Biblioteka skilli
Projektowanie i UX · Budowanie i kod

figure

/figure

Dodaje lub zmienia diagram w plikach Markdown repozytorium, jako blok Mermaid albo obraz Archify, także po zmianie tekstu.

Repozytorium
skills ↗
Licencja
MPL-2.0
Ostatnia zmiana repozytorium
12.11.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
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

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

Licencja

MPL-2.0, otwarta.

Co robi i kiedy

Dodaje lub zmienia diagram w plikach Markdown repozytorium, jako blok Mermaid albo obraz Archify, także po zmianie tekstu.

Wyzwalacze z opisu

a picture of
Oryginalny opis (EN)

Add, change or explain a diagram in this repo's Markdown (README.md, README.en.md, docs): a Mermaid fence or an Archify picture. Use when asked for a diagram, flowchart, mind map or 'a picture of' something, or to update one after its prose changed.

Jak działa

  1. Steps
  2. Visual grammar, the same in every figure
  3. A picture drawn with Archify
Sekcje z nagłówków SKILL.md, w oryginale · 70 linii, 633 słów
Podgląd SKILL.md
---
name: figure
description: "Add, change or explain a diagram in this repo's Markdown (README.md, README.en.md, docs): a Mermaid fence or an Archify picture. Use when asked for a diagram, flowchart, mind map or 'a picture of' something, or to update one after its prose changed."
---

# figure

A diagram is a ```` ```mermaid ```` fence in the page it illustrates; GitHub draws it there. Every
fence has a header and a reading card.

## Steps

1. **Read the prose the figure sits beside.** Draw only what it says; the text is the source of
   truth and a figure that disagrees with it is a bug in the figure. If the page has a twin in
   the other language (`README.md` and `README.en.md`), both figures say the same.
2. **Write the fence.** First two lines, which Mermaid ignores:

   ```
   %% figure: <id>          lowercase words joined by '-', unique in the repo
   %% title: <question>     the question the figure answers
   ```

   Then the diagram, at most about 15 nodes; split it rather than grow it.
3. **Write the reading card** right after the closing fence, in the page's language:

   ```
   <details open>
   <summary>How to read this figure</summary>     (pt-BR: Como ler esta figura)

   **Takeaway.** one plain sentence, what to remember        (Em uma frase.)
   **How to read.** direction, what shapes and arrows mean   (Como ler.)
   **Not shown.** what was left out on purpose               (Fora da figura.)
   **Evidence.** file, paragraph or command, with ⚠ if unchecked  (Evidência.)

   </details>
   ```

   `open` keeps the explanation visible under the diagram; a reader should never have to find it.
   Each label is its own paragraph (blank lines between). The takeaway has no jargon. Evidence
   names the file or section the figure summarises; a discrepancy found between figure and text,
   or a claim not checked, is stated there with ⚠, not hidden.
4. **Check** that every node and label traces to a file you read. Never remove a ⚠ without doing
   the check.

## Visual grammar, the same in every figure

- Rectangle: a thing or a step. Diamond: a test, written as a question. Every test labels both
  its *yes* and its *no* edge.
- Solid arrow: makes or leads to the next thing. Dashed arrow (`-. label .->`): checks, tests or
  compares against. Label every arrow that is not obvious from its two ends.
- No self-loops: an arrow from a box back to itself says nothing about what it is compared with.
  Draw the check as a dashed arrow to the thing it is checked against.
- Number boxes that happen in order (`1 ·`, `2 ·`) so the sequence reads without the arrows.
- One flow direction per figure (`LR` or `TD`); groups (`subgraph`) for stages.
- Leave `classDef`, `style` and `%%{init}%%` out. A colour never carries meaning on its own; the
  label or shape says it.

## A picture drawn with Archify

For a flow that a Mermaid fence draws badly, draw a picture. Write the source as
`docs/archify/<slug>.json` and run `just figure`: the vendored `archify` skill (`.claude/skills/archify`,
a pinned submodule that is not part of the plugin) validates and checks it, picasso's look is set
over it and `docs/img/<slug>.png` is taken. `just figure-init` checks the submodule out once;
`just figure-check` fails when a source has no PNG or changed since it.

- Commit the JSON, `docs/archify/figures.lock` and the PNG; never the HTML (`build/`).
- Write the English twin `docs/archify/en/<slug>.json`: the same JSON with `meta.locale` `en` and only the words
  translated (title, lanes, labels, sublabels, tags). `README.md` embeds `docs/img/<slug>.png`; `README.en.md`
  embeds `docs/img/en/<slug>.png`. If a translated label breaks the layout, shorten the label; never move a box.
- Embed the PNG by its relative path with an alt text that says what it shows, and put the same
  reading card under it, in every language of the page. At most about 10 boxes, short labels, no jargon.
- Look at the PNG at full size and shrunk to 800 px wide before you commit it: every label must read.
- Every box and label traces to a file you read; the card's evidence names it.

Wersje

RepozytoriumWynikLicencja
Ta strona · piabrota/skills100MPL-2.0
vectorize-io/hindsight100MIT
piabrota/nix-os100MPL-2.0
richard-kim-79/archora-skills100MIT

Migawka bazy z 13.11.2026 · wersja paczki 89a631e78d89 (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

  • 90archify-diagram-design
    Zamienia poradnik w jedną interaktywną stronę HTML z klikalnymi schematami, osią czasu i eksportem jako długi obraz.
  • 86mermaid
    Renderuje diagram Mermaid w terminalu za pomocą termaid, także z pliku lub dokumentu Markdown, i sprawdza jego poprawność.
  • 90svg-diagram
    Rysuje mapę architektury lub repozytorium jako jeden plik SVG do README: ciemna siatka, kolory części i legenda.
  • 90import-mermaid
    Przerysowuje diagram Mermaid w stylu AWS, w wybranym formacie i poziomie szczegółowości, np. do README.
  • 90mono-figure
    Rysuje statyczny rysunek wyjaśniający (linie, strzałki, liczby, etykiety) do artykułu lub README w stylu mono-color, jako SVG lub przez generowanie obrazu w Codex.
  • 9009-mermaid
    Tworzy poprawny diagram Mermaid z opisu architektury, cyklu życia lub przepływu, w pętli planu, generowania i przeglądu.

Uwagi i zgłoszenia

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