Communitygithub.com

IncomeStreamSurfer/astro-builder-skill

Erstelle vollständige, SEO-optimierte Websites mit Astro, Tailwind CSS, Content Collections und optionaler Turso-Datenbank. Verwende diesen Skill immer dann, wenn ein Benutzer eine Website erstellen, eine bei Google rankende Seite bauen, ein Astro-Projekt starten, eine Landing-Page, eine Business-Website, einen Blog oder ein beliebiges Webprojekt mit SEO-Relevanz umsetzen möchte.

Was ist astro-builder-skill?

Dieser Skill (IncomeStreamSurfer/astro-builder-skill) ist ein umfassender Baukasten für die Erstellung produktionsreifer, SEO-optimierter Websites mit dem Astro-Framework. Er richtet sich an Entwickler, die qualitativ hochwertige, suchmaschinenfreundliche Webseiten erstellen möchten – von einfachen Landing Pages bis hin zu umfangreichen Blogs oder Business-Websites mit dynamischen Inhalten. Der Skill unterstützt die Plattformen Astro, React, Tailwind CSS und optional Turso (eine Edge-SQLite-Datenbank). Der Workflow ist in fünf Phasen unterteilt: Discovery & Research (inklusive Keyword-Recherche), Projekt-Setup, Bau jeder Seite (mit strengen SEO- und Design-Regeln), Content Collections & Datenbank-Integration und Deployment-Vorbereitung. Besonderes Augenmerk liegt auf der Vermeidung von generischem „AI-Slop“ – die Design-Regeln (taste-skill) und die SEO-Checkliste sorgen für ein hochwertiges, individuelles Ergebnis. Der Skill enthält detaillierte Anleitungen zu Komponenten wie SEOHead, Astro Islands für Interaktivität und die Konfiguration von Sitemaps und robots.txt.

Funktioniert mit✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/IncomeStreamSurfer/astro-builder-skill/tree/HEAD/skill

In Ihrer bevorzugten KI fragen

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

Dokumentation

Astro SEO Website Builder

Du erstellst vollständige, deployment-bereite Websites in Astro, die darauf ausgelegt sind, bei Google zu ranken. Jede Seite wird mit korrekten Meta-Tags, strukturierten Daten, semantischem HTML, optimierten Bildern, Sitemaps und echten, recherchierten Inhalten ausgeliefert – kein Platzhaltertext.

Jedes Frontend, das du produzierst, muss erstklassig und nicht generisch sein. Lies references/taste-skill.md, bevor du UI-Code schreibst – es enthält die Designregeln, die generischen "AI-Slop" verhindern.

Tech-Stack

  • Astro — Static-First-Framework, standardmäßig null JS, perfekt für SEO
  • React — Interaktive Komponenten über Astro Islands (Formulare, Navigation, Animationen)
  • Tailwind CSS — Sämtliches Styling. Keine Shadcn-Standardeinstellungen – alles gemäß den Taste-Skill-Regeln anpassen
  • Astro Content Collections — Typsichere Markdown/MDX-Inhalte für Blogbeiträge, Dienstleistungen, Testimonials
  • Turso + Drizzle — Edge SQLite-Datenbank (optional, für Formulare/dynamische Daten)

Workflow-Übersicht

Jedes Projekt folgt dieser Reihenfolge. Keine Schritte überspringen.

Phase 1: Discovery & Research

  1. Frage den Benutzer nach seiner Nische, seinem Unternehmen und seinen Zielen
  2. Frage, ob eine Datenbank benötigt wird (für Kontaktformulare, Leads, Buchungen usw.)
  3. Recherchiere die Nische – was rankt, welche Keywords sind wichtig, welche inhaltlichen Lücken gibt es
  4. Schlage eine Seitenstruktur mit Seitenliste, Content-Strategie und Keyword-Zielen vor
  5. Hole die Zustimmung des Benutzers ein, bevor du mit dem Bauen beginnst

Phase 2: Projekt-Setup

  1. Richte das Astro-Projekt ein
  2. Installiere und konfiguriere Integrationen (React, Tailwind, Sitemap)
  3. Richte das Basis-Layout, SEO-Komponenten und das Design-System ein

Phase 3: Jede Seite bauen

  1. Lies references/taste-skill.md für die Designregeln
  2. Wenn der Benutzer generierte Bilder wünscht, lies references/image-generation.md und generiere Bilder für jede Seite
  3. Erstelle jede Seite mit echten, recherchierten Inhalten
  4. Vollständiges SEO auf jeder Seite – Meta-Tags, OG-Tags, strukturierte Daten, semantisches HTML
  5. Binde interaktive Komponenten ein (Formulare, Navigation usw.)

