CommunityRédaction et éditiongithub.com

k97/skills

Compétences pour agents de codage IA. codebase-seo : Audit SEO + GEO qui trace les boucles de redirection, vérifie le JSON-LD et applique les corrections dans votre codebase.

Qu'est-ce que skills ?

Codebase-seo est une compétence pour agents IA (comme Claude Code, Cursor, Codex) qui automatise un audit SEO technique complet, une revue de préparation à la citation par l'IA (GEO), et l'application des correctifs directement dans votre codebase. Elle est conçue pour des projets Next.js/TypeScript mais s'adapte à la stack utilisée. La compétence fonctionne en trois phases : (1) un audit technique avec des scripts shell/Node qui tracent les boucles de redirection, analysent le JSON-LD et les métadonnées ; (2) une revue GEO qui vérifie les schémas, les opportunités de contenu et les décisions d'architecture ; (3) l'application des correctifs de manière minimale et ciblée, sans modifications superflues. Elle prend en charge les flags --audit, --geo, --fix et --full, ainsi qu'un paramètre --routes pour limiter l'analyse. La compétence inclut des règles strictes concernant les redirections hôte (ne jamais ajouter de redirection au niveau applicatif) et l'utilisation de données réelles pour les schémas (ne jamais inventer de valeurs).

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add k97/skills

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

codebase-seo

Auditez, puis révisez GEO, puis appliquez les correctifs. Valeurs par défaut Next.js / TypeScript ; suivez ce que le dépôt utilise déjà. ${CLAUDE_SKILL_DIR} est le répertoire de cette compétence — le répertoire de travail est le projet de l'utilisateur, adressez donc les fichiers groupés via celui-ci.

DrapeauPhaseÉcrit du code
--audit1 — SEO techniquenon
--geo2 — Préparation à la citation IAnon
--fix3 — Appliquer les résultats déjà en contexteoui
--full1 → 2 → 3 (par défaut)oui

--routes /,/pricing limite le périmètre ; par défaut, toutes les routes.

Configuration

  • Préférez un chemin local et une URL en ligne. Chacun capture ce que l'autre ne peut pas.
  • Lisez .agents/product-marketing.md ou .claude/product-marketing.md si l'un d'eux existe. Ne demandez que ce qu'il ne répond pas.
  • --fix nécessite des rapports en contexte. S'ils sont absents, exécutez --full.

Scripts

Nécessite curl et Node 18+, rien à installer. Exécutez-les avant de lire le code source : ils produisent les preuves, l'inspection du code source les explique. Chacun se termine avec un code non nul en cas de problème de niveau erreur. Ajoutez --json aux scripts Node pour une sortie structurée.

bash "${CLAUDE_SKILL_DIR}/scripts/redirect-trace.sh" example.com /pricing /blog
node "${CLAUDE_SKILL_DIR}/scripts/extract-jsonld.mjs" https://example.com/pricing
node "${CLAUDE_SKILL_DIR}/scripts/audit-meta.mjs" https://example.com/pricing
node "${CLAUDE_SKILL_DIR}/scripts/audit-meta.mjs" out/pricing.html --base https://example.com

Passez des routes réelles à redirect-trace.sh — les boucles se cachent souvent sur des chemins profonds, pas sur /.

Les trois lisent uniquement le HTML rendu côté serveur. Le JSON-LD injecté côté client leur est invisible, comme il l'est à web_fetch. N'écrivez jamais "aucun schéma trouvé" sur la seule parole d'un script ; confirmez dans un navigateur.

Phase 1 — audit technique (--audit)

Lisez ${CLAUDE_SKILL_DIR}/references/technical-audit.md et parcourez sa liste de contrôle. Exécutez d'abord les scripts, puis utilisez le code source pour localiser et expliquer chaque constatation.

Rapport par constatation :

Fichier : app/page.tsx:37-41
Sévérité : Critique | Élevée | Moyenne | Faible
Cause racine : <une phrase>
Impact : <ce qui se casse dans la recherche, les réseaux sociaux ou la citation IA>
Correctif : <changement minimal, fichier + ligne>
Effort : <5 min | 30 min | décision produit>

Groupez par sévérité, puis terminez par un tableau : # | Constatation | Sévérité | Effort | Bloque la publication ?

Phase 2 — revue GEO (--geo)

Lisez ${CLAUDE_SKILL_DIR}/references/geo.md. JSON-LD à copier : ${CLAUDE_SKILL_DIR}/references/schema-recipes.md.

Vérifiez d'abord l'accès des robots — si les crawlers sont bloqués, rien d'autre dans cette phase n'a d'importance.

Deux affirmations à ne jamais faire : que les types de schémas ont un classement de rendement de citation "selon une recherche de Princeton" (cette étude testait des tactiques de contenu, pas les schémas), et toute augmentation de trafic projetée. Ni l'une ni l'autre n'est observable depuis une codebase, et les inventer discrédite les vraies constatations.

Groupez la sortie en Lacunes de schémas, Opportunités de contenu, Décisions d'architecture.

Phase 3 — correctif (--fix)

Applique les constatations des Phase 1 et Phase 2. Modifiez l'arbre de travail et arrêtez-vous — pas de git add, pas de git commit. La revue et le commit reviennent à l'utilisateur.

  • Respectez le framework, la disposition des fichiers et l'orthographe du dépôt. N'imposez pas un dialecte.
  • Nommez le fichier exact et la ligne avant chaque modification. Changement minimal, pas de refactorisations annexes, pas de any.
  • Raccordez les champs de schéma aux sources de données réelles ; ne codez jamais en dur une valeur qui dérive.
  • N'inventez jamais un aggregateRating. Supprimez-le et listez-le sous "nécessite des données réelles".
  • Ignorez l'architecture i18n, la copie en dehors des descriptions de schéma, et tout ce que le rapport marque comme nécessitant une décision produit.

Redirections hôte — règle stricte. Une redirection www↔apex, http↔https ou de barre oblique finale au niveau de l'application qui duplique une redirection déjà effectuée par la plateforme d'hébergement va faire des allers-retours, produire ERR_TOO_MANY_REDIRECTS et faire tomber le site. Laissez la canonicalisation de l'hôte à la plateforme. Corrigez une boucle en supprimant la redirection au niveau de l'application, jamais en en ajoutant une autre. Lorsque l'hôte canonique et l'hôte réellement servi sont en désaccord, changez les métadonnées pour correspondre à l'hôte effectivement servi — pas la redirection pour correspondre aux métadonnées.

Lot 1 : chaque constatation Critique, Élevée et Moyenne de la Phase 1, dans l'ordre de sévérité. Lot 2 : le travail de schéma de la Phase 2.

Vérifiez avant de signaler comme terminé. Ne prétendez jamais au succès sur la seule force des modifications.

  1. Le projet compile (npm run build, ou ce que le dépôt utilise).
  2. extract-jsonld.mjs vérifie proprement le HTML compilé ou un serveur de développement.
  3. audit-meta.mjs passe sur chaque route modifiée.
  4. redirect-trace.sh, si une redirection a été touchée.

Signalez toute étape que vous n'avez pas pu exécuter, et pourquoi.

Sections de sortie : Modifié (par lot), Vérification, Nécessite une décision produit, Nécessite des données réelles.

Skills associés