ai-agent-config

Konventionen für die Projekt-Config-Ebene der Coding-Agenten (CLAUDE.md / AGENTS.md / GEMINI.md) — Verhaltens-Baseline, Hierarchie, Token-Effizienz, Multi-Tool-Symlinks. Vor allem: die Entscheidung, was in CLAUDE.md gehört vs. in einen Skill vs. Auto-Memory vs. knowledge-base. Nutzen beim Aufsetzen/Verbessern von Projekt-Config. NICHT für das Schreiben einzelner Skills (→ skill-authoring).

Taxonomie der gängigen Webdesign-Richtungen (Editorial, Corporate, Premium/Luxury, Bold Branding, Minimalismus, Tech, Storytelling, Conversion, Content-First, Brand-First) mit Merkmalen und passenden Branchen/Zielen — um bewusst EINE Richtung zu wählen statt beim Default-Template zu landen. Nutzen bei Designrichtungs-Entscheidungen (Phase 5 in web-design-workflow). NICHT für die konkrete ästhetische Ausführung — dafür frontend-design.

Creative-Director-Prozess für individuelles Webdesign — Strategie → Designsystem → Layout → Inhalte → Code, statt sofort HTML zu erzeugen. Erzwingt Markenanalyse, 3–5 bewusst unterschiedliche Designkonzepte und ein fertiges Designsystem VOR dem ersten Layout. Nutzen bei neuer Website/Relaunch, wenn das Ergebnis nach Marke aussieht, nicht nach Template. NICHT für kleine Einzelseiten/Copy-only (→ landing-and-site-builder) oder reine Ästhetik-Fragen (→ frontend-design).

Formt aus priorisierten Findings einen konkreten, umsetzbaren Maßnahmenplan mit Prioritäts- und Aufwandseinordnung. Nutzen, wenn aus einem Audit ein Umsetzungsplan werden soll.

Übersetzt ein einzelnes technisches Barrierefreiheits-Finding (axe, Lighthouse, Pa11y, manuelle WCAG-Prüfung) in sachliche, verständliche Kundensprache. Nutzen, wenn ein Finding kundengerecht mit Auswirkung, Maßnahme und Priorität erklärt werden soll.

Erstellt aus technischen Audit-Rohdaten (Lighthouse, axe, Pa11y, auditmysite, manuelle Prüfung) eine verständliche Zusammenfassung für Endkunden. Nutzen, wenn ein ganzer Report/Scan kundenfreundlich zusammengefasst werden soll.

Erzeugt sachliche, kontextpassende Alt-Texte und erkennt dekorative Bilder (leeres alt). Nutzen, wenn Alt-Texte für Bilder gebraucht werden.

Überarbeitet Kunden-Copy (Landingpages, Blog, Mails), damit sie nicht „nach ChatGPT klingt" — spezifisch, menschlich, mit Belegen. Nutzen, wenn Text zu glatt/generisch/SaaS-ig wirkt, „nach AI" klingt oder entschärft werden soll. NICHT für reine Rechtschreib-/Grammatik-Korrektur, juristische/regulatorische Texte oder wenn ausdrücklich konventioneller Corporate-Ton gewünscht ist.

Findet falsche oder überflüssige ARIA-Nutzung (redundante Roles, kaputte id-Referenzen, ARIA statt nativem Element) und korrigiert sie. Nutzen beim Review von ARIA-Attributen.

Prüft eine einzelne Astro-/React-/HTML-Komponente auf typische Barrierefreiheitsprobleme und liefert konkrete Fixes. Nutzen beim a11y-Review einer Komponente. Für WCAG-Patterns siehe accessibility-audit.

Erstellt Vorher/Nachher-Kommunikation, die erzielte Barrierefreiheits-Verbesserungen für Kunden greifbar macht. Nutzen, wenn ein Re-Audit Fortschritt zeigt und das kommuniziert werden soll.

Entschärft alarmistische oder rechtlich absolute Aussagen zu BFSG, WCAG, Abmahnrisiko und Compliance, ohne die Kernaussage zu verlieren. Nutzen, wenn ein Text zu Barrierefreiheit juristische Drohkulisse enthält.