Phase 4: Content Collections & Datenbank

  1. Konfiguriere Astro Content Collections für Blogbeiträge, Dienstleistungen usw.
  2. Wenn eine Datenbank gewünscht wird: Richte Turso ein, erstelle Schemata, baue API-Routen
  3. Baue ein Admin-Dashboard für Datenbankdaten, falls zutreffend

Phase 5: Deployment-Vorbereitung

  1. Generiere Sitemap, robots.txt
  2. Konfiguriere das Deployment (Vercel/Netlify)
  3. Abschließendes SEO-Audit jeder Seite

Phase 1: Discovery & Research

Frage den Benutzer

Bevor du Code schreibst, verstehe das Projekt:

  1. Was ist Ihre Niche/Ihr Unternehmen? — "Ich bin Klempner in Dublin" oder "Ich verkaufe handgemachte Kerzen online"
  2. Was ist das Hauptziel der Website? — Lead-Generierung, E-Commerce, Portfolio, Blog, SaaS-Landing-Page
  3. Wie viele Seiten möchten Sie? — Klein (5-10 Seiten) oder inhaltsreich (15-30+ Seiten mit Blog)
  4. Benötigen Sie eine Datenbank? — Zum Speichern von Formulareingaben, Buchungen, Benutzerdaten usw. Wenn ja, richte Turso ein.
  5. Möchten Sie generierte Bilder? — "Ich kann für Ihre Website benutzerdefinierte Stockbilder mit Gemini generieren. Wenn Sie dies wünschen, fügen Sie Ihren GEMINI_API_KEY zur .env-Datei hinzu."
  6. Haben Sie eine Domain? — Wird für Sitemap/kanonische URLs benötigt. Verwende einen Platzhalter, wenn noch nicht gekauft.
  7. Gibt es Design-Präferenzen? — Farben, Stil, vorhandenes Branding

Recherchiere die Nische

Nutze die Websuche, um Folgendes zu finden:

  • Was rankt derzeit für die Ziel-Keywords – die Top 5-10 Ergebnisse
  • Inhaltliche Lücken – welche Fragen werden nicht gut beantwortet
  • Long-Tail-Keywords – spezifische Phrasen mit weniger Konkurrenz
  • Lokale SEO-Signale, wenn es ein lokales Unternehmen ist
  • Strukturen der Konkurrenzseiten – welche Seiten sie haben, welche ihnen fehlen

Schlage die Seitenstruktur vor

Erstelle basierend auf der Recherche einen konkreten Vorschlag. Beispiel für einen Klempner:

Vorgeschlagene Seiten:
1. Startseite — "Klempner Dublin | 24/7 Notfall-Klempnerdienste"
2. Dienstleistungen — Übersicht über alle Dienstleistungen
3. Dienstleistungen/Notfall-Klempner — Gezielte Landing-Page
4. Dienstleistungen/Badezimmer-Renovierung — Gezielte Landing-Page
5. Dienstleistungen/Heizungsreparatur — Gezielte Landing-Page
6. Über uns — Vertrauenssignale, Team, Qualifikationen
7. Blog — Laufender Content für SEO
8. Blog/[slug] — Einzelne Beiträge, die auf Long-Tail-Keywords abzielen
9. Kontakt — Formular + Karte + Telefon
10. Gebiete, die wir bedienen — Lokale SEO-Seiten
11. Testimonials — Soziale Beweise

Ziel-Keywords: notfall klempner dublin, klempner in meiner nähe dublin, heizungsreparatur dublin...
Content-Strategie: Wöchentliche Blogbeiträge, die auf "Wie behebe ich [häufiges Problem]"-Anfragen abzielen

Hole die Zustimmung des Benutzers ein, bevor du fortfährst.


Phase 2: Projekt-Setup

Lies references/astro-setup.md für genaue Befehle und Konfiguration.

1. Projekt erstellen

npm create astro@latest [Projektname] -- --template minimal --install --no-git
cd [Projektname]

2. Integrationen installieren

npx astro add react tailwind sitemap
npm install @astrojs/check typescript
npm install @fontsource/geist-sans @fontsource/geist-mono  # Premium-Schriftarten gemäß Taste-Skill

3. Wenn eine Datenbank gewünscht wird

Lies references/turso-setup.md für die vollständige Turso-Konfiguration.

npm install @libsql/client drizzle-orm

4. Projektstruktur

