Communitygithub.com

Stick-Szene

Erstelle kleine handgezeichnete Strichmännchen-Szenen für Landingpages und Websites, in denen ein Strichmännchen eine Maschine oder ein Requisit bedient, das zeigt, was ein Produkt tut (einen Hebel ziehen, eine Notiz anheften, eine Seite stempeln). Jede Szene ist ein interaktives Canvas-Widget, `<stick-scene>`, das im Leerlauf ruhig vor sich hin arbeitet und bei Klick, Hover oder beim Hineinscrollen eine kurze Aktion abspielt.

Was ist Stick-Szene?

Dieses Skill ermöglicht es dir, interaktive, handgezeichnete Strichmännchen-Animationen zu erstellen, die die Funktionsweise eines Produkts auf spielerische und einprägsame Weise demonstrieren. Jede Szene ist ein eigenständiges `<stick-scene>`-Element, das ohne externe Abhängigkeiten auskommt und auf einem Canvas basiert. Die Animationen sind im unverwechselbaren Tinten-und-Butter-Stil von Kamran gehalten und umfassen einen Idle-Zustand (Atmen, Blinzeln, Kratzen am Kinn) sowie eine kurze, 5–8 Sekunden dauernde Aktion, die bei Benutzerinteraktion ausgelöst wird. Das Skill eignet sich ideal für Landingpages, auf denen komplexe Produkteigenschaften auf einen Blick verständlich gemacht werden sollen. Es wird mit einem umfangreichen Werkzeugsatz geliefert, darunter ein Runtime-Script, eine Vorlage für neue Szenen, Skripte zur Überprüfung von Standbildern und Bewegungsabläufen sowie eine Referenz mit Metaphernkatalog und Kochrezepten. Das Skill unterstützt die Plattformen Claude Code, Cursor und Codex und ist besonders nützlich, wenn ein Benutzer nach einer Strichmännchen-Animation, einer Arbeiterszene oder einem animierten Erklärwidget für eine Landingpage fragt.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nilbuild/stick-scene/tree/HEAD

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Stick-Szene?

Ein Strichmännchen in Kamrans Tinten-und-Butter-Stil erledigt eine Aufgabe, die zeigt, was ein Produkt tut. Die Szene verharrt im Leerlauf (atmet, blickt umher, kratzt sich am Kinn) und spielt bei Auslösung eine 5–8 Sekunden dauernde Aktion ab, um dann wieder in den Ruhezustand zurückzukehren. Es handelt sich um ein einzelnes <canvas>-Element innerhalb eines <stick-scene>-Elements, ohne Abhängigkeiten.

Alles hier ist auf ~90 Szenen auf kamranahmed.info/story erprobt. Folge diesen Mustern; erfinde keinen neuen Zeichenstil.

Dateien

  • runtime/stick.js: die gesamte Laufzeit. Das Rig (Figur, Posen, Easing, Stift), eine Sammlung von Requisiten, die Bühne und das <stick-scene>-Element. Kopiere es unverändert in den statischen Ordner des Projekts.
  • templates/scene.js: der Ausgangspunkt für eine neue Szene.
  • templates/preview.html + scripts/frames.mjs: rendert eine Szene, die an ausgewählten Zeitpunkten eingefroren ist, in einen Kontaktabzug und meldet Fehler.
  • scripts/motion.mjs: führt eine Szene mit 60 fps aus und meldet Probleme, die ein Standbild verbergen kann: Gelenke, die rucken, ein Arm durchs Gesicht, ein Requisit, das über einen Kopf gezeichnet wird, ein Ellenbogen, der falsch herum absteht oder nach hinten ragt, eine gequetschte Drehung, schlurfende Füße, eine Hand, die zu kurz kommt, und ein Sprung zu Beginn oder Ende der Aktion.
  • references/craft.md: API-Spickzettel, Posen-Kochbuch, Timing-Rezept, Requisiten-Rezepte, Metaphernkatalog und die bereits gemachten Fehler. Lies es, bevor du eine Szene schreibst.
  • examples/: echte Szenen. diffity-review.js (Kommentar → Agent repariert → bestätigen, zwei Figuren, ein Whiteboard und ein Schreibtisch) ist das sauberste vollständige Beispiel. scenes-p3.js und scenes-p4.js enthalten ~30 weitere; der Metaphernkatalog in craft.md gibt an, welche Szene welche ist.

