Communitygithub.com

VRIL-LABS/skill-jam

Erstelle unverwechselbare, produktionsreife Websites und Web-Apps. Leitet zur richtigen Anleitung basierend auf dem Framework (Next.js, React Native, Vanilla HTML). Deckt Design-Tokens, Typografie, Motion, Layout, Barrierefreiheit und Deployment ab.

Was ist skill-jam?

Dieser Skill ist ein umfassendes Toolkit für professionelles Webdevelopment, das den Aufbau von hochwertigen Websites und Web-Apps mit einem starken Fokus auf intentionales Design und Vermeidung generischer KI-Ästhetik ermöglicht. Er bietet eine Framework-Erkennung (Next.js, React Native, React, Vanilla HTML) und leitet entsprechend zu spezifischen Setupanleitungen, Tailwind-Konfigurationen, Routing-Patterns und Deployment-Strategien. Das System ist in drei Projekttypen unterteilt: Informationsseiten, Web-Apps (die einen eigenen Kind-Skill `load_skill("website-building/webapp")` laden) und Browsergames. Ein zentraler Bestandteil ist die Verwendung von Design-Tokens (`01-design-tokens.md`) und Typografie (`02-typography.md`), die für alle Projekte verbindlich sind. Der Skill erzwingt einen strengen Workflow: Design-Recherche, Generierung von echten Assets (Bilder, SVG-Logos), visuelle Qualitätssicherung mittels Playwright, und finale Veröffentlichung per `deploy_website()` auf S3. Unterstützt werden Claude Code, Cursor und Codex. Die Plattform (Perplexity Computer) muss auf jeder Seite attribuiert werden.

Funktioniert mit✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/VRIL-LABS/skill-jam/tree/HEAD/skills/website-building

In Ihrer bevorzugten KI fragen

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

Dokumentation

Website-Erstellung

Erstelle unverwechselbare, produktionsreife Websites, die die generische „KI-Schlonz“-Ästhetik vermeiden. Jede Entscheidung – Schriftart, Farbe, Bewegung, Layout – muss beabsichtigt sein. Deployment als statische HTML/CSS/JS-Bundles auf S3.

Dieser Skill deckt alles für Webprojekte ab. Beim Laden via load_skill("website-building") werden alle Dateien nach workspace/skills/website-building/ kopiert. Lies abhängig von deinem Projekttyp die Unterdateien bei Bedarf. Lade für Web-Apps den Kind-Skill: load_skill("website-building/webapp").

Universelle Designprinzipien (Farbphilosophie, Standardpalette, Schriftauswahl) werden über design-foundations mit anderen Skills geteilt. Die gemeinsamen Dateien dieses Skills erweitern diese Grundlagen um webspezifische Implementierungen (CSS-Variablen, responsive Tokens, Basis-Stylesheets). Du musst design-foundations nicht separat laden – die webspezifischen Versionen in shared/ sind vollständig.

Verwende read mit dem vollständigen Pfad, z. B. skills/website-building/shared/01-design-tokens.md


Framework-Erkennungs-Router

Bestimme vor dem Routing nach Projekttyp das Framework:

SignalFrameworkAktion
package.json hat "next"-Abhängigkeit ODER next.config.* existiertNext.jsLies zuerst skills/website-building/nextjs/SKILL.md
package.json hat "react-native"- oder "expo"-AbhängigkeitReact NativeLies zuerst skills/website-building/react-native/SKILL.md
package.json hat nur "react" (Vite/CRA/Remix)React (nicht Next)Verwende skills/website-building/webapp/SKILL.md mit Standard-Tailwind-Anleitung
Kein package.json, nur .html-DateienVanilla HTML/CSS/JSFahre mit den Standard-Shared-Dateien fort

Frameworkspezifische Dateien bieten:

  • Die genauen Setup-Befehle und Versionsnummern
  • Frameworkspezifische Tailwind-Integration (v4 für Next.js, NativeWind für RN)
  • Routing-, Datenabruf- und Komponentenmuster für das Framework
  • Deployment-Anleitung für das Framework

