Was macht cursorfit?
Ein benutzerdefinierter Cursor ist eine Designentscheidung mit einem Usability-Preisschild. Die meisten Cursor-Skills verkaufen den Effekt und überspringen den Preis. Dieser hier liest zuerst die Website, entscheidet, ob sich der Preis lohnt, und baut dann.
Das Versprechen in einem Satz: Der Cursor passt zu dieser Website, oder dir wird gesagt, warum sie keinen haben sollte.
Was das beantwortet
- Sollte diese Website überhaupt einen benutzerdefinierten Cursor haben?
- Welche Familie, in dieser Website-Farben, mit dieser Geschwindigkeit?
- Was macht der Cursor über einem Button, einem Bild, einem Absatz, einem deaktivierten Steuerelement, einem Touchscreen?
Die Regel, die das ehrlich hält
Jede Behauptung in der Empfehlung muss auf etwas verweisen, das im Repository gefunden wurde: eine Datei, ein Token, ein gemessener Wert, eine Anzahl. Wenn das nicht möglich ist, handelt es sich um eine Meinung und wird als solche gekennzeichnet. „Die Website wirkt modern und minimalistisch“ ist kein Beleg und darf niemals in der Ausgabe erscheinen.
Pipeline
| Stufe | Ausgabe |
|---|---|
| 0. Repo lesen | Framework, Dateizuordnung, vorhandener Cursor-Code |
| 1. Audit | cursorfit.json – Tokens, Typografie, Bewegung, Dichte, Steuerelemente und ein Abdeckungsbericht |
| 1b. Lesen | Die Komponenten, Inline-Stile und Utility-Klassen, die das Audit nicht lesen konnte |
| 2. Bewerten | Fünf Achsen, jeweils mit Belegen und einem Konfidenzniveau; Bewegungssignatur |
| 3. Lücken füllen | Maximal drei Fragen, jede mit einem Standardwert |
| 4. Entscheiden | Eine primäre plus zwei Alternativen, jeweils mit ihrem Nachteil; Überschreibungen mit Belegen erlaubt |
| 5. Bauen | Dateien, die in das Repository geschrieben und in den Einstiegspunkt eingebunden werden |
| 6. Verifizieren | Greps, der Build und ein Browser-Durchlauf mit scripts/verify.mjs |
| 7. Bericht | Das Format in references/recommendation.md |
Überspringe nicht von Stufe 1 zu Stufe 4. Die Bewertung ist das, was verhindert, dass die Antwort nur verkleideter Geschmack ist.
Stufe 0 – Lesen vor dem Entscheiden
Ordne das Repository zu, bevor du es bewertest. Du musst wissen:
- Framework, denn es entscheidet, wo der Cursor montiert wird und ob
cursor: noneaufbodyvon einer Komponentenbibliothek überschrieben wird. - Wo die echten Styles leben. Eine
tailwind.configplus eine 2.000-zeilige handgeschriebene CSS-Datei ist üblich, und die handgeschriebene Datei gewinnt normalerweise. Bewerte die Datei, die rendert. - Ob bereits ein Cursor existiert. Suche nach
cursor: none,cursor: url(,data-cursor,mousemove,mouse-follow,custom-cursor. Wenn einer existiert, ist es zuerst ein Reparaturjob, bevor es ein Designjob ist – siehereferences/gating.md.
Stufe 1 – Audit
Führe das Hilfsskript aus, wenn Node verfügbar ist:
node scripts/audit.mjs <repo-path> --out cursorfit.json
Es ist ein statischer Leser. Es öffnet keinen Browser und sendet keine Netzwerkanfrage. Es extrahiert Abhängigkeiten, Farbtokens, Schriftarten, Keyframes, Easing-Funktionen, Dauern, Abstände, Steuerelement-Anzahlen, vorhandenen Cursor-Code und ob die Barrierefreiheits-Guards bereits existieren.
Es zählt sowohl <Button> und <Link> als auch <button> und <a>, und es liest einen Abdeckungsblock: wie viele Stylesheets und Markup-Dateien es analysiert hat, wie viele Inline-Stile, Utility-Klassen-Listen und CSS-in-JS-Dateien es nicht lesen konnte und welche fünf Dateien es als erstes zu öffnen lohnt. Ein Score ist nur so gut wie diese Abdeckung, lies daher coverage vor scores.
Wenn das Hilfsskript nicht ausgeführt werden kann, führe die gleiche Extraktion manuell mit der Signaltabelle in references/audit.md durch. Jedes Signal in dieser Tabelle ist ein Eingabewert für die Bewertung; eines zu überspringen bedeutet, dass diese Achse UNKNOWN wird und nicht geraten.
Stufe 1b – Lesen, was das Audit nicht konnte
Die statische Analyse hat eine bekannte Liste von blinden Flecken, und so zu tun, als ob nicht, ist der Weg zu einem Profil, das selbstbewusst über eine Website spricht, die es nur halb gelesen hat. Öffne die Dateien in coverage.hotspots und beantworte drei Fragen zu jeder:
- Welches Padding, welche Radien und welche Schriftgrößen werden tatsächlich gerendert? Inline-Stile und Utility-Klassen enthalten Werte, die der Stylesheet-Scan nie gesehen hat.
- Ändern die Komponenten-Wrapper die Struktur? Ein
<Button>rendert möglicherweise ein<div>mit einem Click-Handler, kein<button>. Das ändert das Rezept für die Zustandsbeschriftung, dasdata-cursoran ein Steuerelement bindet. - Gibt es ein Layout oder einen Stacking-Kontext, den das Audit nicht sehen konnte? Sticky-Wrapper,
overflow: hidden-Abschnitte,isolation: isolate,backdrop-filter– jeder davon kann den Cursor verschieben.
Regeln für diesen Durchlauf:
- Lies nur die Hotspots sowie den Einstiegspunkt und das Layout-Shell. Nicht das gesamte Repository.
- Wenn ein Hotspot einen gemessenen Wert um mehr als ~20 % ändert, notiere den korrigierten Wert und gib im Bericht an, dass er aus dem Lesen stammt, nicht aus dem Skript.
- Wenn ein Hotspot nicht aufgelöst werden kann (generierte Styles, ein Build-Zeit-Theme), stuft die betroffene Achse auf
mediumherab und gib an, welche Datei die Ursache war. - Führe das Audit nie erneut aus, um eine Zahl schöner zu machen. Die Ausgabe des Skripts ist ein Beleg, kein Entwurf.
Stufe 2 – Bewerten
Fünf Achsen, jeweils 0–100, plus eine Bewegungssignatur. Vollständige Rubriken in references/profile.md.
ZURÜCKHALTEND ──────────▓▓▓ 74 EXPRESSIV
PRÄZISE ▓▓▓▓▓▓▓▓░░░░ 58 ORGANISCH
DICHT ▓▓▓░░░░░░░░░ 31 LUFTIG
RUHIG ▓▓▓▓▓▓░░░░░░ 47 ENERGISCH
PRODUKT ▓▓▓▓▓▓▓▓▓░░░ 68 EDITORIAL
Regeln:
- Mindestens zwei Belege pro Achse. Weniger bedeutet
UNKNOWN, undUNKNOWNwird zu einer Lückenfüll-Frage, nicht zu einer Median-Schätzung. - Die Scores beschreiben die Website, nicht den Cursor. Eine zurückhaltende Website verlangt nicht nach einem zurückhaltenden Cursor; sie sagt dir, dass ein lauter Cursor das einzige laute Element auf der Seite wäre.
- Die Bewegungssignatur wird gemessen, nicht gefühlt. Notiere die tatsächlichen Easing-Kurven, die mittlere Dauer, die Anzahl der Keyframes und ob etwas federt oder überschwingt.
- Jeder Score trägt eine Konfidenz.
high,mediumoderlow, aus dem Abdeckungsblock des Audits. Ein mittlerer Score wird als Bandbreite zitiert, nicht als Zahl. Ein niedriger Score wird gar nicht zitiert – er wird zu einer Lückenfüll-Frage. Vollständige Regeln inreferences/profile.md.
Stufe 3 – Lücken füllen
Stelle maximal drei Fragen, und zwar nur für Achsen, die als UNKNOWN zurückkamen, oder für Fakten, die ein Repository nicht enthalten kann. Jede Frage hat einen Standardwert, sodass „Ich weiß nicht“ immer noch eine Entscheidung hervorbringt.
Die drei, die sich normalerweise lohnen:
- Wer landet zuerst auf dieser Seite? Kunden, die ein Produkt bewerten / Entwickler, die Dokumentation lesen / Kunden, die ein Portfolio beurteilen. Standard: Kunden.
- Wie viel Persönlichkeit darf der Cursor tragen? Nur Polieren / Auffällig / Markenzeichen. Standard: Auffällig.
- Jede Farbe, die verwendet werden muss oder nicht verwendet werden darf? Standard: Der gesättigtste Markentoken des Repos.
Frage nie, was das Repository bereits beantwortet. Frage nie eine kosmetische Frage, die das Modell entscheiden kann. Wenn die Antwort nichts an der Empfehlung ändert, war es keine Frage.
Stufe 4 – Entscheiden
Bewerte jede Familie in references/families.md gegen das Profil und wende dann die harten Tore an. magnetic ist ein Modifikator – er wird der gewählten Familie auf ein oder zwei Elementen hinzugefügt und kann niemals die primäre Familie sein. Gib eine primäre und zwei Alternativen aus. Niemals ein flaches Menü – ein Menü gibt die Entscheidung an die Person zurück, die danach gefragt hat.
Jede Alternative trägt ihren Nachteil im gleichen Satz, nicht in einer Fußnote:
Alternative B – Mask Reveal. Stärkste editoriale Passform der drei; es kostet eine Canvas-Ebene über jedem Projektbild und wird auf jeder Karte, deren Bild nicht lädt, kaputt aussehen.
„Behalte den nativen Cursor“ ist ein gültiges Urteil. Wenn die Website leselastig, formularlastig oder barrierefreiheitskritisch ist, sage das – und biete dann trotzdem die risikoärmste Option und ihre Kosten an, denn die Person hat nach einem Cursor gefragt, und eine glatte Ablehnung hilft niemandem.
Du darfst die Rangfolge überschreiben, aber niemals stillschweigend. Die Zahlen sind Entscheidungshilfe, keine Messung, und das Audit weiß nicht, was es nicht lesen konnte. Eine Überschreibung ist erlaubt, wenn der Abdeckungsdurchlauf etwas gefunden hat, das das Skript übersehen hat – ein echtes Interaktionsmuster, eine Komponente, die die Steuerungsstruktur ändert, ein Stacking-Kontext, den der CSS-Scan nicht sehen konnte. Um eine zu beanspruchen, nenne alle vier:
- die Familie, die das Audit auf den ersten Platz gesetzt hat, und ihre Passung,
- den spezifischen Beleg, der sie ändert, mit einem Dateipfad oder einem gemessenen Wert,
- die Familie, die du stattdessen wählst,
- was der Leser verliert, indem er die Überschreibung nimmt.
Eine Überschreibung ohne Dateipfad ist Geschmack. Geschmack ist in der letzten Meile erlaubt – Größe, Easing, die genaue Beschriftung – niemals bei der Wahl der Familie.
Stufe 5 – Bauen
Vollständige Implementierungen für jede Familie befinden sich in references/recipes.md. Kopiere das Rezept und ändere nur das, was das Profil zu ändern vorgibt.
Nicht verhandelbar:
- Farbe stammt aus einem Token, niemals aus einem neuen Hex-Wert. Binde an die stärkste Markenfarbe, die das Audit gefunden hat (
var(--neon-cyan),theme('colors.accent'), eine exportierte Konstante). Ein hartcodiertes#00f0ffist der Unterschied zwischen „passt zu deiner Website“ und „passt zu der Website, von der es kopiert wurde“. - Die Basiszustandsebene wird mit jeder Familie ausgeliefert. Link, Button, Text und deaktiviert werden in
cursor.jsaufgelöst und incursor.cssgestylt, bevor Familiencode hinzugefügt wird. Keine Familie löscht sie;dotreduziert nur die Zahlen. Ein Cursor, der nichts tut, wenn er über einen Button fährt, ist unfertig – der Besucher kann ihn nicht von einem Aufkleber unterscheiden. - Labels sind die Verbesserung, nicht der Zustand.
[data-cursor]fügt ein Wort zu einem Zustand hinzu, der bereits existiert. Wenn der Build nur dort reagiert, wo die Website annotiert wurde, fehlt die Zustandsebene. - T1-Familiencode bleibt unter ~90 Zeilen, zusätzlich zum gemeinsamen Kern. Wenn die eigene Ebene der Familie mehr braucht, ist die Familie falsch für die Website. Der Kern ist ~100 Zeilen, einmalig, weil er jetzt die Zustandsebene für jede Familie trägt.
cursor: nonewird von JS nach dem ersten Frame angewendet, niemals in statischem CSS. Wenn das Skript fehlschlägt, behält der Benutzer einen funktionierenden Cursor.- Nur einmal montieren. Ein Cursor, der pro Route montiert wird, ergibt zwei, dann drei.
- Touch bekommt nichts. Kein kleinerer Cursor. Nichts.
Vanilla wird als cursor.css + cursor.js und einer <script defer>-Zeile ausgeliefert. React wird als eine Komponente plus das gleiche CSS ausgeliefert, oberhalb des Routers montiert.
Es gibt zwei vorgefertigte Asset-Sets, damit der Build nicht an Grafiken hängt:
assets/shapes.css– sieben Silhouetten (Kreis, Ring, Quadrat, Fadenkreuz, Pille, Klammer, Klecks). Füge eine Klasse zum Marker hinzu; die Wahl der Silhouette kommt aus dem Profil.assets/cursors/*.svg– vier Bildcursor mit ihren Hotspot-Werten für die T0-Familie. Weiß mit einem dunklen Rand, sodass sie sowohl in hellen als auch in dunklen Abschnitten überleben.
Kopiere die Dateien in das Repository (normalerweise public/cursors/ und src/styles/), verweise zur Laufzeit nicht auf den Ordner dieses Skills.
Stufe 6 – Verifizieren
Drei Ebenen, in dieser Reihenfolge. Jede fängt, was die vorherige nicht fangen kann.
1. Greps. Führe die statischen Checks in references/gating.md aus. Es sind Greps, keine Meinungen: pointer-events, position: fixed, aria-hidden, Coarse-Pointer-Guard, Reduced-Motion-Guard, kein transition auf transform, verstecken bei mouseleave, Blend-Kontext-Check.
2. Build. npm run build oder tsc --noEmit. Ein Cursor, der den Build zerbricht, wird nicht ausgeliefert.
3. Browser. Greps beweisen, dass der Code die richtigen Dinge sagt; sie können nicht beweisen, dass der Cursor funktioniert. Wenn Playwright verfügbar ist, führe das Test-Framework aus:
node scripts/verify.mjs http://localhost:3000 --cursor .cf-cursor --json verify.json
Es öffnet die Seite und überprüft, was ein Grep nicht kann: das Element existiert und ist sichtbar, es hat pointer-events: none, es hinkt hinterher und konvergiert dann, Hover ändert seinen Zustand, ein Klick erreicht immer noch das Steuerelement darunter, Fokus behält seinen Ring, ein Routenwechsel erzeugt keinen zweiten, die Konsole bleibt sauber, ein Tippen lässt ihn nicht erscheinen, und prefers-reduced-motion deaktiviert das Folgen. Zehn Checks werden standardmäßig ausgeführt; füge --modal "#trigger" für einen elften hinzu, der ein Overlay öffnet und dessen Stacking mit dem Cursor vergleicht.
Playwright ist die einzige optionale Abhängigkeit im Paket. Wenn es nicht installiert ist oder die Seite nicht ausgeliefert werden kann, führe die gleichen elf Checks manuell bei 1366×768 und 390×844 durch – und wenn du das nicht tust, sagt der Bericht NOT_TESTED: rendered behaviour in diesen Worten. Gib niemals vor, es gesehen zu haben.
Ein übersprungener Check ist kein Bestehen. verify.mjs druckt Sprünge separat aus, aus diesem Grund: Es bedeutet, dass die Seite nicht genug exponiert hat, um zu testen, und der Bericht muss sagen, welcher Check übersprungen wurde und warum.
Stufe 7 – Bericht
Verwende references/recommendation.md. Der Bericht endet immer mit zwei Listen: Was zu beachten ist und Was bewusst deaktiviert ist.
Grenzen
- Code ist nicht das Rendering. Das Audit liest Quellcode. Ein
backdrop-filter, ein Stacking-Kontext oder eintransformauf einem Vorfahren kann das Aussehen des Cursors verändern, und der Quellcode zeigt es nicht. - Statische Analyse sieht nur, was sie parsen kann. Styling kann in Inline-Objekten, Utility-Klassen, die zur Build-Zeit aufgelöst werden, CSS-in-JS oder Komponenten-Interna leben. Das Audit zählt, was es verpasst hat, nennt die Dateien, die es zu öffnen lohnt, und senkt die Konfidenz – es überdeckt die Lücke nicht.
- Browser-Verifikation benötigt einen Browser.
scripts/verify.mjserfordert Playwright und eine laufende Seite. Ohne sie bleibt das VerhaltenNOT_TESTED, und der Bericht muss das sagen. - Scores sind Heuristiken, keine Messungen. Sie ordnen Familien einer Website zu. Sie sagen keine Conversion, keinen Geschmack und nicht voraus, ob der Chef des Kunden es mag.
- Keine Live-URL. Absichtlich – ein Link würde es dem Skill erlauben, das Repository zu überspringen, und das Repository ist der Ort, an dem die Tokens sind. Der Preis ist, dass gerenderte Zustände unverifiziert bleiben.
- T3 benötigt vorhandene GPU-Abhängigkeiten. Ein WebGPU-Shader wird nur angeboten, wenn das Repository bereits
three,ogloder eine Shader-Pipeline ausliefert. Einen 600KB großen Renderer für einen Cursor hinzuzufügen, ist keine Designentscheidung. - Keine erfundene Markenfarbe. Wenn das Audit keinen brauchbaren Akzent findet, wird das zu einer Frage, nicht zu einem Standardwert.
- Die theatralische Stufe ist außerhalb des Rahmens – Schwarm-Cursor, gezeichnete Charaktere, Cursor-Übernahmen der gesamten Seite. Sie sind seitenweite Gags, keine Cursor-Entscheidungen, und sie kosten mehr als der Rest dieses Skills zusammen.
Fehlermodi, die dieser Skill verhindern soll
| Symptom | Ursache |
|---|---|
| Cursor unsichtbar auf Telefonen, Seite unbenutzbar | cursor: none ohne Coarse-Pointer-Guard |
| Klicks gehen durch den Cursor | pointer-events: none fehlt auf dem verfolgenden Element |
| Zwei Cursor nach Routenwechsel | Cursor wird pro Route montiert, nicht einmalig |
| Cursor springt statt zu gleiten | transform-Übergang fehlt |
| Fokusring unter dem Cursor versteckt | outline wird entfernt, aber durch nichts ersetzt |
| Cursor verschwindet auf dunklen Hintergründen | Farbe ist hartcodiert, nicht an das Theme gebunden |
| Besitzer denkt, der Cursor passt nicht | Die gewünschte Familie wurde ohne Profil ausgewählt |
Schlüsselwörter für die Aktivierung
custom cursor, cursor style, cursor follow, mouse follower, cursor trail, magnetic cursor, blend-mode cursor, cursor effect, cursor animation, cursor change, cursor design, cursor family, cursor personality, cursor audit, cursor recommendation, cursor build, Wer verwendet das, welche Website passt, wie sieht mein Cursor aus
Lizenz
MIT