victor-shulga/website-audit

Was macht website-audit?

Ein einziger Befehl misst die Website; Sie bestätigen dann, was ein Skript nicht beurteilen kann, und übergeben einen Bericht, mit dem ein Gründer handeln kann. Das Audit ist Nur-Lese-Zugriff: Es sendet niemals ein Formular ab, meldet sich nie an, klickt nie auf etwas, das den Zustand ändert, respektiert robots.txt und macht Pausen zwischen Seitenaufrufen.

Eingaben

• URL (erforderlich). Fragen Sie danach, wenn der Benutzer keine angegeben hat.
• Seitenlimit (optional, Standard 10). Verwenden Sie 3–5 für einen schnellen Check, 15–25 für eine vollständige Basislinie vor dem Umbau.
• Berichtssprache (optional, Standard = die Sprache, in der der Benutzer schreibt).

Voraussetzungen

• Node.js 22 oder neuer (node --version). Lighthouse benötigt zusätzlich Node ≥ 22.19 und npm (npx).
• Google Chrome oder Chromium. Wird auf macOS, Linux und Windows automatisch erkannt, einschließlich eines Chromiums, das bereits durch npx playwright install chromium heruntergeladen wurde. Andernfalls setzen Sie CHROME_BIN=/pfad/zu/chrome.
• Netzwerkzugriff auf die geprüfte Website sowie ein öffentliches npm-CDN (axe-core) und die npm-Registry (Lighthouse). Wenn eines der Tools nicht abgerufen werden kann, wird dieser Bereich im Bericht mit dem Grund als übersprungen markiert; der Durchlauf schlägt nicht fehl.

Schritte

1. Führen Sie das Audit aus

<skill-dir> ist der Ordner, in dem diese SKILL.md lebt.

node <skill-dir>/scripts/audit.mjs https://example.com --limit 10

Optionen: --limit N · --delay MS (Pause zwischen Seiten, Standard 1000) · --max-links N (interne Linkprüfungen, Standard 150) · --no-lighthouse · --no-axe · --max-minutes N (Standard 15) · --out VERZ.

Die Ausgabe erfolgt in ./website-audit/<domain>/ relativ zum aktuellen Ordner (Überschreibung mit --out oder der Umgebungsvariable WEBSITE_AUDIT_OUT):

• website-audit-<domain>-<date>.md: der Bericht
• website-audit-<domain>-<date>.json: rohe Messungen, Ergebnisse, Bewertungen, Snapshot
• screens/: Screenshots des ersten Bildschirms pro Seite, Desktop und 390 px

Der Fortschritt geht nach stderr; die letzte stdout-Zeile ist eine JSON-Zusammenfassung (ok, report, pages, seconds, overall, counts, scores, skipped). Exit-Code 2 bedeutet, dass das Audit überhaupt nicht ausgeführt werden konnte (kein Node 22, kein Chrome, Website nicht erreichbar): Zeigen Sie dem Benutzer die Meldung; sie sagt, was zu installieren oder zu überprüfen ist.

Ein 10-Seiten-Durchlauf dauert etwa 2–4 Minuten; Lighthouse benötigt zusätzliche 30–60 Sekunden.

2. Manuelle Überprüfung

Folgen Sie <skill-dir>/references/manual-review.md:

1. Bestätigen Sie jede P0 anhand ihrer Beweise (das Skript ist wörtlich; Botschutz oder ein JavaScript-Formular können eine P0 vortäuschen).
2. Lösen Sie jeden «Manuell prüfen»-Eintrag auf, indem Sie die Screenshots in screens/ lesen.
3. Stellen Sie sicher, dass «Fix zuerst» als der erste Sprint des Umbaus gelesen werden kann.

Bearbeiten Sie den Markdown-Bericht direkt. Ändern Sie nicht das JSON; es ist die rohe Basislinie.

3. Sprache

Das Skript schreibt auf Englisch. Wenn der Benutzer in einer anderen Sprache schreibt, übersetzen Sie die Überschriften des Berichts, die Zeilen «Warum es für Leads wichtig ist» und «Fix». Lassen Sie URLs, Selektoren, Metriknamen, HTTP-Codes und P0- bis P3-Bezeichnungen unverändert.

4. Übergeben

Antworten Sie mit: Gesamtbewertung, P0-/P1-Anzahl, der «Fix zuerst»-Liste, welche Bereiche übersprungen wurden und warum, sowie dem Pfad zum Bericht. Bieten Sie an, später mit demselben Limit auf der neuen Website erneut auszuführen, um die Spalte «nachher» des Snapshots zu füllen.

Wenn der Benutzer möchte, dass der Bericht nach Bearbeitung der Schwellenwerte neu gerendert wird: node <skill-dir>/scripts/report.mjs <pfad-zum-lauf>.json schreibt den Markdown aus dem JSON neu.

Was jeder Bereich abdeckt

Details, Schwellenwerte und die Prioritätsregeln finden Sie in <skill-dir>/references/checks.md. Kurz gefasst:

Bereich	Wie
Mobiles Layout	jede Seite bei 360 / 390 / 768 px: seitliches Scrollen, Elemente über den Rand hinaus, Viewport-Meta, Tap-Ziele, winziger Text
Bugs	Konsolenfehler und -ausnahmen, 4xx/5xx und fehlgeschlagene Anfragen, gemischte Inhalte, defekte Bilder, interne Links (HEAD/GET), Formularziele (nur HEAD)
Barrierefreiheit	axe-core in jede Seite injiziert, WCAG 2.0/2.1 A + AA-Tags
Leistung	Lighthouse mobil auf der Startseite; Browser-Timing (TTFB, LCP, CLS, Gewicht, Anfragen) auf jeder Seite
Conversion-Pfad	CTA im ersten Bildschirm auf Desktop und Telefon, Klicks bis zum Kontakt, E-Mail / Telefon / Buchung / Lead-Formular, Testimonials, Fälle, Logos, Zahlen
SEO-Grundlagen	Titel, Beschreibung, eine H1, Kanonisch, Open Graph, noindex, robots.txt, sitemap.xml

Regeln

• Niemals Formulare absenden, ausfüllen oder darauf klicken; niemals anmelden; niemals Botschutz oder ein CAPTCHA umgehen. Wenn die Seite eine Challenge-Seite anzeigt, melden Sie dies und stoppen Sie.
• Respektieren Sie robots.txt-Disallow-Regeln; halten Sie die Standardverzögerung ein, es sei denn, der Benutzer besitzt die Website und bittet um einen schnelleren Durchlauf.
• Ergebnisse, die mit «Manuell prüfen» markiert sind, sind Hypothesen, bis Sie sich den Screenshot ansehen.
• Veröffentlichen Sie den Bericht nicht selbst an irgendeinem Ort; er könnte die Schwachstellen eines Kunden beschreiben.

Nicht dieses Skill

• Text-, Positionierungs- und Nachrichten-Kritik → website-copy-reframe.
• Ein Marken-/Designsystem von einer Website → design-system-generator.
• Keyword-Rankings, Backlinks, Verkehrsschätzungen → ein SEO-Datentool.