Communitygithub.com

zijieguo2003/blog-builder-skill

Guide pour la création rapide d'un blog personnel à partir de zéro. Couvre le choix du framework (Hugo, Hexo, Astro, Next.js), la configuration du thème, la génération de modèles d'articles avec Frontmatter, le déploiement vers GitHub Pages / Vercel / Cloudflare Pages, et la configuration SEO complète (sitemap, robots.txt, Open Graph, URL canoniques).

Qu'est-ce que blog-builder-skill ?

Ce skill permet à un assistant IA (comme Claude Code, Cursor, Codex, etc.) d'accompagner un utilisateur dans la création complète d'un blog personnel, depuis le choix du framework jusqu'au déploiement et à l'optimisation SEO. Il est déclenché dès que l'utilisateur évoque la mise en place d'un blog, d'un site statique, d'un portfolio, ou qu'il s'interroge sur Hugo, Hexo, Astro, Next.js ou le déploiement. Le skill suit un workflow en six étapes : comprendre le contexte technique de l'utilisateur, recommander un framework adapté (Hugo pour les non-techniciens, Astro pour les développeurs JS, etc.), configurer le framework choisi via des fichiers de référence dédiés, générer un modèle d'article prérempli avec Frontmatter, déployer le site sur GitHub Pages, Vercel ou Cloudflare Pages à l'aide de workflows CI/CD prêts à l'emploi, et enfin configurer le SEO (sitemap, robots.txt, balises Open Graph, URL canoniques). Le skill insiste sur la livraison de contenu concret (code, YAML, TOML) prêt à être copié-collé, en évitant les explications trop vagues.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add zijieguo2003/blog-builder-skill

Demander à votre IA préférée

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

Documentation

Blog Builder

Aidez l'utilisateur à lancer un blog personnel — du choix d'un framework jusqu'au déploiement en ligne avec un SEO correct. Périmètre complet : choix du framework → thème → modèle d'article → déploiement → SEO.

Workflow

Étape 1 — Comprendre le contexte de l'utilisateur

Demandez (ou déduisez du contexte) :

  • Niveau technique ? (non-technique / développeur JS / développeur Python / etc.)
  • Départ de zéro ou site existant ?
  • Cible de déploiement préférée : GitHub Pages, Vercel, Cloudflare Pages ?
  • Contenu : écriture, portfolio, blog tutoriel, documentation ?

Étape 2 — Recommander un framework

SituationRecommandation
Non technique, veut juste écrireHugo — zéro JS, rapide, énorme bibliothèque de thèmes
Développe déjà en JS/TS, veut du contrôle sur les composantsAstro — architecture en îles, excellente expérience développeur
Aime les écosystèmes de thèmes, à l'aise avec NodeHexo — écosystème de plugins mature
Développeur React, veut un contrôle totalNext.js — App Router + MDX

Présentez la recommandation avec une courte justification. Confirmez avant de passer à la suite.

Étape 3 — Configuration du framework

Lisez le fichier de référence correspondant et guidez l'utilisateur dans l'installation + un thème de démarrage :

FrameworkFichier de référence
Hugoreferences/hugo.md
Hexoreferences/hexo.md
Astroreferences/astro.md
Next.jsreferences/nextjs.md

Étape 4 — Générer un modèle d'article

Produisez un fichier modèle d'article prêt à l'emploi avec un Frontmatter complet. Les modèles d'actifs dans assets/post-templates/ sont des points de départ — copiez et adaptez au thème choisi et aux préférences de l'utilisateur.

Étape 5 — Déploiement

Lisez references/deployment.md pour le workflow CI/CD approprié. Fournissez le YAML complet d'Action GitHub, prêt à être commité.

Points clés :

  • GitHub Pages : push vers .github/workflows/deploy.yml ; activez Pages dans les paramètres du dépôt
  • Vercel : connectez le dépôt dans le tableau de bord ; définissez le preset de framework et le dossier de sortie
  • Cloudflare Pages : la commande de build = npm run build, le dossier de sortie = dist (Astro/Hexo/Next.js) ou public (Hugo)

Étape 6 — Configuration SEO

Chaque blog a besoin :

  1. sitemap.xml — spécifique au framework ; voir references/.md
  2. robots.txt — fournissez le contenu du fichier réel, pas seulement une description
  3. Balises Open Graph — og:title, og:description, og:image, og:url comme balisage réel
  4. URL canoniques — définissez baseURL / site dans la configuration pour que les sitemaps et les balises OG fonctionnent correctement

Rappelez toujours : l'URL du site doit être définie dans la configuration du framework pour que le sitemap génère des URL absolues correctes.

Principes directeurs

  • Fournissez le contenu réel des fichiers (code, YAML, TOML), pas seulement des descriptions
  • Incluez uniquement les champs qui comptent — évitez les modèles trop longs
  • Signalez un ou deux pièges qui surprennent souvent les débutants (par exemple, baseURL de Hugo, champ site d'Astro)
  • Privilégiez les exemples prêts pour le copier-coller

Skills associés