CommunityCodierung & Entwicklunggithub.com

depth-scroll

Erstellen Sie eine Depth-Scroll-Seite: eine Abfolge von Panels (Zeichnungen, Ein-Ideen-Karten, Phasen), die als Stationen auf einer Tiefenachse angeordnet sind, durch die der Benutzer scrollt – inspiriert von der Landingpage von WhatTheFad.

Was ist depth-scroll?

Depth-Scroll ist ein KI-Assistenten-Skill, der eine spezielle Seitenformat für Inhalte bereitstellt, die der Leser eine nach der anderen **durchscrollen** soll – ähnlich einer durchscrollbaren Tiefenperspektive. Inspiriert von der Landingpage WhatTheFad (whatthefad.netlify.app) erzeugt der Skill eine einzelne HTML-Datei, in der jedes Panel (eine Zeichnung, eine Karte, ein Schritt) als „Station“ auf einer Tiefenachse mit `translate3d` und `perspective` platziert wird. Der Scrollvorgang wird zu einer Kamerafahrt durch den Raum: Die aktuelle Station erscheint gestochen scharf auf dem Bildschirm, die vorherige verschwindet im Hintergrund, und währenddessen fliegt ein Strom von Karten auf den Betrachter zu – ähnlich dem „Trend-Feld“ von WhatTheFad. Der Skill eignet sich für 4 bis 12 in sich abgeschlossene Panels (z. B. erklärende Zeichnungen, Konzeptkarten, Schritte einer Anleitung), aber nicht für lange Texte oder Tabellen. Das Template enthält einen festen Header, eine Steuerungsleiste und einen automatischen Fallback auf eine flache Ansicht, wenn JavaScript deaktiviert ist oder `prefers-reduced-motion: reduce` aktiviert wurde. Die Erstellung erfolgt über eine Spezifikationsdatei (JSON) und ein Build-Skript (`build.py`), das das Template befüllt. Ein Capture-Skript (`capture.mjs`) überprüft die Ausgabe per Headless-Chrome in Echtzeit. Der Skill wird in Claude Code, Cursor, Codex oder ähnlichen KI-Agenten-Umgebungen genutzt. Die Bedienung erfolgt über Auslöser wie „eine Benutzeroberfläche, die auf den Benutzer zuscrollt“, „wie whatthefad“, „lass das auf mich zufliegen“, „depth scroll“, „in den Bildschirm scrollen“ oder die Aufforderung, eine flache Figurenseite in eine Reise umzuwandeln.

Funktioniert mit✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/rafaelcarlosabbariao/skills/tree/HEAD/agnostic/depth-scroll

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

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

Dokumentation

Wenn in diesem Ordner SKILL.local.md existiert, lesen Sie diese zuerst; sie enthält Ihre Pfade, Daten und Hausregeln.

Depth Scroll

Ein Seitenformat für eine Reihe von Figuren, die der Leser eine nach der anderen durchreist. Der erste Bau verwandelte eine Reihe von erklärenden Zeichnungen in einen Scroll auf den Betrachter zu, modelliert nach der Landing-Page von WhatTheFad (whatthefad.netlify.app, Quellcode unter github.com/rafaelcarlosabbariao/cultural-archaeology).

Der Skill enthält vier Dateien:

DateiBeschreibung
template.htmlDie Seite: Stations-Chrome, der Stream, die Schiene und das Skript, das sie betreibt
build.pyBefüllt die Vorlage aus einer Spezifikation, als Befehl oder als Modul
capture.mjsEchtzeit-Headless-Screenshots und Navigationsprüfungen über das DevTools-Protokoll
SKILL.mdDiese Datei

Wann es passt

  • Es passt bei vier bis zwölf in sich abgeschlossenen Panels, die einzeln gelesen werden und jeweils auf einen Bildschirm passen: Zeichnungen, Ein-Ideen-Karten, die Phasen einer Abfolge.
  • Es passt nicht bei langen Texten, Tabellen oder allem, was der Leser nebeneinander vergleichen oder hin- und herscannen muss. Bauen Sie dafür eine flache Seite.
  • Ausgabe. Die Seite ist eine einzige, in sich geschlossene .html-Datei, ohne externe Skripte und ohne WebGL. Die Vorlage enthält eine warme Cremefarben-Tinte-Palette in :root-Tokens; passen Sie diese nach Geschmack an.

