NenadZivotic/lite-agent-skills

Offline On-Page-SEO-Audit einer lokalen HTML-Datei – Qualität von Titel und Meta-Beschreibung, Canonical, Robots-Meta, Viewport, Open-Graph-Tags, h1-Struktur, Bild-Alt-Abdeckung, Sprache/Zeichensatz. Kein Netzwerkzugriff. Verwenden Sie dies, wenn der Benutzer bittet, die SEO-Grundlagen einer Seite aus einer gespeicherten HTML- oder Vorlagendatei zu überprüfen.

Was ist lite-agent-skills?

Dieses Skill führt ein sofortiges, vollständig offline durchgeführtes SEO-Audit einer lokalen HTML-Datei durch. Es führt das Skript `scripts/audit.mjs` aus und berichtet über Bestehen/Warnung/Fehler für zentrale On-Page-SEO-Kriterien wie Titel, Meta-Beschreibung, Canonical-Tag, Robots-Meta, Viewport, Open-Graph-Tags, h1-Struktur, Bild-Alt-Texte, Sprache und Zeichensatz. Der Hauptvorteil liegt in der vollständigen Netzwerkunabhängigkeit: Es werden keine URLs abgerufen, keine `robots.txt` oder `sitemap.xml` geladen – ein klarer Hinweis auf diese Einschränkung sollte im Bericht gegeben werden. Das Skill erfordert Node 18 oder höher, hat keine Abhängigkeiten und gibt einen JSON-Bericht über `stdout` sowie einen Exit-Status von `1` bei Warnungen/Fehlern aus, sodass es sich ideal für CI/CD-Pipelines eignet. Der Fokus liegt auf der Prüfung lokaler HTML-Dateien, die der Benutzer bereitstellt; es werden niemals Dateien modifiziert. Für erweiterte Funktionen wie Live-URL-Abruf, `twitter-card`-Prüfung oder Weiterleitungsbehandlung gibt es die Vollversion `seo-quick-audit`.

Funktioniert mit~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/NenadZivotic/lite-agent-skills/tree/HEAD/seo-quick-audit-lite

Dokumentation

SEO-Kurzaudit (Lite)

Führt scripts/audit.mjs auf einer lokalen HTML-Datei aus, die der Benutzer bereitstellt, und meldet Bestehen/Warnung/Fehler für zentrale On-Page-SEO-Prüfungen. Vollständig offline – das Skript liest eine Datei und gibt JSON aus.

Umfang und Regeln

Nur Dateien prüfen, die der Benutzer bereitstellt. Diese Lite-Version ruft KEINE URLs, robots.txt oder sitemap.xml ab – sagen Sie dies bei der Berichterstattung.
Bestehen/Fehler basieren auf allgemeinen Konventionen, nicht auf Suchmaschinengarantien.
Die Datei niemals ändern. Nur lesend zugreifen.

1. Ausführen

Erfordert Node 18+, keine Abhängigkeiten.

node <skill-verzeichnis>/scripts/audit.mjs seite.html

JSON auf stdout; Exit-Code 1, wenn eine Warnung/Fehler vorliegt (CI-tauglich), 2 bei Lese-/Verwendungsfehler.

2. Bericht lesen

summary: Zählt Bestehen/Warnung/Fehler/Info.
checks[]: {id, status, detail} für: title, meta-description, canonical, robots-meta, viewport, open-graph, h1, img-alt, lang, charset.

3. Anleitung zur Behebung

title/meta-description Warnung → auf ca. 30-65 / 50-160 Zeichen umschreiben.
robots-meta: noindex auf einer Seite, die ranken soll → die Direktive entfernen.
canonical fehlt → <link rel="canonical"> hinzufügen.
h1 Fehler → genau eine beschreibende h1 pro Seite.
open-graph Warnung → og:title/og:description/og:image für Linkvorschauen hinzufügen.

Lite vs. Vollversion

Die Vollversion seo-quick-audit ruft zusätzlich Live-URLs ab, inklusive /robots.txt und /sitemap.xml-Status, Twitter-Card-Prüfung und Weiterleitungsbehandlung.