diff --git a/.agents/skills/technical-seo-semantic/SKILL.md b/.agents/skills/technical-seo-semantic/SKILL.md new file mode 100644 index 0000000..f6a6538 --- /dev/null +++ b/.agents/skills/technical-seo-semantic/SKILL.md @@ -0,0 +1,12 @@ +--- +name: technical-seo-semantic +description: Implementiert vollautomatisch modernste On-Page-SEO, technische Indexierungs-Richtlinien und semantische HTML-Strukturen für maximale Sichtbarkeit bei Google. +--- + +# Technical SEO & Semantic Guidelines + +* **Semantische HTML-Hierarchie:** Striktes Einhalten der Überschriften-Kette (Genau eine H1 pro Seite, gefolgt von logischen H2 und H3). Reine Design-Elemente dürfen niemals als H-Tags missbraucht werden. +* **Strukturierte Daten (Schema.org / JSON-LD):** Jede Mustervorlage erhält automatisch ein dynamisches, valides JSON-LD-Skript im `` (z.B. Typ `LocalBusiness`, `Handyman` oder `ProfessionalService`) inklusive Geo-Koordinaten, Öffnungszeiten und Bewertungs-Mockups. +* **Meta-Daten & OpenGraph:** Automatisches Bereitstellen von performanten SEO-Title-Tags (maximal 60 Zeichen), Meta-Descriptions (maximal 155 Zeichen) und OpenGraph-Tags für perfekte Previews beim Teilen auf WhatsApp/Social Media. +* **Crawler-Sicherheit (Akkordeons & Tabs):** Textinhalte in ausklappbaren Elementen (FAQs) werden niemals per CSS `display: none` vor Crawlern versteckt, sondern via barrierefreier Techniken im DOM gehalten, damit Google den Content voll indexieren kann. +* **Core-Web-Vitals als Rankingfaktor:** Erzwingen von korrekten Bild-Dimensionen (WebP/AVIF mit width/height) und Vermeidung von JavaScript im kritischen Render-Pfad, um die Google-Metrik "INP" (Interaction to Next Paint) zu optimieren.