Arbeitsablauf

  1. Verstehe das Produkt. Jeweils ein Satz: Was der Benutzer tut, was er bekommt. Lies die Landingpage oder README, falls vorhanden.
  2. Schlage 2–3 Metaphern vor und lass den Benutzer wählen, es sei denn, er hat dich gebeten, einfach loszulegen. Ein Satz pro Idee: das Requisit, die Aktion, der Nutzen. Eine gute Metapher ist physisch (Hebel, Stempel, Förderband, Pinnwand, Bilderschiene, Kistenstapel), auf einen Blick ohne Bildunterschrift verständlich und endet mit einem sichtbaren Ergebnis (ein Häkchen, ein Stempel, etwas, das aufsteigt oder aufleuchtet). Siehe den Katalog in craft.md.
  3. Schreibe die Szene ausgehend von templates/scene.js. Platziere zuerst Requisiten in festen Weltkoordinaten, dann den Leerlauf, dann die Aktion als Zeitlinie über T Sekunden. Gib label einen einfachen Satz für Screenreader.
  4. Überprüfe sie mit dem Kontaktabzug. Sieh dir jeden Abzug an, bevor du die Szene für fertig erklärst:
    # einmalig, in einem Scratch-Verzeichnis:  npm i [email protected]
    NODE_PATH=<scratch>/node_modules node <skill-dir>/scripts/frames.mjs \
      --scene <id> --src pfad/zu/scene.js \
      --frames "idle:0,idle:2.5,s:0.8,s:1.6,s:2.4,s:3.2,s:4.0,s:5.0" --fw 400 --out /tmp/<id>.png
    
    <skill-dir> ist der Ordner, in dem sich diese SKILL.md befindet. Lies dann das PNG. idle:<sek> friert die Leerlaufschleife ein, s:<sek> einen Moment in der Aktion, u:<0..1> einen Bruchteil davon. Füge @<n> hinzu, um die n-te Wiedergabe zu rendern (s:2.4@1), damit Szenen, die mit S.n variieren, in jeder Variante überprüft werden. Korrigiere und rendere neu, bis: nichts an den Rändern abgeschnitten ist, kein Requisit ein Gesicht oder das zu erklärende Objekt verdeckt, jede Bewegung für sich allein lesbar ist, Text innerhalb seiner Box mit Platz oben und unten sitzt, Hände vor dem sind, was sie halten, gehaltene Objekte den Körper dort treffen, wo ein echtes Objekt es tun würde (ein Mikrofon am Mund, ein Griff in der Handfläche), Pfeile handgezeichnete Winkel sind, keine gefüllten Dreiecke, und das letzte Bild mit dem Leerlauf übereinstimmt (kein Sprung beim Zurückschleifen). Zwei oder drei Runden sind normal. Überprüfe dann die Bewegung, die der Abzug nicht zeigen kann:
    NODE_PATH=<scratch>/node_modules node <skill-dir>/scripts/motion.mjs --scene <id> --src pfad/zu/scene.js
    
    Behebe jeden Sprung (verwende eine Überblendung der Pose anstatt eines Wechsels), Arm-durch-Gesicht, Kopf-bedeckt (ein Requisit, eine Notiz oder eine Sprechblase über einem Gesicht), Ellenbogen-rückwärts, Ellenbogen-hinten (ein Arm wie ein gebrochener Flügel, länger als einen Moment gehalten), Quetschung, Start-Sprung und End-Sprung, bis "Bewegung ist sauber" ausgegeben wird. Ein kurzes Schlurfen ganz am Anfang oder Ende eines Gangs ist in Ordnung.
  5. Binde sie ein. Kopiere runtime/stick.js und die Szenendatei in den statischen Ordner der Website und füge hinzu:
    <stick-scene scene="<id>" play="view" style="height:230px; max-width:560px"></stick-scene>
    <script src="/scenes/stick.js" defer></script>
    <script src="/scenes/<id>.js" defer></script>
    
    In Astro verwende <script is:inline ... defer>. stick.js muss in der Dokumentreihenfolge vor jedem Szenenskript stehen (deferierte Skripte werden in der Reihenfolge ausgeführt und Szenen lesen window.RIG beim Laden). Auf einer Landingpage mit mehreren Szenen platziere jede in einem Rahmen, damit sie nicht auf einer bloßen Grundlinie schwebt: eine abgerundete Karte mit 1px Rahmen, weißem Hintergrund, einem schwachen Punktgitter (radial-gradient(#e6e6e6 1px, transparent 1.2px) bei 14px) und der Bodenband bleibt aktiviert (kein no-floor); die Grundlinie verläuft dann von Kante zu Kante wie eine kleine Bühne. Gib jeder Szene auf der Seite denselben Rahmen und die volle Inhaltsbreite. Lade dann die echte Seite in einem kopflosen Browser, scrolle das Element in den sichtbaren Bereich, warte ~3 s und mache einen Screenshot in Desktop- und Telefonbreite.

Das Element

  • scene: die ID, die als SCENES['<id>'] registriert ist.
  • play: view (spielt einmal ab, wenn es zur Hälfte sichtbar ist, dann bei Klick; beste Voreinstellung für Landingpages), click, hover (schleift, solange die Maus darüber ist, Klick auf Touch), loop (läuft immer, sparsam verwenden), idle (spielt nie ab).
  • no-floor: entfernt das hellgraue Band unter der Grundlinie. Verwende es auf weißen Seiten. no-ground: entfernt auch die Linie.
  • zoom: skaliert die Zeichnung innerhalb der Box nach oben oder unten (Standard 1).
  • label oder aria-label: was die Szene zeigt. Standard ist das label der Szene.
  • no-font: lädt Balsamiq Sans nicht von Google Fonts (wenn die Website es bereits selbst hostet oder Google nicht aufrufen darf).
  • Größe mit CSS anpassen. Die Zeichnung passt sich der Höhe an (230px ist die native Größe) und der width der Szene in Welteinheiten, zentriert.
  • Reduzierte Bewegung zeigt ein einzelnes Standbild und spielt nie ab. Szenen außerhalb des Bildschirms werden nicht gezeichnet.
  • STICK.theme({ butter: '#…', greenInk: '#…' }) tauscht die Palettenfarben für die gesamte Seite aus. Bevorzuge lokale Farbkonstanten in der Szene (wie die GitHub-Hinzufügen/Löschen-Grüntöne in diffity-review.js), wenn nur eine Szene sie benötigt.

Stilregeln

  • Tinte #141414, weiße Papierfüllungen, eine Butter- oder Akzent-Hervorhebung, viel leerer Raum. Balsamiq Sans bei 8.5–11px für Wörter, und nur wenige Wörter.
  • Die Figur ist der Held: Verstecke niemals ihren Kopf oder die aktive Hand hinter einem Requisit. Zeichne zuerst Requisiten, dann Figuren, dann gehaltene oder fliegende Objekte.
  • Eine Idee pro Szene. Wenn du eine Bildunterschrift zur Erklärung benötigst, ist die Metapher falsch.
  • Zeige das Ergebnis, nicht die Arbeit: Ende mit etwas, das seinen Zustand geändert hat und für einen Moment so bleibt.
  • Physische Objekte vor gezeichneten Tieren oder detaillierten Charakteren. Eine zweite Figur (ein Helfer) erhält eine einzelne Farbe über ink/far. Ein KI-Agent ist ein Roboter: fig(..., { ink: '#d97757', far: '#e8b7a3', bot: { col: '#d97757', dark: '#a8553a', glow, blink, happy } }) zeichnet einen abgerundeten Kopf mit einem dunklen Visier und leuchtenden Augen, Ohrbolzen, einer Antennenbirne und einem Brustlicht. Ein zweiter Agent wird in Türkis gehalten (#3d7a8c, dunkel #2a5866, far #a9c9d1). Ein schwarzer Agent funktioniert auch: eine dunkle col erhält automatisch ein weißes Visier und Tintenaugen. Licht glow, während er arbeitet, happy, wenn er fertig ist, und platziere ein kleines Label (du, agent, claude) unter jeder Figur bei y = 16.
  • Agenten sollten nicht sofort reagieren. Halte einen Moment inne, nachdem eine Anfrage eintrifft (eine denke...-Linie, eine hmm...-Blase, eine Hand am Kinn, ein langsames Antennenblinzeln), bevor die Arbeit beginnt.
  • Verwende keine Logos anderer Unternehmen. Produktnamen als Klartext auf einem Requisit sind in Ordnung.

Verwandte Skills