Funktionsweise

Das Feld von WhatTheFad, die Quelle

Lesen Sie in WhatTheFads index.html (#landing-trendfield-CSS und die Funktion renderTrendField).

  • Projektion. Das Feld ist ein Container mit perspective: 900px, und jeder Chip wird mit translate3d(x, y, z) platziert. Der Browser zeichnet einen Chip im Maßstab 900 / (900 − z): 0,24 bei z = −2800, 1 auf der Bildschirmebene und 1,3 bei z = 220.
  • Ein Taktgeber treibt die Bewegung an. Eine requestAnimationFrame-Schleife bewegt jeden Chip auf den Betrachter zu, mit 150 px/s multipliziert mit einem pro Chip festgelegten Faktor von 0,75 bis 1,25. Nach z = 220 wird er auf einem elliptischen Ring bei z = −2800 neu erzeugt.
  • Ein- und Ausblendungen und Malreihenfolge. Ein Chip blendet im ersten Viertel seiner Tiefe ein und zwischen z = 60 und 220 aus. Das Feld verwendet nie preserve-3d, daher wird der z-index jedes Chips aus seiner Tiefe gesetzt, sodass der nähere Chip oben gemalt wird.
  • Die ruhige Mitte. Eine radiale mask-image verdeckt die Mitte, wo sich entfernte Chips am Fluchtpunkt sammeln.
  • Einen Chip fangen. Der Browser überprüft :hover nur, wenn sich die Maus bewegt. Ein Chip, der unter einem stillen Cursor hindurchtreibt, leuchtet nie. WhatTheFad testet die Mausposition gegen die projizierten Rechtecke jedes Chips in jedem Frame, und ein gefangener Chip verlangsamt das Feld auf 8%.

Was dieses Format hinzufügt

  • Das Scrollen ist die Kamera.
    • Eine hohe Spur (main.depth) enthält einen Halt pro Station, eine Stufenhöhe voneinander entfernt, mit scroll-snap-type: y proximity.
    • Eine feste Bühne unter dem fixierten Header hält die Szene.
    • Die Scrollposition wird zu einem Stationsindex, ganzzahlig an jedem Halt. Eine Kamera nähert sich ihm sanft (Rate 9 pro Sekunde), und Station i wird bei z = (Kamera − i) × 1400 gezeichnet.
  • Der Durchgang einer Station.
    • Die wartende Station dahinter ist dunkel und sitzt etwas tief, sodass sie beim Vorrücken in Position steigt.
    • Im Ruhezustand ist sie bei z = 0 und Skalierung 1, auf ganzen Pixeln, sodass ihr Text so scharf ist wie eine flache Seite.
    • Wenn sie den Betrachter passiert, blendet sie bei z = 300 mit 1,5× aus.
    • Eine Station, die höher als die Bühne ist, wird skaliert, um hineinzupassen.
  • Der Strom. Das Feld von WhatTheFad, inklusive Maske. Die Geschwindigkeit der Karten beträgt 46 Basis plus 0,9 der Kamerageschwindigkeit, sodass Vorwärtsscrollen sie vorbeisausen lässt und Rückwärtsscrollen sie wegschickt. Eine Station benennt die Kartengruppen, die sie beleuchtet (lit), und diese Karten leuchten auf, solange sie vorne ist.
  • Eingabe.
    • Mausrad, Trackpad, Touch, Pfeiltasten, die Schiene und die Inhalte des Headers bewegen alle den einen nativen Scroll, sodass jede Eingabe an denselben Halten landet.
    • Wenn der Fokus in eine Station gelangt, die nicht vorne ist, scrollt er zu ihr.
    • Der Strom ist dekorativ, und nur die ruhende Station nimmt Zeigerereignisse entgegen, sodass kein Treffertest pro Frame nötig ist.
  • Fallback. Ohne JavaScript oder mit prefers-reduced-motion: reduce wird die Seite flach als gestapelte Stationen dargestellt. Die Tiefe wird durch eine deep-Klasse aktiviert, die das Skript hinzufügt. Im flachen Modus werden die Anker der Inhalte auf die Stationen verschoben.

Erstellen einer solchen Seite

SK unten steht für das Verzeichnis, in dem Sie diesen Skill installiert haben, z. B. ~/.claude/skills/depth-scroll.

  1. Inhalt zuerst. Setzen Sie jedes Panel auf eine flache Seite als <figure class="fig">, die eine .platte (die Zeichnung) und eine figcaption enthält. Die flache Seite ist auch die Lesekopie. Eine Station kann stattdessen rohes html tragen.
  2. Schreiben Sie eine Spezifikation (unten), als JSON-Datei oder als Dictionary im eigenen Build-Skript des Projekts, wenn Werte berechnet werden (z. B. Kartennamen aus einer Datendatei).
  3. Bauen Sie es.
    python3 -I $SK/build.py spec.json
    
    oder aus einem Skript:
    sys.path.insert(0, str(Path.home() / '.claude/skills/depth-scroll'))
    import build
    build.write(spec, base=HIER)
    
  4. Optionaler Header. Die Vorlage lässt Platz für einen fixierten Header (--pin-h, header.pin, nav.pin-toc). Ohne einen solchen beginnt die Bühne am oberen Fensterrand.
  5. Überprüfen Sie es mit capture.mjs (unten), dann committen Sie es.

Die Spezifikation

Pfade sind relativ zu base: dem Ordner der Spezifikationsdatei oder dem an write übergebenen Ordner. Bildpfade werden so in die Seite geschrieben, wie sie angegeben werden; geben Sie sie daher relativ zur Ausgabeseite an.

FeldInhalt
outDie zu schreibende Seite
titleDer <title>, benannt nach Art (<Subject> <Art-Substantiv>)
sourceOptionale flache Seite. Deren figure.fig-Blöcke werden zu fig: n, und ihre Style-Blöcke (nicht die des Headers) werden übernommen, damit die Zeichnungen ihre Klassen behalten
kickerDie kleine Bezeichnung über einer Station auf Abschnittsebene; die Bezeichnung eines Unterabschnitts ist der Name seines Abschnitts
doorHTML der ersten Station: ein Vorwort, ein Hinweis, ein Link zur flachen Seite
stations[]id; sec und/oder sub (die Inhaltszeilen; sec allein ist ein Abschnitt, sub allein ein Unterabschnitt, beide öffnen einen Abschnitt auf dieser Station); title (Standard ist sub, dann sec); lead (HTML, ein oder zwei Sätze); fig oder html; cards ([{img, label}], eine kleine Bildzeile); lit (zu beleuchtende Stromgruppen)
cards_labelDie Bezeichnung am Ende der Bildzeile einer Station
close{title, kicker, html} für die letzte Station, normalerweise die Quellen
stream[]{label, img, group} pro Karte. Vierzig bis achtzig ergeben einen Strom
cssOptionales zusätzliches CSS, zuletzt angehängt

Überprüfung

K=$SK/capture.mjs
node $K file:///pfad/seite.png at-2.png 2                  # eine ruhende Station
node $K file:///pfad/seite.png transit.png 4.4 --wait=900  # zwischen zwei Stationen, einrastend
node $K file:///pfad/seite.png last.png 9                  # der letzte Halt ist erreichbar
node $K file:///pfad/seite.png light.png 5 --light         # der helle Grund
node $K file:///pfad/seite.png phone.png 3 375 700         # Telefonbreite
node $K file:///pfad/seite.png flat.png 0 --reduce         # die Seite mit reduzierter Bewegung
node $K "file:///pfad/seite.html#st-model" hash.png -      # ein Link zu einem Halt, beim Laden
node $K file:///pfad/seite.png nav.png 0 --nav             # Pfeile, der letzte Inhaltslink, die Schiene

Jeder Durchlauf gibt die Halte aus und, pro Schritt, y, front (die Station, die Zeigerereignisse empfängt), rail, cardsShown, cardsLit, deep und pageWidth. Eine ruhende Station hat front gleich ihrem Index; pageWidth muss die Viewport-Breite anzeigen (kein seitliches Seiten-Scrollen). Sehen Sie sich jedes Bild an, sowohl in hellem als auch dunklem Grund und bei Telefonbreite, bevor Sie es als erledigt betrachten. Bei Seiten, deren Bilder außerhalb des Ordners liegen, kopieren Sie die Seite zuerst mit absoluten Bildpfaden in die Zwischenablage.

Überprüfen Sie nicht mit chrome --headless --screenshot. Unter --virtual-time-budget kommen Animationsframes kaum voran, sodass die sanfte Kamera nie ankommt, und ein Screenshot eines gescrollten Fensters kann leer zurückkommen. capture.mjs steuert einen Echtzeit-Headless-Chrome, in dem Frames mit ihrer echten Rate laufen.

Feinabstimmung

Die Konstanten stehen am Kopf des Skripts in template.html.

KonstanteWertWas sie bewegt
PERSP900Muss mit dem CSS perspective auf .stations und .field übereinstimmen
GAP1400Welt-Tiefe zwischen zwei Stationen
AHEAD2,2 × GAPWie weit voraus eine Station überhaupt gezeichnet wird
PASS300Wo eine vorbeiziehende Station ausgeblendet ist (Skalierung 1,5)
LIFT36Pixel, um die eine wartende Station pro GAP-Entfernung tiefer sitzt
DEPTH, NEAR2800, 220Die Entstehungstiefe des Stroms und die Tiefe, in der eine Karte vorbeigeflogen ist
BASE46Die Geschwindigkeit des Stroms im Ruhezustand, px/s
Kamera-Beruhigung9 pro SekundeWie schnell die Kamera den Scroll einholt

Was beim ersten Bau schiefging

Jeder dieser Fehler wurde durch Hinsehen gefunden und ist in der Vorlage behoben.

  • Der Scroll-Margin des Headers. Der fixierte Header gibt jedem [id] einen scroll-margin-top, damit Anker unter ihm landen. Sprünge landeten 126px zu kurz vor jedem Halt, bis die Halte auf Null gesetzt wurden.
  • Die Spur war einen Header zu kurz. Die Seite endete, bevor der letzte Halt die Spitze erreichen konnte. Die Höhe der Spur verwendet die Fensterhöhe, nicht die der Bühne.
  • Karten flogen hinter die Inhalts-Spalte. Diese Spalte ist fixiert und transparent, sodass Karten durch ihren Text hindurch sichtbar waren. Wenn die Spalte fixiert ist, beginnt die Bühne rechts davon.
  • Entfernte Karten sammelten sich am Fluchtpunkt. WhatTheFads Maske behob das Problem.
  • Die vorbeiziehende Station blieb als großer Unschärfe-Fleck zurück. Die Lösung war ein kürzerer PASS und ein quadratisches Ausblenden.
  • Die wartende Station war unter kurzen Stationen sichtbar. Sie wird dunkel gezeichnet (quadratisch).
  • Der flache Modus zeigte auf versteckte Halte. Die Halte werden auf die Stationen verschoben.
  • Ein Scroll, der vor dem Lade-Ereignis landete, traf auf eine zu kurze Seite. Die Spur wird sofort nach dem Parsen des Dokuments angelegt und erneut, sobald Schriftarten und Bilder sich gesetzt haben, sodass ein wiederhergestellter Scroll und ein #st-<id>-Link beide landen.
  • Auf einem Telefon schwenken die breiten Zeichnungen seitlich innerhalb ihrer Platte, die Bildzeile wird ausgeblendet und die Station wird verschmälert, sodass die Schiene den rechten Rand behält.

Offen

  • Eine Karte fangen. In WhatTheFad öffnet ein gefangener Chip eine Ausgrabung. Hier könnte eine Karte ihren Datensatz öffnen, was erfordert, dass die Zielseite eine ID in ihrer URL aufnimmt und der projizierte Treffertest von oben durchgeführt wird.
  • Eine Pausensteuerung. Der Strom bewegt sich, solange die Seite geöffnet ist. Reduzierte Bewegung stoppt ihn, aber es gibt keinen Pause-Button, was WCAG 2.2.2 für Bewegung fordert, die länger als fünf Sekunden zusammen mit anderen Inhalten dauert.
  • Das Gefühl auf einem echten Trackpad und Telefon sowie die Bildrate wurden noch nicht von einer Person beurteilt.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Verwandte Skills