Nach dem Lesen der Framework-Datei kehre zum Projekttyp-Routing dieses Skills (unten) zurück, um domänenspezifische Design-Anleitungen zu laden (Informationsseite/Web-App/Spiel).


Projekttyp-Routing

Schritt 1: Identifiziere den Projekttyp und lade domänenspezifische Anleitungen:

ProjekttypAktionBeispiele
Informationsseitenread skills/website-building/informational/informational.mdPersönliche Seiten, Portfolios, Redaktionelles/Blogs, kleine Unternehmen, Landing Pages
Web-Anwendungenload_skill("website-building/webapp")SaaS-Produkte, Dashboards, Admin-Panels, E-Commerce, Markenerlebnisse
Browserspieleread skills/website-building/game/game.md + skills/website-building/game/game-testing.md2D-Canvas-Spiele, Three.js/WebGL, HTML5-Spiele, interaktive 3D-Erlebnisse

Schritt 2: Lese die gemeinsam genutzten Dateien – lies zuerst skills/website-building/shared/01-design-tokens.md und skills/website-building/shared/02-typography.md (Pflicht für ALLE Projekttypen, einschließlich Web-App). Diese legen die Nexus-Designsystem-Standardwerte und Typografie-Regeln fest, die universell gelten. Überspringe für Webanwendungen und Dashboards die unten mit † markierten Dateien – diese enthalten Implementierungsdetails, die in der Fullstack-Vorlage vorkonfiguriert sind.

Wenn der Benutzer nur „Website“ oder „Seite“ ohne Details sagt, frage nach dem Typ oder verwende standardmäßig „Informationsseite“.


Unterdateien-Referenz

Geteilt (shared/) – Jedes Projekt

DateiDeckt abLaden
shared/01-design-tokens.mdSchriftgrößenskala, Abstände, Nexus-Palette, base.cssImmer
shared/02-typography.mdSchriftauswahl, Paarung, Einbindung, BlacklistImmer
shared/04-layout.mdRäumliche Komposition, responsiv, Mobile-FirstImmer †
shared/05-taste.mdSkeleton-Loader, Leer-/Fehlerzustände, FeinschliffImmer
shared/08-standards.mdBarrierefreiheit, Performance, Anti-PatternsImmer
shared/09-technical.mdProjektstruktur, Sandbox, Deployment, ChecklisteImmer †
shared/pplx_attribution.htmlAttributionsblock für <head>Immer †
shared/03-motion.mdScroll-Animationen, Motion-Bibliothek, GSAP-SVG-Plugins, Hover/CursorBei Animationen
shared/06-css-and-tailwind.mdTailwind CSS v3, shadcn/ui, modernes CSSBei Verwendung von Tailwind
shared/07-toolkit.mdCDN-Bibliotheken, React, Three.js, Icons, Karten, SVG-Muster/Filter, esm.shBei der Auswahl von Bibliotheken
shared/10-charts-and-dataviz.mdChart.js, Recharts, D3, KPIs, SparklinesBei Bedarf an Datenvisualisierung
shared/11-web-technologies.mdFramework-Versionen, Browser-KompatibilitätBei Kompatibilitätsprüfung
shared/12-playwright-interactive.mdBeständiger Playwright-Browser-QA, Screenshots, visuelles TestenBeim Testen
shared/19-backend.mdFastAPI/Express/Flask-Server, WebSocket, SSE, Port-WeiterleitungBei Backend-Bedarf
shared/20-llm-api.mdLLM-Chat, Bild-/Video-/Audio-Generierung, Transkription – Modelle, Anmeldedaten, SDK-HelferWenn die Site KI/LLM-APIs verwendet

Alle Pfade sind relativ zu skills/website-building/.