src/
├── components/
│   ├── SEOHead.astro
│   ├── Header.astro
│   ├── Footer.astro
│   ├── Navigation.tsx    # React Island
│   └── ContactForm.tsx   # React Island
├── content.config.ts     # Content-Collection-Schemata (NICHT in content/)
├── content/
│   ├── blog/
│   ├── services/
│   └── testimonials/
├── layouts/
│   └── BaseLayout.astro
├── lib/
│   ├── turso.ts          # Wenn Datenbank
│   └── utils.ts
├── pages/
│   ├── index.astro
│   ├── about.astro
│   ├── contact.astro
│   ├── blog/
│   │   ├── index.astro
│   │   └── [...slug].astro
│   └── api/              # API-Routen (wenn Datenbank)
├── styles/
│   └── globals.css
└── middleware.ts
astro.config.mjs

Phase 3: Jede Seite bauen — Design + SEO

Bevor du eine Seite schreibst, lies beide:

  • references/seo-checklist.md — SEO-Regeln für jede Seite
  • references/taste-skill.md — Designregeln zur Vermeidung generischer Ausgaben

Die SEOHead-Komponente

Erstelle src/components/SEOHead.astro – kommt in den <head> jeder Seite. Behandelt:

  • Title-Tag (einzigartig pro Seite, primäres Keyword, unter 60 Zeichen)
  • Meta-Beschreibung (einzigartig, CTA, unter 160 Zeichen)
  • Kanonische URL
  • Open-Graph-Tags
  • Twitter-Card-Tags
  • JSON-LD-strukturierte Daten

Siehe references/seo-checklist.md für den genauen Komponenten-Code.

Content-Schreibregeln

  • Schreibe zuerst für Menschen, dann für Suchmaschinen.
  • Jede Seite zielt auf einen bestimmten Keyword-Cluster ab. Primäres Keyword in Titel, H1, erstem Absatz, Meta-Beschreibung, URL-Slug.
  • Korrekte Überschriften-Hierarchie. Eine H1. H2s für Abschnitte. H3s für Unterabschnitte. Nie Ebenen überspringen.
  • Interne Verlinkung. Jede Seite verlinkt auf 2-3+ andere Seiten. Beschreibender Ankertext.
  • Alt-Text für Bilder. Jedes Bild erhält beschreibenden Alt-Text mit natürlichen Keywords.
  • Content-Länge. Dienstleistungsseiten: 800-1500 Wörter. Blogbeiträge: 1500-3000 Wörter. Startseite: 500-1000 Wörter.
  • Schema-Markup. Jede Seite erhält passendes JSON-LD.

Designregeln (aus Taste-Skill)

Diese sind für jede Seite, die du baust, nicht verhandelbar:

  • Typografie: Verwende Geist, Satoshi, Outfit oder Cabinet Grotesk. NIEMALS Inter. Überschriften: text-4xl md:text-6xl tracking-tighter leading-none.
  • Farben: Maximal 1 Akzentfarbe, Sättigung < 80%. Keine lila/blauen AI-Verläufe. Neutrale Basen (Zinc/Slate).
  • Layout: Keine zentrierte Hero, wenn DESIGN_VARIANCE > 4. Verwende Split-Screen, asymmetrische oder linksbündige Layouts.
  • Karten: Nur wenn Höhe eine Hierarchie vermittelt. Keine generischen 3-Spalten-Kartenlayouts.
  • Abstände: min-h-[100dvh] nicht h-screen. Grid nicht Flexbox-Mathe. max-w-7xl mx-auto.
  • Zustände: Jede interaktive Komponente benötigt Lade-, Leer- und Fehlerzustände.
  • Kein AI-Slop: Keine Emojis, kein "Max Mustermann", keine "Musterfirma", keine Füllwörter wie "nahtlos" oder "entfesseln".

Astro Islands für Interaktivität

  • Statische Inhalte (Überschriften, Text, Bilder) — .astro-Komponenten, null JS
  • Interaktive Elemente (Formulare, mobile Navigation, Scroll-Animationen) — React .tsx mit client:visible oder client:load
  • Animationen: Für Bewegung (MOTION_INTENSITY > 5), verwende Framer Motion in isolierten React-Islands. Feder-Physik: type: "spring", stiffness: 100, damping: 20.

Lies references/tailwind-components.md für Komponentenmuster (Navigation, Formulare, FAQ usw.)


Phase 4: Content Collections & Datenbank

Astro Content Collections

Lies references/content-collections.md für das vollständige Setup. Content Collections ersetzen ein CMS – Inhalte leben als Markdown-Dateien in src/content/ mit typsicheren Schemata.

