Communitygithub.com

pikaOne1138/astro-personal-site-starter

Entwerfen, erstellen, verfeinern oder prüfen Sie anspruchsvolle Astro-Websites für Wissens-/Blog- und Helfer-/Dienstleistungs-Archetypen.

Was ist astro-personal-site-starter?

Diese Fähigkeit für KI-Agenten (kompatibel mit Claude Code, Cursor, Codex und anderen KI-gestützten Entwicklungstools) dient dem Entwurf, Aufbau, der Verfeinerung oder Prüfung von Astro-Websites, die sich durchdacht und nicht nur generiert anfühlen. Sie konzentriert sich auf zwei Inhaltsarchitekturen – Wissens-/Blog- und Helfer-/Dienstleistungsseiten – und verbindet diese mit drei visuellen Persönlichkeiten: Papier & Tinte, Morgenlicht und Ruhiges Studio. Die Fähigkeit bietet klare Richtlinien, Umfangsbegrenzungen, Navigationsstrukturen und Qualitätskriterien, damit Agenten konsistent hochwertige, minimalistische Front-End-Seiten erstellen können, ohne in Backend-Funktionen wie CRM, Authentifizierung oder Datenbanken abzudriften. Sie priorisiert Belege aus Screenshots und CSS-Analysen gegenüber ungeprüften Annahmen und definiert für jede Architektur eine Standard-Seitenabfolge (z. B. Held → Hier beginnen/Themen → Vorgestellt/Neueste → Kurzes Über → Ressource → Newsletter → Fußzeile für Blogs). Die Einhaltung einer konsistenten Abstandsskala, Lesbarkeit (60–72 Zeichen pro Zeile), einer kontrollierten Farbpalette und subtiler Animationen (respektiert die Einstellung „reduced motion“) wird sichergestellt. Sie vermeidet gängige Fallstricke wie übermäßige Glas-Morphismen oder unnötige Carousels und liefert so eine solide Grundlage für professionelle, aber gleichzeitig persönliche Websites.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/pikaOne1138/astro-personal-site-starter/tree/HEAD/.ai/astro-ui-craft

In Ihrer bevorzugten KI fragen

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

Dokumentation

Astro UI Craft

Erstellen Sie Websites, die sich durchdacht und nicht nur generiert anfühlen.

Kernmodell

Zwei Inhaltsarchitekturen:

  • Wissen / Blog
  • Helfer / Dienstleistung

Drei visuelle Persönlichkeiten:

  • Papier & Tinte
  • Morgenlicht
  • Ruhiges Studio

Behandeln Sie dies als 2 Architekturen × 3 visuelle Richtungen, nicht als sechs unabhängige Codebasen.

Umfangsbegrenzung

Der Standardumfang ist eine anspruchsvolle Front-End-Website. Bevorzugen Sie externe Formulare, LINE, Buchungs- und Newsletter-Dienste. Weiten Sie den Umfang nicht stillschweigend auf CRM, Authentifizierung, Mitgliedersysteme, individuelle Buchungsmaschinen, Zahlungen, Datenbanken oder SaaS-Administration aus.

Beweishierarchie

  1. Direkt geöffnete / Screenshot / per CSS-Analyse ermittelte Beobachtungen.
  2. Im Web recherchierte und seitenverifizierte Beobachtungen.
  3. Fallübergreifende Muster, die aus verifizierten Fällen abgeleitet wurden.
  4. Designvorschläge und synthetisierte Tokens.
  5. Ausschließlich aus dem Gedächtnis oder explizit unverifizierte Kandidatenlisten.

Aufgaben der Wissens-/Blog-Seite

Beantworten:

  • Worüber schreibt diese Person?
  • Wo sollte ein neuer Leser beginnen?
  • Wie finde ich mehr zu einem Thema?
  • Warum sollte ich ihr folgen?
  • Was ist die nächste Handlung mit geringer Hürde?

Standardablauf: Held → Hier beginnen/Themen → Vorgestellt/Neueste → Kurzes Über → Ressource → Newsletter → Fußzeile

Aufgaben der Helfer-/Dienstleistungsseite