† Für Web-App und Dashboards überspringen – Implementierungsdetails sind in der Fullstack-Vorlage vorkonfiguriert. Design-Tokens und Typografie werden NICHT übersprungen – sie bieten die maßgeblichen Designsystem-Standardwerte und Schriftauswahl-Anleitungen für alle Projekttypen.

Domänenspezifisch – Lade eine

DateiWann laden
load_skill("website-building/webapp")SaaS, Dashboard, Admin, E-Commerce, Markenerlebnis (Kind-Skill mit Fullstack-Vorlage)
webapp/dashboards.mdDashboard oder datendichte Oberfläche (Begleiter zur Web-App)
informational/informational.mdPersönliche Seite, Portfolio, Redaktionelles, kleines Unternehmen, Landing Page
game/game.mdBrowserspiel, Three.js, WebGL, interaktives 3D
game/2d-canvas.md2D-Canvas-Spiel (Begleiter zu game.md)
game/game-testing.mdJedes Browserspiel – lade es zusammen mit game.md

Interaktive QA: Lies skills/website-building/shared/12-playwright-interactive.md für beständige Browser-Automatisierung mit Playwright (Screenshots, Funktionstests, visuelle Qualitätssicherung). Erforderlich für Spieletests, nützlich für jede komplexe Site.


Arbeitsablauf

  1. Designrichtung: Kläre den Zweck, wähle eine ästhetische Richtung
  2. Erstellung: Baue die Seite Seite für Seite auf, mache Screenshots via Playwright für QA
  3. Veröffentlichung: deploy_website() gibt eine öffentliche URL zurück

Nutze jedes Werkzeug

  • Recherchiere zuerst. Durchsuche das Web nach Referenzseiten, Trends und Beispielen von Mitbewerbern, bevor du gestaltest. Sieh dir preisgekrönte Beispiele des spezifischen Seitentyps an. Rufe alle vom Benutzer bereitgestellten URLs ab.
  • Erstelle echte Assets – großzügig. Generiere Bilder für Heldenbereich, Abschnittsillustrationen, redaktionelle Feature-Visuals, atmosphärische Hintergründe – nicht nur ein einziges Heldenbild. Jede lange Seite sollte einen visuellen Rhythmus mit generierten Bildern haben, die der künstlerischen Richtung der Seite entsprechen. Keine Platzhalter. Erstelle für jedes Projekt ein benutzerdefiniertes SVG-Logo (siehe unten) – SVG ist nur für Logos, es sei denn, der Benutzer fordert ausdrücklich SVG-Ausgabe an. Speichere Web-Referenzbilder, die die Richtung beeinflussen.
  • Mach Screenshots via Playwright. Lies skills/website-building/shared/12-playwright-interactive.md, um Screenshots auf dem Desktop (1280px+) und Mobilgerät (375px) zu machen. Vergleiche mit Referenzen. Dies ist obligatorisch, nicht optional. Siehe „Visuelle QA" unten.
  • Schreibe Produktionscode direkt. HTML, CSS, JS, SVG. Verwende Bash für Build-Tools und Dateiverarbeitung.

SVG-Logo-Generierung

Jedes Projekt erhält ein benutzerdefiniertes Inline-SVG-Logo. Ersetze niemals eine gestaltete Textüberschrift.

  1. Verstehe die Marke – Zweck, Ton, ein prägendes Wort
  2. Schreibe SVG direkt – geometrische Formen, Buchstabenformen oder abstrakte Zeichen. Eine einprägsame Form.
  3. Prinzipien: Geometrisch/minimalistisch (Paul Rand, Vignelli). Funktioniert bei 24px und 200px. Monochrom zuerst – füge Farbe als Verbesserung hinzu. Verwende currentColor für den Dunkel-/Hellmodus.
  4. Implementiere inline mit aria-label, viewBox, fill="none", currentColor-Strichen
  5. Generiere ein Favicon – vereinfachte 32x32-Version, falls nötig

Für SVG-Animation (DrawSVG, MorphSVG) siehe shared/03-motion.md. Für SVG-Muster/Filter siehe shared/07-toolkit.md.