WICHTIG: Definiere Schemata in src/content.config.ts (NICHT src/content/config.ts – der alte Pfad wirft LegacyContentConfigError in Astro v5+). Jede Collection muss einen loader haben (verwende glob() aus astro/loaders).

Definiere Schemata in src/content.config.ts:

  • Blogbeiträge: title, description, pubDate, image, tags, author, draft
  • Dienstleistungen: title, description, icon, order, featured
  • Testimonials: name, role, quote, rating

Rufe Collections in Seiten mit getCollection() und getEntry() ab.

Turso-Datenbank (falls gewünscht)

Lies references/turso-setup.md für das vollständige Setup. Turso behandelt dynamische Daten – Formulareingaben, Leads, Buchungen, Newsletter-Anmeldungen.

  1. Erstelle den Datenbank-Client in src/lib/turso.ts
  2. Definiere Schemata mit Drizzle ORM
  3. Erstelle API-Routen in src/pages/api/ für die Formularverarbeitung
  4. Baue ein Admin-Dashboard zur Anzeige der eingereichten Daten

Admin-Dashboard (falls Datenbank)

Baue unter /admin unter Verwendung von React-Islands mit Tailwind-gestyhlten Tabellen und Karten. Verwendet:

  • Middleware für einfache Authentifizierung
  • API-Routen zum Abrufen von Daten aus Turso
  • Saubere, geschmackvolle Datenpräsentation (gemäß Taste-Skill-Regeln – keine generischen Kartenraster)

Phase 5: Deployment-Vorbereitung

Sitemap & Robots.txt

@astrojs/sitemap generiert die Sitemap automatisch. Setze site in astro.config.mjs.

Dynamische robots.txt unter src/pages/robots.txt.ts:

import type { APIRoute } from 'astro';

const getRobotsTxt = (siteURL: string) => `User-agent: *
Allow: /
Disallow: /admin
Sitemap: ${siteURL}sitemap-index.xml`;

export const GET: APIRoute = ({ site }) => {
  return new Response(getRobotsTxt(site?.toString() || ''));
};

Deployment-Konfiguration

Lies references/deployment.md für Vercel/Netlify-Konfigurationen.

Für Websites mit API-Routen oder Turso füge einen Adapter hinzu, behalte aber die standardmäßige statische Ausgabe bei. Markiere einzelne Server-Routen mit export const prerender = false;:

import vercel from '@astrojs/vercel';

export default defineConfig({
  // Verwende NICHT output: 'hybrid' — in Astro v5 entfernt.
  // Standard ist 'static'. Server-gerenderte Routen optieren individuell aus.
  adapter: vercel(),
});

In jeder API-Route oder server-gerenderten Seite:

// src/pages/api/contact.ts
export const prerender = false; // Diese Route läuft auf dem Server

export const POST: APIRoute = async ({ request }) => {
  // ...
};

Abschließendes SEO-Audit

Prüfe jede Seite gemäß references/seo-checklist.md:

  • Einzigartiger Titel, Beschreibung, kanonische URL pro Seite
  • Alle Bilder haben Alt-Text
  • JSON-LD ist valide
  • Interne Links funktionieren
  • Mobil responsive (teste Taste-Skill-Mobile-Override-Regeln)
  • Sitemap enthält alle Seiten
  • robots.txt ist korrekt

Wichtige Hinweise

  • Verwende NICHT output: 'hybrid' — es wurde in Astro v5 entfernt. Verwende die Standardausgabe 'static'. Für server-gerenderte Routen (API-Endpunkte, Formularhandler) füge export const prerender = false; in jeder Datei hinzu.
  • React-Islands benötigen Hydratations-Direktiven — client:load oder client:visible.
  • Content Collections sind dateibasiert. Blogbeiträge und Dienstleistungen leben als .md-Dateien in src/content/. Turso ist nur für dynamische Daten (Formulareingaben) gedacht.
  • Recherchiere vor dem Bauen. Die Nischen-Recherche-Phase bestimmt die SEO-Qualität.
  • Echte Inhalte gewinnen. Schreibe substanzielle, hilfreiche Inhalte. Kein Lorem Ipsum.
  • Immer Premium-Design. Folge den Taste-Skill-Regeln. Jede Seite sollte wie ein 10.000 € Agentur-Build aussehen, nicht wie eine generische AI-Ausgabe.
  • Bildgenerierung ist optional. Wenn der Benutzer einen GEMINI_API_KEY bereitstellt, generiere benutzerdefinierte Bilder gemäß references/image-generation.md. Wenn nicht, verwende gestylte Platzhalter-Divs mit korrektem Alt-Text.

Verwandte Skills