Communitygithub.com

Inspiration-Referenzen

Findet, zeigt, vergleicht und bewertet echte Design-Referenzen aus der Inspiration-Bibliothek von VASA.Works (über deren MCP-Server): Website-Abschnitte, UI-Screens, Präsentationen, Branding, OG-Bilder, Editorial, Illustration, Motion, Schriften und Paletten. Verwaltet außerdem die Inspiration-Boards und importierten X-Lesezeichen des Benutzers.

Was ist Inspiration-Referenzen?

Diese Fähigkeit ermöglicht es KI-Agenten (z. B. Claude Code, Cursor- oder Codex-basierte Clients), auf eine umfangreiche Bibliothek kuratierter Design-Referenzen von VASA.Works zuzugreifen. Sie ist nützlich, wenn ein Benutzer visuelle Inspiration für ein bestimmtes Muster sucht – etwa einen Preisseiten-Abschnitt, einen Onboarding-Flow, eine Markenidentität oder eine Moodboard-Komposition. Die Fähigkeit durchsucht die Inspiration-Bibliothek nach relevanten Einträgen, ruft die tatsächlichen Bilder ab, analysiert sie im Hinblick auf Layout, Hierarchie, Typografie und Farbgebung und liefert präzise, umsetzbare Referenzen (in der Regel 4–6), ohne den Benutzer mit einer Linkliste zu überfordern. Sie unterstützt mehrere MCP-Plattformen (Claude Code, Cursor, Codex usw.) und behandelt wiederholte oder verfeinerte Anfragen („Mehr davon“, „Ähnlich wie diese“, Vergleiche), Verwaltung von Boards und Suchvorgänge in Lesezeichen. Die Fähigkeit betont die Wiedergabetreue – sie beschreibt nur das, was auf den tatsächlich geöffneten Bildern sichtbar ist – und gibt Prinzipien statt Pixel weiter, wobei die kontofreundliche API-Auslastung beachtet wird (kostenlose Konten erhalten 50 aufgerufene Aufrufe pro UTC-Monat).

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/huseyingayiran/inspiration-skills/tree/HEAD/skills/inspiration-references

In Ihrer bevorzugten KI fragen

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

Dokumentation


name: inspiration-references description: Findet, zeigt, vergleicht und bewertet echte Design-Referenzen aus der Inspiration-Bibliothek von VASA.Works (über deren MCP-Server): Website-Abschnitte, UI-Screens, Präsentationen, Branding, OG-Bilder, Editorial, Illustration, Motion, Schriften und Paletten. Verwaltet außerdem die Inspiration-Boards und importierten X-Lesezeichen des Benutzers. Verwenden, wenn der Benutzer Inspiration, Beispiele für ein Muster, Referenzen für eine Seite, ein Moodboard oder mehr wie eine Referenz wünscht. metadata: version: "1.1.0"

Was macht Inspiration-Referenzen?

Verwandle ein Briefing in einen kurzen, ehrlichen Satz echter Referenzen: Durchsuche die Bibliothek, betrachte die tatsächlichen Bilder, sag, was jedes einzelne tut, das passt, und hilf dem Benutzer einzugrenzen. Eine gute Antwort besteht aus 4 bis 6 Referenzen, mit denen der Benutzer arbeiten kann, nicht aus einer Liste von 12 Links.

Wann verwenden

  • Anfragen wie „Inspiration finden für“, „zeig mir gute Preisseiten“, „wie sehen großartige Onboarding-Flows aus“, „Referenzen für einen Fintech-Helden“, „ein Moodboard erstellen“, „mehr wie diese hier“, „diese beiden vergleichen“, „diese in einem Board speichern“, „was ist auf meinen Boards“, „durchsuche meine X-Lesezeichen“.
  • Auch, wenn der Benutzer nie „Inspiration“ sagt, aber echte Beispiele für ein Designmuster wünscht.
  • Nicht zum Entwerfen und Erstellen einer Seite (verwende inspiration-art-direction), einer Palette oder eines Schriftart-Kits (verwende inspiration-brand-kit) oder für Code-Änderungen ohne Referenzfrage.

Die Tools werden hier nur mit ihrem Namen (search_inspiration) aufgeführt. In deinem Client tragen sie einen Server-Präfix wie mcp__plugin_inspiration_inspiration__ (Claude Code Plugin-Installation), mcp__inspiration__ oder einen Connector-Namen.

1. Einrichtung prüfen

Suche nach einem Tool namens search_inspiration unter einem beliebigen Präfix. Wenn der Host Tools als zurückgestellt auflistet, zählt das Laden über die Tool-Suche des Hosts als verfügbar. Wenn es fehlt, lies references/setup.md, gib dem Benutzer den einen Schritt für seinen Client an und stopp. Wenn er trotzdem weitermachen möchte, sag klar, dass du keine Bibliotheks-Referenzen anzeigen kannst, und biete allgemeine Hinweise aus deinem eigenen Wissen an. Erfinde niemals IDs, Titel, Bild-URLs oder Beschreibungen.