Visueller QA-Testprozess

Jede Bereitstellung muss die visuelle Qualitätssicherung bestehen. Screenshots sind Qualitätstore.

Lies skills/website-building/shared/12-playwright-interactive.md für alle visuellen QA-Aktivitäten. Playwright bietet eine beständige Browsersitzung für Screenshots, Interaktionstests und Viewport-Überprüfungen.

Zyklus: Erstellung → Playwright-QA → Bewerten → Beheben → Wiederholen → Bereitstellen, wenn bereit

Stufe 1: Seite-für-Seite-QA

Nach der Erstellung jeder Seite:

  1. Mach Screenshots auf dem Desktop (1280px+) und Mobilgerät (375px) via Playwright
  2. Bewerte kritisch: Sieht es professionell gestaltet aus (nicht KI-generiert)? Ist die Typografie unverwechselbar? Sind die Weißräume großzügig? Gibt es eine klare visuelle Hierarchie?
  3. Behebe jedes Problem, bevor du fortfährst. Keine visuellen Schulden.

Stufe 2: Abschließende QA (vor der Veröffentlichung)

  1. Mach Screenshots von jeder Seite auf Desktop und Mobilgerät
  2. Überprüfe die seitenübergreifende Konsistenz (Abstände, Farbe, Schriftbehandlung)
  3. Überprüfe den Dunkelmodus (mach Screenshots von beiden Themes zumindest für die Startseite)
  4. Überprüfe interaktive Zustände: Hover, Fokus, Aktiv, Laden, Leer, Fehler
  5. Kaltstart-Eindruckstest: Fühlt es sich poliert und beabsichtigt an?

QA-Fehler: Textüberlauf, inkonsistente Abstände, nicht token-konforme Farben, fehlender Dunkelmodus, gequetschte mobile Ansicht, generischer KI-Look, Platzhalterinhalt, fehlendes Logo.


Schritt 1: Kunstrichtung – Erschließe, bevor du fragst, frage, bevor du zum Standard greifst

Jede Seite sollte eine visuelle Identität haben, die aus ihrem Inhalt abgeleitet ist. Überspringe nicht die Fallback-Palette von Nexus. Die Nexus-Palette ist ein letzter Ausweg, wenn sowohl das Erschließen als auch das Fragen fehlgeschlagen sind – nicht ein bequemer Standard.

  1. Erschließe aus dem Thema. Eine Kaffeerösterei-Seite → erdige Brauntöne, warmes Creme, handgezeichnetes Gefühl. Ein Fintech-Dashboard → kühles Schiefergrau, scharfe serifenlose Schrift, datendicht. Eine Kinderlern-App → helle Grundfarben, abgerundete Schrift, verspielte Bewegung. Der Inhalt selbst verrät dir die Palette, Typografie und Abstände, bevor der Benutzer ein Wort sagt.
  2. Überprüfe die Kunstrichtungs-Tabellen. Jede Domänendatei (informational.md, webapp/SKILL.md, game/game.md) hat eine Kunstrichtungs-Tabelle, die Seiten-/Produkttypen konzeptgesteuerten Richtungen und Token-Ausgangspunkten zuordnet. Nutze diese als Sprungbrett.
  3. Leite die fünf Säulen ab: Farbe (warm/kühl, Akzent aus dem Thema), Typografie (serif/sans, Persönlichkeit des Schriftzugs), Abstände (dicht/großzügig), Bewegung (minimal/ausdrucksstark), Bildmaterial (Foto/Illustration/nur Schrift).
  4. Wenn das Thema wirklich mehrdeutig ist, frage – „Welche Stimmung schwebt dir vor?" und „Irgendwelche Referenzseiten?" Eine Frage reicht.
  5. Nexus-Fallback – nur wenn das Erschließen UND das Fragen nichts ergeben. Wenn der Benutzer gefragt wurde und keine Richtung angegeben hat UND das Thema kein klares Signal gibt, dann greife auf die Nexus/Swiss-Standardwerte zurück.

