Communitygithub.com

Gyschuaner/from-idea-to-personal-site

Publier, déployer ou préparer un site web statique personnel, blog, portfolio ou recréation de style pour hébergement sur GitHub Pages, Cloudflare Pages, Netlify ou Vercel.

Qu'est-ce que from-idea-to-personal-site ?

Cette compétence est conçue pour les développeurs et créateurs qui souhaitent déployer rapidement et simplement un site web statique (HTML/CSS/JS) sur des plateformes d'hébergement populaires (GitHub Pages, Cloudflare Pages, Netlify, Vercel). Elle prend en charge les dossiers de sortie statiques courants comme `site/`, `dist/`, `out/`, `public/` ou `docs/`. L'outil guide l'utilisateur dans le choix de la plateforme la plus adaptée (avec une préférence par défaut pour l'intégration Git de Cloudflare Pages), prépare les fichiers de configuration nécessaires (workflows GitHub Actions, `netlify.toml`, `vercel.json`, etc.), et peut effectuer le déploiement si l'utilisateur l'autorise. Il effectue également une vérification post-déploiement en ouvrant l'URL dans un navigateur pour confirmer que le site s'affiche correctement (page d'accueil, CSS, JS, images, navigation). Des garde-fous sont inclus pour éviter de publier des données sensibles, des chemins cassés ou des fichiers inappropriés. La compétence prend en charge plusieurs modes : simple guide, préparation du dépôt, déploiement direct, ou vérification d'une URL déjà en ligne.

Compatible avec~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Gyschuaner/from-idea-to-personal-site/tree/HEAD/.agents/skills/publish-static-site

Demander à votre IA préférée

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

Documentation

Publier un site statique

Objectif

Publier ou préparer le déploiement d'un site web statique terminé.

Cette compétence est destinée aux sorties HTML/CSS/JS déployables comme site/, dist/, out/, public/ ou docs/. Elle peut également publier des projets framework après qu'ils aient produit un dossier de sortie statique, mais ne doit pas transformer un site statique simple en projet framework uniquement pour le déployer.

Position par défaut :

  • Préférer un hébergement statique simple plutôt qu'un déploiement spécifique à un framework.
  • Préférer un déploiement basé sur Git pour les sites que l'utilisateur continuera à modifier.
  • Préférer un téléversement direct uniquement pour une publication rapide unique.
  • Ne pas créer de dépôts distants, pousser du code, modifier le DNS, ajouter des domaines ou déployer vers un compte payant sauf si l'utilisateur le demande explicitement.

Contrat

Entrées :

  • Racine de déploiement statique telle que site/, dist/, out/, public/, docs/ ou racine du dépôt.
  • Plateforme ou cible préférée : GitHub Pages, Cloudflare Pages, Netlify, Vercel, domaine personnalisé, simple conseil ou déploiement en direct.
  • État Git/dépôt actuel, accès au compte de la plateforme, connexion CLI/navigateur et contraintes de déploiement.

Sorties :

  • Paramètres de déploiement concrets : plateforme, branche, commande de build, répertoire de base, répertoire de publication/sortie et fichiers de configuration si nécessaire.
  • Configuration facultative spécifique à la plateforme : workflow GitHub Pages, netlify.toml, vercel.json, .nojekyll ou CNAME.
  • URL en direct et vérification post-déploiement lorsque le déploiement est effectué.
  • Étapes manuelles du tableau de bord lorsque les identifiants ou l'accès au compte ne sont pas disponibles.

Limites :

  • Ne pas construire ou reconcevoir le site ; rediriger les défauts vers la compétence enfant appropriée.
  • Ne pas pousser, créer de dépôts/projets, téléverser, lier des domaines, modifier le DNS ou utiliser des ressources payantes sauf autorisation explicite.
  • Ne pas utiliser le déploiement comme solution de contournement pour des problèmes de compatibilité de chemins locaux/statiques sauf si l'utilisateur accepte explicitement un comportement limité à la racine du serveur.

Condition de succès :

  • review-static-site a réussi ou les risques non résolus sont explicites.
  • La racine de déploiement contient index.html et la plateforme publiera le dossier correct.
  • L'URL en ligne charge la page d'accueil, les ressources, la navigation et les sous-pages représentatives après le déploiement.

Si la condition échoue :

  • Corriger les problèmes de chemin, de ressource, d'encodage ou de type de page avant le déploiement.
  • Rediriger les problèmes de contenu/conception/importation vers personalize-site, edit-site-part, add-blog-posts, make-personal-site ou copy-website-style.
  • Réexécuter review-static-site puis réessayer ou mettre à jour les paramètres de déploiement.

Références

Charger uniquement la référence nécessaire pour la plateforme ou le problème choisi :

  • Stratégie de chemin et compatibilité d'ouverture directe : references/path-strategy.md.
  • Intégration Git Cloudflare Pages et téléversement direct : references/cloudflare-pages.md.
  • Source de branche GitHub Pages et workflows Actions : references/github-pages.md.
  • Tableau de bord Netlify et netlify.toml : references/netlify.md.
  • Tableau de bord Vercel et vercel.json : references/vercel.md.

Documentation officielle :

Modes de déploiement

Déterminer d'abord ce que l'utilisateur souhaite réellement :

  • Simple conseil : expliquer le choix de la plateforme et les paramètres exacts. Ne pas modifier les fichiers sauf si utile.
  • Préparer le dépôt : ajouter les fichiers de configuration nécessaires et indiquer à l'utilisateur sur quoi cliquer dans le tableau de bord d'hébergement.
  • Déployer maintenant : effectuer des actions distantes uniquement si l'utilisateur l'a explicitement demandé et que le CLI/auth/session requis existe.
  • Vérifier l'URL en direct : ouvrir l'URL déployée dans un navigateur et la comparer au site local.

Si les identifiants, l'accès au compte, la connexion au navigateur ou l'authentification CLI sont manquants, fournir les étapes exactes du tableau de bord au lieu d'inventer une solution de contournement.

Flux de travail

  1. Identifier le dossier de sortie statique et la plateforme préférée de l'utilisateur, le cas échéant.
  2. Appeler ou suggérer d'utiliser review-static-site avant la publication.
  3. Confirmer que la racine de déploiement contient index.html.
  4. Inspecter les chemins des ressources et convertir les chemins locaux accidentellement absolus à la racine avant la publication. Charger references/path-strategy.md lorsque le comportement des chemins n'est pas clair.
  5. Choisir la plateforme et le mode de déploiement les plus simples correspondants.
  6. Charger la référence de la plateforme choisie et ajouter uniquement les fichiers de configuration requis par cette plateforme.
  7. Si le déploiement se fait via Git, vérifier l'état Git et éviter d'inclure des fichiers non liés ou privés.
  8. Si l'utilisateur a autorisé les actions distantes, pousser ou déployer exactement ce qui a été convenu.
  9. Après la publication, ouvrir l'URL en direct et vérifier le site déployé dans un navigateur.

Liste de vérification pré-vol

Effectuer ces vérifications avant d'écrire des configurations de déploiement ou de communiquer des paramètres à l'utilisateur :

  • Racine de déploiement : choisir le dossier qui contient directement index.html.
  • Page d'entrée : index.html doit exister au niveau supérieur de la racine de déploiement.
  • Aperçu en ouverture directe : l'index.html racine doit conserver CSS, JS, images et navigation lorsqu'il est ouvert directement depuis le système de fichiers, sauf si l'utilisateur a explicitement accepté un comportement serveur uniquement.
  • HTTP local : servir la racine de déploiement avec python -m http.server et confirmer qu'elle fonctionne via http://127.0.0.1:<port>/.
  • Audit statique : exécuter ou recommander review-static-site pour les liens, la lisibilité UTF-8, les résidus de placeholders, le rendu navigateur, les résidus de confidentialité et la disposition mobile.
  • Chemins des ressources : inspecter href, src, srcset, CSS url(...), polices, favicons, images de couverture, RSS, sitemap et liens de manifeste.
  • Données privées : s'assurer que les tokens, les chemins du système de fichiers local, les notes de brouillon, les identités du site source et les secrets personnels ne sont pas publiés.
  • Complétude de la sortie : confirmer que les sous-pages, articles, images, polices fournisseurs, ressources KaTeX/mathématiques et médias copiés se trouvent dans la racine de déploiement.

Traiter ces éléments comme des bloqueurs :

  • Absence d'index.html dans la racine de déploiement.
  • Chemins de ressources CSS, JS, image, police, RSS, sitemap ou fournisseur locaux cassés.
  • Les fichiers source contiennent du mojibake ou un encodage illisible.
  • Le site personnel généré contient encore l'identité de la source copiée qui aurait dû être remplacée.
  • Des chemins locaux accidentellement absolus à la racine tels que /assets/..., /posts/..., /data/... ou /images/... subsistent dans un site statique simple généré.
  • Le site fonctionne uniquement via HTTP local parce que les chemins absolus à la racine sont servis depuis 127.0.0.1, mais l'ouverture directe du fichier ou le déploiement sur un sous-chemin perdrait CSS/JS/images.
  • Des fichiers sensibles à la vie privée ou des secrets seraient déployés.
  • La plateforme déploierait le mauvais dossier.

Choix de la plateforme

Utiliser ce classement par défaut pour les sites personnels statiques simples :

  1. Intégration Git Cloudflare Pages : meilleure valeur par défaut pour un dossier site/ généré et les mises à jour futures.
  2. GitHub Pages avec GitHub Actions : meilleur lorsque l'utilisateur souhaite tout garder dans GitHub.
  3. Netlify : hébergement statique simple avec des aperçus conviviaux et des paramètres de tableau de bord.
  4. Vercel : bon lorsque l'utilisateur utilise déjà Vercel ou pourrait plus tard passer à Next.js, mais pas la valeur par défaut pour du HTML simple.

Règles de décision :

  • Si l'utilisateur souhaite le moins de friction et a un dépôt GitHub : intégration Git Cloudflare Pages. Charger references/cloudflare-pages.md.
  • Si l'utilisateur souhaite un hébergement uniquement GitHub : GitHub Pages. Charger references/github-pages.md.
  • Si les fichiers de déploiement se trouvent dans la racine du dépôt ou dans /docs : la source de branche GitHub Pages est acceptable.
  • Si les fichiers de déploiement se trouvent dans site/, dist/, out/ ou un autre dossier personnalisé : préférer GitHub Actions pour GitHub Pages.
  • Si l'utilisateur souhaite un téléversement manuel aujourd'hui : téléversement direct Cloudflare ou déploiement manuel Netlify.
  • Si l'utilisateur a déjà un compte/projet Vercel : utiliser Vercel avec des paramètres explicites de répertoire de sortie.

Sortie statique du framework

Si le site n'est pas en HTML/CSS/JS simple :

  • Inspecter package.json, la configuration du framework et les scripts existants.
  • Utiliser la commande de build existante du projet ; ne pas inventer de workflows npm.
  • Publier le dossier de sortie statique final, pas le dossier source.
  • Les sorties courantes incluent dist, out, build, .output/public et public, selon le framework.
  • Pour l'export statique Next.js, vérifier que le projet est effectivement configuré pour l'export statique avant de traiter out/ comme sortie finale.
  • Pour les projets Vue/Vite/Astro, publier le répertoire de sortie configuré après un build réussi.

Si l'utilisateur a demandé une publication statique simple et qu'aucun fichier framework n'existe, ne pas introduire npm.

Politique des fichiers de configuration

Ajouter uniquement les fichiers de configuration correspondant à la plateforme choisie :

  • Actions GitHub Pages : .github/workflows/pages.yml.
  • Domaine personnalisé GitHub Pages : CNAME dans la racine déployée, uniquement lorsque l'utilisateur a fourni le domaine.
  • Contournement Jekyll GitHub Pages : .nojekyll dans la racine déployée si utile.
  • Netlify : netlify.toml uniquement lorsque les paramètres du tableau de bord ne suffisent pas ou que l'utilisateur souhaite une configuration dans Git.
  • Vercel : vercel.json uniquement lorsque Vercel a besoin de paramètres de sortie explicites.
  • Cloudflare Pages : généralement, les paramètres du tableau de bord suffisent pour les sites statiques simples.

Ne pas ajouter de configurations de déploiement pour chaque plateforme à la fois.

Sécurité Git et distante

Avant toute action distante, indiquer ce qui va se passer et confirmer que l'utilisateur l'a demandé :

  • Création d'un dépôt GitHub.
  • Ajout d'un remote.
  • Indexation ou validation de fichiers.
  • Poussée de commits vers une branche distante.
  • Activation de GitHub Pages.
  • Création de projets Cloudflare, Netlify ou Vercel.
  • Téléversement de fichiers vers un fournisseur d'hébergement.
  • Ajout de variables d'environnement.
  • Ajout de domaines personnalisés ou modification des enregistrements DNS.

Avant d'indexer ou de pousser :

  • Exécuter git status --short.
  • Identifier les fichiers de site générés par rapport aux modifications utilisateur non liées.
  • Ne pas indexer les modifications non liées.
  • Ne pas publier de notes privées, identifiants, chemins locaux, captures d'écran avec secrets ou fichiers temporaires.

Ne jamais placer de secrets, tokens, notes privées ou chemins du système de fichiers locaux dans le site statique ou la configuration de déploiement.

Vérification post-déploiement

Après que la plateforme a signalé une URL en direct :

  • Ouvrir l'URL déployée avec un outil navigateur interactif réellement disponible. « Disponible » signifie qu'il est exposé dans la liste des outils appelables du tour actuel. Dans Codex, cela peut être le plugin Navigateur/navigateur intégré à l'application lorsqu'il est acheminé dans le tour.
  • Vérifier que la page d'accueil n'est pas une erreur 404, une page blanche ou un listing de répertoire.
  • Vérifier que CSS, JavaScript, images, polices, favicon, RSS, sitemap et ressources fournisseurs se chargent depuis le domaine déployé.
  • Cliquer sur la navigation principale et au moins une sous-page représentative par type de page.
  • Tester les largeurs bureau et mobile.
  • Vérifier la console du navigateur pour les ressources manquantes ou les erreurs JavaScript.
  • Confirmer les métadonnées, le titre, la description, l'image Open Graph, l'URL canonique, RSS, sitemap et les fichiers robots lorsqu'ils sont présents.
  • Si vous utilisez GitHub Project Pages, vérifier spécifiquement les sous-pages et les URL des ressources sous le sous-chemin du dépôt.
  • Si vous utilisez un domaine personnalisé, vérifier HTTPS et les redirections entre le domaine nu et www si configuré.

Si aucun outil navigateur interactif n'est appelable, ne pas prétendre qu'une vérification navigateur en direct a eu lieu. Demander à l'utilisateur d'activer ou d'invoquer l'outil navigateur si la vérification visuelle en direct est importante ; pour Codex, cela peut signifier envoyer une requête qui mentionne explicitement @browser. Si l'utilisateur ne redirige pas ou si le client ne dispose pas d'un tel outil, revenir à Playwright, aux captures d'écran, aux vérifications HTTP ou aux vérifications statiques et préciser la limitation.

Ne pas utiliser par défaut Playwright ou des vérifications en direct par captures d'écran uniquement lorsqu'un outil navigateur interactif est réellement appelable. Utiliser Playwright uniquement comme solution de repli, ou lorsque l'utilisateur demande explicitement des vérifications de déploiement scriptées.

Si le site déployé diffère de l'aperçu local, inspecter le journal de déploiement, le répertoire de sortie et la stratégie de chemin des ressources avant de modifier le code de conception.

Sortie

Garder le rapport final destiné à l'utilisateur concis :

  • Plateforme choisie et pourquoi.
  • Dossier statique publié ou préparé.
  • Mode de déploiement : conseil, configuration préparée, intégration Git, téléversement direct ou déploiement en direct.
  • Paramètres utilisés : branche, commande de build, répertoire de base, répertoire de publication/sortie.
  • Fichiers de configuration modifiés, le cas échéant.
  • URL du guide officiel pour la plateforme choisie.
  • URL en direct, si le déploiement a eu lieu.
  • Vérification effectuée et toute étape manuelle restante.

Si seul un conseil a été demandé, ne pas prétendre que le site a été déployé. Donner des paramètres de plateforme concrets et des liens vers les guides officiels.

Individual skills in this repo

This repo contains 10 individual skills — each has its own dedicated page.

Gyschuaner/from-idea-to-personal-site

Use this skill to add, import, or migrate one or more blog posts, notes, essays, articles, Markdown files, Word documents, or rich-content writing folders into an existing static personal website or blog while preserving the site's current article style, content structure, navigation, indexes, archives, tags, assets, math, links, tables, code blocks, embeds, and homepage entry points. Use it for pasted posts, local Markdown files, Obsidian notes, .docx drafts, old static HTML posts, exported blog content, or small-to-medium batches of posts after a site has already been created.

Gyschuaner/from-idea-to-personal-site

Route and coordinate the personal website skill suite for creating, recreating, personalizing, adding content to, validating, editing, or preparing a static personal website or blog. Use when the agent needs to choose between theme search, style reference research, original build, website style recreation, personalization, post import, review, local edits, or publishing preparation, or when the user asks what step comes next in an existing site-building workflow.

Gyschuaner/from-idea-to-personal-site

Use this skill when the user wants to recreate, copy, clone, remix, or closely match the look, layout, motion, or interaction feel of a specific website, URL, screenshot, or template using plain HTML, CSS, and JavaScript. Use it to inspect public source as research, rewrite original code, avoid direct reuse of protected assets, and validate the result in a browser.

Gyschuaner/from-idea-to-personal-site

Use this skill to make focused, small-scope edits to a generated static website, personal blog, portfolio, digital garden, or style recreation. Use it when the user wants to adjust one page section, component, visual detail, copy block, responsive issue, or lightweight interaction without rebuilding the whole site. Typical requests include changing a hero block, card layout, sidebar, footer, button, mobile menu, spacing, color, typography, animation intensity, or a small piece of page copy.

Gyschuaner/from-idea-to-personal-site

Use this skill after a personal website or blog style direction is roughly known and before building an original site. It searches for real websites, templates, portfolios, blogs, screenshots, or design examples that match the chosen direction, inspects them with browser or screenshot tools when available, and turns the findings into a practical design reference brief for make-personal-site. Use it for requests like finding references for a natural technical blog, cozy research homepage, brutalist portfolio, digital garden, minimal notes site, or any named visual direction that still needs concrete examples.

Gyschuaner/from-idea-to-personal-site

Run the complete idea-to-personal-website or blog workflow. Use when the user wants a one-click or end-to-end pipeline from a vague idea, reference URL, template, personal materials, style direction, or writing drafts to concrete style references, a validated static personal site, and optionally a live deployment on GitHub Pages, Cloudflare Pages, Netlify, or Vercel.

Gyschuaner/from-idea-to-personal-site

Use this skill when the user wants to create, implement, redesign, or update a zero-dependency personal website, personal blog, homepage, portfolio, research homepage, or digital garden using plain HTML, CSS, and JavaScript. Use it after a theme direction has been chosen, or when the user wants a no-framework site that can be opened directly in the browser and deployed as static files.

Gyschuaner/from-idea-to-personal-site

Use this skill to turn a generated static personal website, blog, portfolio, digital garden, or style recreation into the user's own site by replacing placeholder identity, profile copy, links, projects, featured items, contact details, metadata, and demo page content. Use it after make-personal-site or copy-website-style, or when a user provides an existing static site folder and personal materials such as a bio, resume, README, GitHub profile, old homepage, Markdown notes, or social links.

Gyschuaner/from-idea-to-personal-site

Use this skill to inspect, validate, QA, or sanity-check a generated static website, personal blog, portfolio, digital garden, or style recreation before handoff or publishing. Use it for local folders such as site/, dist/, out/, or public/ to check broken links, missing page types, browser rendering, console errors, desktop/mobile screenshots, UTF-8 source readability, mojibake, relative asset paths, direct-open/file compatibility, placeholder content, and leftover copied source-specific text.

Gyschuaner/from-idea-to-personal-site

Use this skill when the user wants to find, compare, choose, or adapt a visual theme for a personal blog, personal homepage, portfolio, research homepage, digital garden, or static website. Use it to turn references from v0, Figma, GitHub themes, existing websites, screenshots, keywords, or natural-language taste preferences into natural, practical theme recommendations.

Skills associés