2. Das Briefing übersetzen

Extrahiere vier Dinge: Was (Kategorie und Untertyp), Look (Stil, Farbe, Thema, Typografie), Gefühl (Stimmung), Kontext (Branche). Setze die spezifischen, visuellen Wörter in query und nur die eindeutigen Einschränkungen in filters.

search_inspiration(
  query="Dark SaaS-Preise mit hervorgehobener mittlerer Stufe",
  category="website-sections",
  filters={"subtype": ["pricing", "pricing-table"], "theme": ["dark"]},
  limit=6)
  • filters sind UND-Verknüpfungen über die Schlüssel hinweg und ODER-Verknüpfungen innerhalb eines Schlüssels. Ein bis drei Schlüssel sind in der Regel richtig; mehr Schlüssel liefern meist null Ergebnisse.
  • subtype bezeichnet den Abschnittstyp für Website-Abschnitte (hero, pricing, cta, footer...), die Folienrolle für Präsentationen (cover, traction, the-ask...) und den Asset-Typ anderswo (logo, poster, dashboard...). Werte und Rezepte pro Kategorie: references/search-recipes.md.
  • Wenn das Briefing vage ist oder du dir bei einem Wert unsicher bist, rufe list_facets(category=..., top=25) auf. Es ist nicht gemessen. Wenn es einen Fehler ausgibt, verwende die Werte in references/search-recipes.md in filters weiter; entferne einen Filter nur, wenn diese Suche null Ergebnisse liefert.
  • Wenn der Benutzer eine Marke nennt, deren Look er möchte, übergib brand="<website-styles slug>", um die Ergebnisse in diese Richtung zu sortieren, oder ein Profil-Dict (palette, style, mood, typography, industry, tags, theme).
  • Null Ergebnisse liefern suggestions. Wiederhole die Suche einmal mit einem Vorschlag oder mit einem entfernten Filter; sag dem Benutzer, was du gelockert hast.

Verwende limit=6, damit der gesamte Satz in einen Bildaufruf passt. limit=1 ist für „gib mir einfach eine“ und fügt alternates hinzu.

3. Schau, bevor du sprichst

Die Suche gibt URLs und Metadaten zurück, keine Pixel. Rufe get_image einmal mit der Liste der IDs (bis zu 6) auf und betrachte jedes Bild, bevor du etwas darüber schreibst.

Gib für jede Referenz an:

  • ID und Titel (die ID wird von Boards und Folgeaktionen verwendet).
  • Was es tatsächlich tut, das zum Briefing passt, in ein oder zwei Zeilen, basierend auf dem Bild: Layout, Hierarchie, Typografie-Behandlung, Farbproportion, ein bemerkenswertes Detail.
  • Bewertungsetikett, wenn es keine vollständige Übereinstimmung ist: „teilweise: dunkel und editorial, aber keine hervorgehobene Stufe“. Ehrliche Etiketten sind besser, als die Liste aufzublähen.

Füge dann zwei oder drei Zeilen Synthese hinzu: die Muster, die die starken gemeinsam haben, und welches du als Ausgangspunkt nehmen würdest und warum. Halte Titel, Tags und Filterübereinstimmungen aus deinen Beschreibungen heraus, es sei denn, das Bild bestätigt sie. Ein Ergebnis, das theme: dark bestanden hat, kann dennoch eine helle Seite sein; bewerte es als teilweise. Beschreibe nur, was sichtbar ist: Bewegung, Hover-Zustände und Scroll-Effekte sind in einem Standbild nicht sichtbar.

4. Mehr, enger oder ähnlich

  • Mehr von derselben Suche: Wiederhole sie mit exclude_ids=[bereits gezeigte IDs] (am besten) oder offset=6. Prüfe zuerst has_more.
  • Mehr wie diese: similar_items(id, limit=6), oder get_inspiration(id, similar=6), wenn du auch die Facetten des Ausgangselements im selben Aufruf haben möchtest.
  • Wie diese, aber verändert („heller“, „verspielter“, „für Fintech“): Lies die Facetten des Ausgangselements (get_inspiration(id)) und betrachte das Ausgangsbild, suche dann mit seinem Untertyp und der geänderten Einschränkung als Filter oder Suchbegriffe, unter Ausschluss des Ausgangselements. Wenn get_inspiration einen Fehler ausgibt, finde die Zeile des Ausgangselements mit einer einfachen search_inspiration(query="<Wörter aus dem Slug>", category="<Kategorie des Ausgangselements>", limit=3) (ohne verbose, ohne brand), öffne seine image_url und nimm den Look aus den Pixeln. Notiere, was sich im Vergleich zum Ausgangselement geändert hat.
  • Details zu einigen: get_inspiration([ids], detail="standard") in einem Aufruf. detail="full" ist groß; verwende es nur, wenn ein benötigtes Feld fehlt.

5. Referenzen vergleichen

Wenn der Benutzer fragt, welche besser ist oder wie sie sich unterscheiden, stelle die Kandidaten anhand der bereits abgerufenen Bilder nebeneinander (rufe fehlende in einem Batch ab):