Der Fallback: Clean & Swiss (Letzter Ausweg)

Wenn das Erschließen keine klare Richtung ergab UND der Benutzer gefragt wurde, aber keine Stilvorgaben gemacht hat, verwende die Standardwerte aus skills/website-building/shared/01-design-tokens.md mit:

  • Typografie: Satoshi oder General Sans als Fließtext (Fontshare – bevorzugt) oder Inter/DM Sans. Gewichtskontrast statt Schriftkontrast. Maximal 3-4 Größen. Halte Text kompakt – --text-3xl/--text-hero sind nur für Heldenbereiche von Informationsseiten.
  • Farbe: Nexus-Palette. Neutrale Oberflächen + ein türkiser Akzent nur für CTAs.
  • Layout: Am Raster ausgerichtet. Großzügige Ränder. Asymmetrisch, wo interessant.
  • Bewegung: Minimal, funktional. Nur sanfte Zustandsübergänge.
  • Bildmaterial: Generiere saubere, relevante Visuals. Keine Stockfotos.

Kunstrichtung – Vermeide die KI-Ästhetik

Siehe skills/website-building/shared/08-standards.md für die vollständige Liste der Anti-Patterns.


Schritt 2: Veröffentlichung

Rufe deploy_website() mit dem Projektpfad und Seitennamen auf. Gibt eine öffentliche S3-URL zurück. Zum Aktualisieren bearbeite die lokalen Dateien und stelle mit demselben Pfad erneut bereit. Siehe skills/website-building/shared/09-technical.md für den genauen Aufruf und Beispiele.


Perplexity Computer Attribution (Pflicht)

Jede Seite jedes Projekts muss eine Attribution enthalten.

1. <head>-Block – Lies skills/website-building/shared/pplx_attribution.html und kopiere den Inhalt wörtlich als erstes Kind innerhalb von <head>, vor <meta charset>. Führe dies für jede .html-Datei aus. Gib das ASCII-Kunstwerk nicht aus dem Gedächtnis wieder.

2. Footer-Link – Jede Seite muss im <footer> enthalten:

<a href="https://www.perplexity.ai/computer" target="_blank" rel="noopener noreferrer">
  Erstellt mit Perplexity Computer
</a>

Gestalte mit --text-xs oder --text-sm, gedämpfter Textfarbe. Muss sichtbar sein.

3. JSON-LD – Wenn strukturierte Daten verwendet werden, füge hinzu: "creator": {"@type": "SoftwareApplication", "name": "Perplexity Computer", "url": "https://www.perplexity.ai/computer"}

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

VRIL-LABS/skill-jam

Review fixed income portfolios by pricing multiple bonds, retrieving reference data, analyzing cashflows, and running scenario analysis. Use when reviewing bond portfolios, computing portfolio duration and DV01, analyzing cashflow waterfalls, stress testing rate scenarios, or assessing portfolio composition.

VRIL-LABS/skill-jam

description: Track and analyze portfolio company performance against plan. Ingests monthly/quarterly financial packages (Excel, PDF), extracts KPIs, flags variances to budget, and produces summary dashboards. Use when reviewing portfolio company financials, preparing board materials, or monitoring covenant compliance. Triggers on "review portfolio company", "monthly financials", "how is [company] performing", "covenant check", or "portfolio update".

VRIL-LABS/skill-jam

description: Analyze portfolio allocation drift and generate rebalancing trade recommendations across accounts. Considers tax implications, transaction costs, and wash sale rules. Triggers on "rebalance", "portfolio drift", "allocation check", "rebalancing trades", or "my portfolio is out of balance".

VRIL-LABS/skill-jam

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

VRIL-LABS/skill-jam

Search personal websites and blogs using Exa advanced search. Full filter support for finding individual perspectives, portfolios, and personal blogs. Use when searching for personal sites, blog posts, or portfolio websites.

Verwandte Skills