NenadZivotic/lite-agent-skills

Audit SEO hors ligne d'un fichier HTML local — qualité du titre et de la méta-description, canonique, robots meta, viewport, balises Open Graph, structure h1, couverture alt des images, lang/charset. Aucun accès réseau. À utiliser lorsque l'utilisateur demande de vérifier les bases SEO d'une page à partir d'un fichier HTML sauvegardé ou d'un modèle.

Qu'est-ce que lite-agent-skills ?

Ce skill exécute un audit SEO de base sur un fichier HTML local, entièrement hors ligne, en exécutant le script `scripts/audit.mjs`. Il vérifie des éléments essentiels comme le titre, la méta-description, la balise canonique, les métadonnées robots, viewport, les balises Open Graph, la structure h1, les attributs alt des images, ainsi que les déclarations de langue et de jeu de caractères. Il est utile pour les développeurs qui souhaitent valider rapidement les pratiques SEO de base d'une page enregistrée localement ou d'un fichier modèle, sans dépendre d'un accès réseau. Le rapport JSON renvoie un statut pass/warn/fail pour chaque élément, avec un code de sortie 1 en cas d'échec, ce qui permet une intégration dans des pipelines CI. Il est conçu pour fonctionner avec Node.js 18+ et ne nécessite aucune dépendance externe.

Compatible avec~Claude Code~Codex CLI~Cursor

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

Documentation

Audit SEO Rapide (Lite)

Exécute scripts/audit.mjs sur un fichier HTML local fourni par l'utilisateur et rapporte les résultats pass/warn/fail pour les contrôles SEO essentiels de la page. Complètement hors ligne — le script lit un fichier et émet du JSON.

Périmètre et règles

Auditer uniquement les fichiers fournis par l'utilisateur. Cette version lite ne récupère PAS les URL, robots.txt ou sitemap.xml — indiquez-le lors du rapport.
Les résultats pass/fail sont basés sur des conventions courantes, pas sur des garanties des moteurs de recherche.
Ne jamais modifier le fichier. Lecture seule.

1. Exécution

Nécessite Node 18+, zéro dépendance.

node <chemin-du-skill>/scripts/audit.mjs page.html

JSON sur stdout ; code de sortie 1 si un avertissement ou une erreur est présent (intégrable en CI), 2 en cas d'erreur de lecture ou d'utilisation.

2. Lire le rapport

summary : compteurs pass/warn/fail/info.
checks[] : {id, status, detail} pour : title, meta-description, canonical, robots-meta, viewport, open-graph, h1, img-alt, lang, charset.

3. Conseils de correction

title/meta-description warn → réécrire pour avoir environ 30-65 / 50-160 caractères.
robots-meta: noindex sur une page destinée à être classée → supprimer la directive.
canonical manquant → ajouter <link rel="canonical">.
h1 fail → exactement un h1 descriptif par page.
open-graph warn → ajouter og:title/og:description/og:image pour les aperçus de liens.

Lite vs complet

La version complète seo-quick-audit récupère en plus des URL en direct, y compris l'état de /robots.txt et /sitemap.xml, la vérification twitter-card et la gestion des redirections.