Ref ARef B
Hierarchie
Typografie
Farbe und Kontrast
Dichte und Abstand
Was mitnehmen

Beende mit einer Empfehlung, die auf das Briefing des Benutzers abgestimmt ist, sowie dem, was von jedem zurückgelassen werden sollte. Nimm Prinzipien, nicht Pixel: Schlage niemals vor, Logos, Texte, Bilder oder lizenzierte Schriftarten zu kopieren.

6. Boards

Boards befinden sich auf dem Inspiration-Konto des Benutzers unter inspiration.vasa.works.

  • Schreibe nur auf eine explizite Aufforderung oder ein „Ja“ auf dein Angebot hin. Das Suchen, Anzeigen oder Liken eines Ergebnisses ist keine Erlaubnis. Biete nach dem Zeigen der Ergebnisse einmal an: „Möchtest du, dass ich diese in einem Board speichere?“
  • save_to_board(title, ids=[...]) erstellt das Board oder fügt hinzu, wenn ein Board mit diesem Titel existiert. Es gibt board_url, item_count, added und already_in_board zurück. Teile die URL mit.
  • save_to_board(title, query=..., filters=..., category=..., limit=...) sucht und speichert in einem Aufruf; verwende es nur, wenn der Benutzer darum gebeten hat, „was immer du findest“ ohne vorherige Überprüfung zu speichern.
  • list_my_boards() für „meine Boards“. get_board(board) (ID oder Slug), um eines anzuzeigen; dann get_image für bis zu 6 seiner Element-IDs, wenn der Benutzer sie sehen möchte.
  • add_to_board(board, item_ids) zu einem bestimmten vorhandenen Board hinzufügen; create_board(title, item_ids) für ein leeres oder initialisiertes neues Board.
  • Fehler: board_limit oder item_limit (sag dem Benutzer Bescheid, schlage ein vorhandenes Board vor), rate_limited (warte, wiederhole einmal), nothing_to_save (IDs übergeben).

7. Die X-Lesezeichen des Benutzers

Wenn der Benutzer seine eigenen Lesezeichen oder gespeicherten Beiträge erwähnt, rufe search_x_bookmarks(query, limit=10) auf. Es durchsucht nur seine importierten Lesezeichen. Ein "status": "not_connected"-Ergebnis enthält connect_url; gib es weiter. Ergebnisse enthalten Tweet-Text, Bild-URLs und einen Beitrags-Link. Beschreibe ein Bild nur, wenn du es tatsächlich ansehen konntest; zitiere andernfalls den gespeicherten Text und sag, dass du das Bild nicht gesehen hast.

Budget

Kostenlose Konten erhalten 50 gemessene Aufrufe pro UTC-Monat. Eine typische Anfrage verbraucht 3 bis 5:

SchrittAufrufe
list_facets (nur bei Unklarheit)0, nicht gemessen
search_inspiration1 (2 mit einem Wiederholungsversuch)
get_image, ein Batch mit bis zu 61
eine Folgeaktion (mehr, ähnlich, vergleichen, speichern)1 oder 2

Bündele alles: get_image akzeptiert bis zu 6 IDs, get_inspiration akzeptiert eine Liste. Wiederhole niemals einen Aufruf pro Element.

Kontingent und Fehler

Lies references/library-rules.md beim ersten Mal, wenn ein Tool einen Fehler zurückgibt, quota_exhausted oder capped, oder wenn get_image fehlschlägt (es hat den Bild-Fallback über die öffentliche image_url, kein gemessener Aufruf). Die Kurzfassung: quota_exhausted stoppt alle gemessenen Aufrufe (link zu https://inspiration.vasa.works/pricing, beende mit dem, was du hast), capped bedeutet keine weiteren Seiten, not_found bedeutet erneute Suche (rate nie eine ID), subscription_required bedeutet Anmeldung, und der gleiche Serverfehler bei zwei verschiedenen Tools bedeutet abgesenkten Modus. Fehlerhafte Aufrufe zählen zum Budget. Board-Fehler befinden sich in Abschnitt 6.

Regeln

  • Wiedergabetreue. Beschreibe nur, was du in Bildern gesehen hast, die du tatsächlich geöffnet hast (get_image oder den image_url-Fallback). Beanspruche niemals Details aus Titeln allein.
  • Prinzipien, nicht Pixel. Referenzen informieren; sie sind keine Vorlagen zum Kopieren.
  • Nenne nur die Bibliothek. Bezeichne sie als Inspiration-Bibliothek oder Inspiration von VASA.Works. Spekuliere nicht darüber, woher die Elemente stammen. Verlinke niemals eine Drittanbieter-Site als Ursprung eines Elements. Schriftarten-Gießerei- oder Lizenzseiten, die eigenen Lesezeichen-Beitragslinks des Benutzers und Board-URLs sind in Ordnung.
  • Keine stillen Board-Schreibvorgänge.

Individual skills in this repo

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

Verwandte Skills