Erzeugt aus einem (YouTube-)Transkript einen strukturierten Blogartikel. Nutzen, wenn Video/Transkript zu Text werden soll.

Extrahiert die funktionale Markenstimme eines Kunden aus dessen Bestandstexten und hält sie als wiederverwendbare Voice-DNA-Spec fest, um sie über Kanäle (Landing, Blog, Mail, Social) konsistent zu replizieren. Nutzen, wenn eine Kundenstimme erfasst, dokumentiert oder für die Copy-Skills nutzbar gemacht werden soll. NICHT für Einzeltext-Korrektur, generische Tonfall-Wünsche ohne Kundenmaterial oder wenn nur eine Rechtschreib-/Grammatikprüfung gefragt ist.

Schreibt eine Case Study aus Vorher/Nachher-Audit-Daten. Nutzen, wenn ein Kundenprojekt als Referenz aufbereitet wird.

Generiert eine Kunden-E-Mail nach einem Accessibility-Audit — sachlich, lösungsorientiert, ohne Panikmache. Nutzen, wenn Audit-Ergebnisse per E-Mail an den Kunden gehen.

Schreibt Nutzungs-, Props- und Accessibility-Dokumentation für eine Komponente. Nutzen, wenn eine Komponente dokumentiert werden soll.

Prüft Website-Texte auf Verständlichkeit und Barrierefreiheit (Sprache, Struktur, Linktexte, Lesbarkeit). Nutzen beim Review von Inhaltstexten.

Prüft eine oder mehrere vergangene Sessions auf wiederkehrende Reibung und Korrekturen und wandelt jedes Muster in eine konkrete System-Verbesserung (neuer/erweiterter Skill, Memory-Eintrag, Guardrail). Nutzen für Retrospektiven ("was lief schief", "welche Skills fehlen", "Loop straffen", "System smarter machen"). NICHT für inhaltliche Zusammenfassungen einer Session oder einmalige Task-Komplexität.

Mehrquellen-Rechercheverfahren — Fan-out-Websuche, Quellen abrufen, Behauptungen adversarial verifizieren, zitierten Report synthetisieren. Nutzen für tiefe, faktengeprüfte Recherche (Markt, Wettbewerb, Technik, Thought-Leadership, Whitepaper). NICHT für einfache Faktenfragen, schnelle Lookups oder Themen-Monitoring (dafür topic-radar).

Erstellt FAQ-Einträge aus wiederkehrenden Barrierefreiheitsproblemen oder Supportfragen. Nutzen, wenn aus Problemen/Fragen ein FAQ werden soll.

Prüft Formulare auf Labels, Fehlermeldungen und Validierung und macht die Validierung barriereärmer. Nutzen beim Review von Formularen und Eingabefeldern.

Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.

Erzeugt am Ende einer Session einen kopierbaren Übergabe-Prompt, mit dem eine frische Session (leerer Kontext) nahtlos weitermacht. Nutzen, wenn eine Session übergeben oder der Kontext resettet werden soll, oder wenn man später/mit einem anderen Agenten weiterarbeiten will. NICHT für laufende Arbeit oder ein reines Ergebnis-Fazit — dafür ist der Recap-Schritt da.

Prüft Tastaturbedienbarkeit: Fokusreihenfolge, sichtbarer Fokus, Tastatur-Fallen, vollständige Bedienung ohne Maus. Nutzen, wenn Keyboard-Access geprüft werden soll.

Belegte, kompoundierende Wissensbasis für Kunden-/Domänenfakten (Projektfakten, wiederkehrende A11y-Muster, BFSG-Stand) als untereinander verlinkte Markdown-Seiten mit Quellen-Herkunft. Kompiliert Wissen einmal statt pro Query neu (RAG-Alternative). Nutzen, wenn Fakten aus Quellen dauerhaft abgelegt, verlinkt, gelintet oder abgefragt werden sollen, oder wenn Case-Study/FAQ/Artikel belegtes Projektwissen brauchen. NICHT für konversationelle Auto-Memory (MEMORY.md), einmalige Lookups oder flüchtige Notizen.