Beantworten:

  • Bin ich hier richtig?
  • Versteht diese Person meine Situation?
  • Was bieten sie an?
  • Was passiert, wenn ich Kontakt aufnehme?
  • Warum kann ich ihnen vertrauen?
  • Was ist der nächste druckfreie Schritt?

Standardablauf: Held → Empathie → Dienstleistungen → Erster Besuch/Ablauf → Über/Kompetenzen → Vertrauen → FAQ → Buchung/Kontakt → Fußzeile

Bevorzugen Sie in etwa 7 ± 1 aussagekräftige Abschnitte.

Visuelle Persönlichkeiten

Papier & Tinte

Warmes Papier, dunkle Tinte, Serifen-Schrift für Auszeichnungen, feine Linien, entsättigte Bilder, redaktionelle Listen.

Morgenlicht

Creme, Tontöne/Stein/Rosé-Akzente, weiche Serifen + gut lesbare Serifenlose, großzügige Radien, natürliches Licht, sanfte Beruhigung.

Ruhiges Studio

Beinahe weißes warmes Grau, präzises Raster, serifenlose Schrift im Fokus, ein starker Akzent, dünne Ränder, strukturierte Dienstleistungs-/Inhaltsmetadaten.

Verfeinerte UI-Regeln

  • Struktur vor Dekoration.
  • Konsistente Abstandsskala.
  • Langtextzeilen etwa 60–72 Zeichen.
  • Ein primärer Akzent + Neutrale.
  • Konsistente Bildverhältnisse und tonale Behandlung.
  • Sichtbare Hover-/Fokus-/Aktiv-Rückmeldungen.
  • Vermeiden Sie Neon-Lila, übermäßigen Glas-Morphismus, zufällige Bento-Grids, wiederholte Drei-Spalten-Abschnitte mit Symbolen, riesige vage Farbverläufe, unnötige Zähler/Carousels/Schreibmaschineneffekte.

Navigation

Desktop: [Logo] 4–5 Links ... [einzelner primärer CTA]

  • Wissen: Artikel / Themen / Hier beginnen / Über + Abonnieren.
  • Helfer: Dienstleistungen / Ablauf / Über / Artikel / FAQ + Buchen/Kontakt.
  • Vermeiden Sie Megamenüs für die Workshop-Basislinie.

CTA (Call-to-Action)

Höchstens drei semantische Ebenen:

  • Primär: Abonnieren ODER Erstgespräch buchen.
  • Sekundär: Passung/Ablauf/kostenlose Ressource verstehen.
  • Druckfrei: lesen/erkunden/mehr erfahren.

Helfersprache: „預約初談“, „了解合作方式“, „第一次來?先看看流程“, „開始聊聊“.

Bewegung

  • Hover 150–220ms
  • UI-Übergänge 180–350ms
  • Einblendung 400–650ms
  • Bewegung 4–16px
  • Skalierung ~0,98–1,03
  • Konsistentes „ease-out“
  • Bevorzugt Transform + Opacity
  • Respektiert prefers-reduced-motion

Der beabsichtigte Effekt: Benutzer nehmen Animationen vielleicht nicht bewusst wahr, aber die Website fühlt sich liebevoll gestaltet an.

Responsives Design

Nicht einfach den Desktop verkleinern.

  • Desktop: ~1080–1200px Container.
  • Tablet: Split-Layouts/fixe seitliche Inhalte vereinfachen.
  • Mobil: Einzelner Lesefluss, großzügiger Seitenabstand, wo hilfreich vollbreite Steuerelemente.
  • Helfer kann einen dauerhaften Buchungs-CTA verwenden, sofern dieser keine Inhalte überdeckt.

Qualitätssicherung vor Übergabe

  • Primäre Seitenaufgabe ist offensichtlich;
  • Hierarchie funktioniert auch ohne Dekoration;
  • Mobile Komposition funktioniert;
  • Kontrast/Zielgrößen/Fokuszustände sind nutzbar;
  • Bewegung ist subtil und optional;
  • Build-Vorgang ist erfolgreich;
  • Kein versehentliches Backend-Scope-Kriechen.

Verwandte Skills