End-to-end-Workflow, um eine Website oder Landingpage im Astro-Stack zu planen und zu bauen — oder als Design-Brief an Claude design zu übergeben. Orchestriert die vorhandenen Design-, Content-, SEO- und A11y-Skills über einen Vertical-Slice-Loop mit Council-Entscheidungs-Gate. Nutzen beim Start einer neuen Site/Landing, beim Umstrukturieren oder wenn aus einem Briefing eine gebaute Seite werden soll.

Erzeugt Landingpage-Abschnitte aus Briefing, Produktnotizen oder Report-Daten. Nutzen, wenn aus Rohinput Landingpage-Copy werden soll.

Erklärt Lighthouse- und axe-Ergebnisse: was die Regel bedeutet, warum sie zählt, wie man sie behebt. Nutzen, wenn Tool-Output eingeordnet werden soll (intern/technisch).

Bereitet ein Finding, einen Artikel oder eine Erkenntnis als LinkedIn-Post auf. Nutzen, wenn aus Bestandsinhalt ein Social-Post werden soll.

Deliberationsverfahren (Karpathys „LLM Council") für Entscheidungen mit echten Zielkonflikten — unabhängige Perspektiven erzeugen, sich gegenseitig kritisieren lassen, dann synthetisieren. Nutzen bei Strategie, Positionierung, Architektur, Preisgestaltung, Priorisierung, Design-Richtung. NICHT für Faktenfragen, Zusammenfassungen, Übersetzungen oder kleine Aufgaben.

Motion design system for Astro + Tailwind v4 + Svelte 5 — animation tokens, component state patterns, scroll reveals, performance rules, and modern CSS 2025/2026 features. Use this skill whenever adding any animation, transition, hover effect, scroll reveal, micro-interaction, or motion to any component or page. Also use when the user mentions "animation", "transition", "hover effect", "motion", "scroll reveal", "fade in", "entrance animation", "interactive feel", or wants a page to feel "more alive", "more polished", or "like Stripe/Apple/Linear/Vercel".

Formt Audit-Erkenntnisse in einen Newsletter-Abschnitt. Nutzen, wenn aus Ergebnissen/Erkenntnissen ein Newsletter werden soll.

Erklärt sachlich Risiken und Grenzen von Accessibility-Overlay-Tools (UserWay, accessiBe, EqualWeb u.a.) gegenüber echter Barrierefreiheit. Nutzen, wenn ein Kunde ein Overlay einsetzen will oder danach fragt.

Post-build SEO / link / a11y audit via @casoon/astro-post-audit — integration setup, options, what it checks, and how to fix common findings. Use when wiring up build audits or resolving audit failures.

Ersetzt div/span-Suppe durch semantisch korrektes HTML (Landmarks, Überschriftenhierarchie, native Elemente). Nutzen, wenn Markup semantisch verbessert werden soll.

Macht aus Messdaten und Audit-Findings einen SEO-Blogartikel. Nutzen, wenn aus Report-/Scan-Daten Content werden soll. Für On-Page-SEO-Mechanik siehe seo.

Conventions for skills in this repo — folder structure, description writing, gotcha-first content, categories taxonomy, and governance. Use when reviewing an existing skill for quality or deciding where a new skill belongs. For creating a skill from scratch or running evals, use skill-creator instead.

Diszipliniertes Root-Cause-Debugging für harte Bugs und Performance-Regressionen im Astro/Cloudflare-Stack — zuerst eine schnelle Pass/Fail-Feedback-Loop bauen, dann Ursache belegen, dann minimal fixen. Nutzen, wenn etwas kaputt/flaky ist, wirft, fehlschlägt, sich falsch verhält, seit einem Deploy langsamer wurde, oder wenn schon 2+ Fix-Versuche gescheitert sind. Nicht für triviale, offensichtliche Einzeiler (Typo, fehlender Import) und nicht für das Schreiben neuer E2E-Specs (siehe playwright).

Scannt periodisch eine kuratierte Quellen-Liste (Wettbewerber-Blogs, WCAG/BFSG-News, Astro-/Cloudflare-Releases, Branchen-Feeds), filtert Neues nach Relevanz + Aktualität und liefert gerankte Content-Chancen. Nutzen für Blog-Themenfindung und um [[linkedin-post-from-content]] / [[newsletter-from-audit]] zu speisen. NICHT für eine einmalige, gezielte Recherche zu einem Thema — dafür [[deep-research]].