Communitygithub.com

Gyschuaner/from-idea-to-personal-site

Utilisez cette compétence lorsque l'utilisateur souhaite créer, implémenter, reconcevoir ou mettre à jour un site web personnel, blog, portfolio, page de recherche ou jardin numérique sans dépendance, en utilisant du HTML, CSS et JavaScript simple. Utilisez-la après avoir choisi une direction thématique, ou lorsque l'utilisateur souhaite un site sans framework, directement ouvrable dans un navigateur et déployable en fichiers statiques.

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

Cette compétence transforme une direction thématique, des informations utilisateur, des échantillons de contenu ou un dossier statique existant en un site web personnel fonctionnel, sans framework ni étape de construction. Elle garantit que le site peut être ouvert directement via un fichier `index.html`, servi en HTTP local ou déployé sur un hébergement statique, en utilisant des chemins relatifs aux pages. Elle est idéale pour les développeurs souhaitant créer un site performant, inspectable et facile à éditer, sans dépendances ni base de données. La compétence génère des fichiers HTML, CSS, JavaScript vanilla et un guide d'édition (`EDITING.md`), en respectant les contraintes de codage UTF-8 et de compatibilité des chemins. Elle ne doit pas être utilisée pour recréer fidèlement un site existant, importer de grandes archives de contenu, ou intégrer des frameworks comme Next.js, Astro, ou des backends.

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

Demander à votre IA préférée

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

Documentation

Créer un site personnel

Objectif

Créer ou reconcevoir un site web personnel sous forme de fichiers statiques simples : HTML, CSS et éventuellement JavaScript vanilla.

Cette compétence est l'étape d'implémentation après avoir choisi une direction visuelle. Elle transforme une recommandation de thème, un profil utilisateur, des notes, des exemples d'articles, des descriptions de projets ou un dossier de site statique existant en un site personnel fonctionnel.

Promesse principale :

  • Aucun framework.
  • Aucune étape de construction.
  • Aucune installation de paquets.
  • Aucune dépendance d'exécution.
  • Ouvrir directement index.html pour un aperçu manuel.
  • Utiliser des liens relatifs aux pages et des ressources pour que l'ouverture directe de fichier, le HTTP local et l'hébergement statique fonctionnent tous.
  • Déployer le dossier sur un hébergement statique.

Pour un contrôle qualité automatisé via navigateur, servez le dossier statique en HTTP local plutôt que d'ouvrir des URL file://.

Contrat

Entrées :

  • Direction thématique, informations de profil utilisateur, besoins en pages, contenu échantillon ou un dossier statique existant.
  • Références facultatives qui doivent guider le style sans exiger une reproduction haute-fidélité.
  • Dossier de sortie souhaité et contraintes statiques.

Sorties :

  • Un dossier de site statique simple avec HTML, CSS, JavaScript vanilla facultatif, ressources locales et types de pages représentatifs.
  • EDITING.md pour les modifications futures lors de la création d'un nouveau site ou d'une refonte majeure.
  • Instructions d'aperçu local et résumé de validation.

Limites :

  • Ne pas recréer fidèlement un site web cible spécifique ; utiliser copy-website-style.
  • Ne pas importer de grandes archives d'écrits ; utiliser add-blog-posts.
  • Ne pas publier ni configurer l'hébergement ; utiliser publish-static-site.
  • Ne pas introduire de frameworks, installations de paquets, backends, CMS, authentification ou bases de données, sauf demande explicite de l'utilisateur.

Condition de succès :

  • Les types de pages requis existent et la navigation pointe vers des chemins relatifs réels.
  • Le site fonctionne comme des fichiers statiques simples, sans étape de construction.
  • La source est lisible en UTF-8, les espaces réservés sont clairs, et review-static-site peut réussir ou ne signaler que des limitations acceptées.

Si la condition échoue :

  • Corrigez les types de pages manquants, les chemins, les ressources, l'encodage, les espaces réservés ou les problèmes de navigateur dans cette compétence.
  • Utilisez personalize-site lorsque l'échec est dû à une identité/contenu utilisateur manquant.
  • Réutilisez review-static-site après les corrections.

Pipeline court

Suivez ce pipeline pour un travail de site personnel original :

  1. Clarifiez l'objectif du site, la direction thématique, le contenu disponible et le périmètre des pages.
  2. Décidez de la carte des pages statiques et de la stratégie des espaces réservés avant de coder.
  3. Construisez d'abord la structure commune : en-tête, navigation, mise en page principale, pied de page, variables CSS globales et interactions partagées.
  4. Implémentez la page d'accueil et chaque type de page demandé ou implicite.
  5. Utilisez le contenu de l'utilisateur ou des espaces réservés clairement remplaçables ; n'inventez pas d'identité personnelle détaillée.
  6. Ajoutez un guide d'édition pour les modifications futures par modèle/utilisateur.
  7. Vérifiez la compatibilité des chemins d'ouverture directe avec des liens relatifs et des ressources.
  8. Validez localement via HTTP dans un navigateur réel.
  9. Vérifiez les liens, les ressources, les types de pages et la lisibilité de la source UTF-8 avant la livraison finale.

Quand l'utiliser

Utilisez cette compétence lorsque l'utilisateur :

  • Souhaite un site personnel, blog, page d'accueil, portfolio, page de recherche ou site web statique simple en HTML/CSS/JS.
  • Demande à implémenter une direction thématique produite par search-blog-theme.
  • Souhaite un site simple sans framework, facile à inspecter, éditer et déployer.
  • Souhaite reconcevoir un site statique existant tout en le gardant sans dépendance.
  • Fournit des références visuelles lâches, mais n'exige pas une reproduction haute-fidélité.

Ne pas l'utiliser quand

N'utilisez pas cette compétence lorsque :

  • L'utilisateur souhaite seulement rechercher des thèmes ou comparer des références visuelles. Utilisez search-blog-theme.
  • L'utilisateur souhaite recréer fidèlement l'apparence, la mise en page, l'animation ou l'interaction d'un site web spécifique. Utilisez copy-website-style.
  • L'utilisateur souhaite migrer de nombreux articles, convertir des notes Obsidian, réparer des frontmatter, ou déplacer de grandes archives de contenu. Utilisez add-blog-posts.
  • L'utilisateur souhaite uniquement de l'aide pour le déploiement, le DNS, GitHub Pages, Cloudflare Pages, Cloudflare Pages Direct Upload, Netlify ou Vercel. Utilisez publish-static-site.
  • L'utilisateur demande explicitement un projet avec framework comme Next.js, Astro, Hugo, Jekyll, Quartz ou React.
  • L'utilisateur demande un backend, une base de données, une authentification, un CMS, un système de commentaires ou un comportement serveur dynamique.

Entrées

Utilisez tout ce que l'utilisateur fournit. Ne bloquez pas si certains détails manquent.

Les entrées utiles incluent :

  • Direction thématique : archive de code privée, tableau de bord de journal de recherche, jardin numérique, portfolio bento, carnet de terrain, système d'exploitation personnel, etc.
  • Profil utilisateur : nom, courte biographie, rôle, localisation, liens sociaux, avatar, CV, publications, projets.
  • Besoins en pages : accueil, à propos, blog, projets, notes, publications, contact.
  • Contenu échantillon : 1 à 3 articles, descriptions de projets, extraits Markdown, pages HTML plus anciennes.
  • Dossier de site existant : fichiers HTML/CSS/JS actuels à conserver ou à refactoriser.
  • Références lâches : v0, Figma, thèmes GitHub, modèles de framework, captures d'écran ou références d'ambiance.

Règle des références

Les références peuvent provenir de n'importe quelle pile. Traitez-les comme des références visuelles et structurelles, non comme des choix d'implémentation, sauf si l'utilisateur demande explicitement d'utiliser ce framework.

Pour un site statique simple, traduisez les références comme suit :

  • Composants React, Next ou Astro -> sections HTML répétées avec classes CSS réutilisables.
  • Classes utilitaires Tailwind -> règles CSS normales dans assets/style.css.
  • Routes de framework -> fichiers .html liés.
  • Collections de contenu ou données CMS -> listes HTML statiques ou petits fichiers JSON.
  • Configuration de thème -> propriétés personnalisées CSS.
  • Interactions simples -> JavaScript vanilla uniquement lorsque c'est utile.

Si l'utilisateur souhaite correspondre fidèlement à un site web spécifique, déléguez à copy-website-style au lieu de le traiter comme une référence lâche.

Structure de site par défaut

Pour un nouveau site, préférez cette structure sauf demande contraire de l'utilisateur :

site/
  index.html
  EDITING.md
  about.html
  blog.html
  projects.html
  posts/
    first-post.html
  assets/
    style.css
    script.js
    images/
  data/
    posts.json
    profile.json

Pour un site existant, conservez la structure actuelle de l'utilisateur lorsque c'est pratique. Ne renommez pas ou ne réorganisez pas de grandes parties du site à moins que cela n'améliore clairement le travail demandé.

Attentes concernant les pages

Créez uniquement les pages nécessaires à la demande de l'utilisateur. Pour un starter de site personnel complet, incluez :

  • Accueil : identité, courte introduction, zone héroïque spécifique au thème, articles récents, projets sélectionnés.
  • À propos : biographie, centres d'intérêt, compétences, contact, liens sociaux, CV/publications facultatif.
  • Index du blog : liste d'articles avec titre, date, tags et résumé.
  • Page d'article : mise en page d'article lisible avec titre, date, tags, contenu et navigation de retour à l'index du blog.
  • Projets : cartes ou lignes de projet avec description, pile technique, liens et résultat.

Rendez le premier écran utile. Ne créez pas une page d'atterrissage marketing lorsque l'utilisateur a demandé un site personnel ou un blog.

Pour un starter de site personnel ou blog complet, ne vous arrêtez pas à une seule page d'accueil. Créez des types de pages représentatifs fonctionnels, même si le contenu n'est que des espaces réservés :

  • Au moins une page d'article/détail pour un blog.
  • Une page de liste ou d'archive lorsque des articles, notes, projets ou publications font partie du site.
  • Une page de profil/à propos lorsque la page d'accueil renvoie à l'identité ou aux détails de fond.
  • Toute page spéciale implicite du concept choisi, comme notes, liens, jardin, now, uses, publications ou expériences.

Pour de grandes collections de contenu futures, créez la structure et quelques entrées d'espace réservé représentatives plutôt que d'inventer une archive complète.

Règle de compatibilité des chemins

Les sites statiques générés doivent fonctionner lorsque l'utilisateur ouvre directement index.html, lorsqu'ils sont servis en HTTP local, et lorsqu'ils sont déployés sur des hébergeurs statiques courants.

Règles par défaut :

  • Utilisez des chemins relatifs aux pages pour tous les liens et ressources locaux au site.
  • Depuis les pages racines, liez CSS/JS/images comme assets/style.css, assets/script.js, assets/images/avatar.png, et les pages comme about.html ou posts/example.html.
  • Depuis les pages imbriquées comme posts/example.html, liez les ressources partagées comme ../assets/style.css et les pages racines comme ../blog.html ou ../index.html.
  • N'utilisez pas de chemins absolus à la racine du site comme /assets/style.css, /assets/script.js, /posts/example.html, /data/posts.json, /images/foo.png, ou / sauf si l'utilisateur accepte explicitement un comportement limité au serveur racine.
  • Appliquez la même règle aux url(...) CSS, favicons, images Open Graph, images de couverture, polices, ressources KaTeX/math, liens RSS/sitemap et URL générées par JavaScript.
  • Lors du déplacement ou de l'ajout d'une page, recalculez les chemins en fonction de la profondeur du dossier de cette page au lieu de copier des liens depuis une page racine.

Évitez les hypothèses limitées au serveur :

  • Ne comptez pas sur fetch("data/posts.json") ou d'autres récupérations de fichiers locaux pour la navigation principale, les listes d'articles ou le contenu de la page d'accueil si l'aperçu par ouverture directe fait partie de la promesse.
  • Si des données répétées sont utiles, soit rendez le contenu essentiel directement en HTML, soit stockez les données dans un objet JavaScript local chargé avec une balise <script src="assets/script.js"> relative.
  • Les améliorations facultatives peuvent utiliser des fichiers de données uniquement lorsque la page reste lisible et navigable sans cette récupération.

Règles de style

Laissez le thème sélectionné guider le langage visuel, mais gardez le site lisible et maintenable.

  • Mettez le style global du site dans assets/style.css.
  • Utilisez des propriétés personnalisées CSS pour les couleurs, les espacements, les bordures et les choix typographiques.
  • Utilisez du HTML sémantique lorsque c'est possible : header, nav, main, article, section, footer.
  • Utilisez des règles de mise en page réactives pour que les pages fonctionnent sur mobile et desktop.
  • Rendez les pages d'articles plus calmes que la page d'accueil si le thème est visuellement intense.
  • Préférez les polices système sauf si l'utilisateur demande une police spécifique ou si le thème en nécessite fortement une.
  • Ne comptez pas sur des ressources distantes sauf si l'utilisateur les fournit ou si elles sont clairement acceptables.
  • Ne laissez pas les effets décoratifs gêner la lecture, la navigation ou l'accessibilité.

Règles d'interaction

Utilisez du JavaScript vanilla uniquement lorsqu'il apporte une valeur claire.

Bons usages :

  • Bouton de bascule de navigation mobile.
  • Bouton de bascule de thème.
  • Filtrage léger par tag ou article.
  • Petits effets progressifs qui n'affectent pas la lecture principale.

À éviter :

  • Frameworks d'animation lourds.
  • Décoration lourde basée sur Canvas sauf demande explicite de l'utilisateur.
  • Effets nécessitant un serveur de développement ou une installation de paquets.
  • Scintillement continu, effets de glitch agressifs ou effets de défilement qui nuisent à la lecture.

Respectez prefers-reduced-motion pour les thèmes animés.

Règle de simplification statique

Lorsqu'une référence lâche comporte des fonctionnalités complexes ou dépendantes d'un framework, traduisez-les en équivalents statiques plus simples :

  • Globe 3D -> carte thématique, panneau de statut, constellation de projets ou bloc visuel statique.
  • Grille bento animée -> grille CSS réactive avec effets de survol subtils.
  • Simulateur de terminal -> navigation thématique et contenu de style journal, pas une fausse ligne de commande sauf si utile.
  • Graphe de connaissances -> tags, articles connexes, index thématique ou liens organisés manuellement.
  • Recherche dynamique -> entrée de filtre simple, pages de tags statiques ou pas de recherche pour la première version.
  • Articles pilotés par CMS -> posts/*.html plus data/posts.json.

Préférez une version statique propre qui capture le ressenti souhaité par l'utilisateur plutôt qu'une copie surdimensionnée de la référence.

Règle pour site existant

Lors de la modification d'un site existant :

  • Inspectez la structure de fichiers actuelle avant d'éditer.
  • Préservez le contenu utilisateur et les fichiers non liés.
  • Limitez les modifications aux pages et ressources demandées.
  • Réutilisez les conventions visuelles existantes lorsqu'elles fonctionnent déjà.
  • Évitez de remplacer l'intégralité du site sauf si l'utilisateur demande une refonte complète.
  • Si le site possède déjà style.css ou script.js, étendez-les soigneusement plutôt que de créer des doublons conflictuels.

Règle de contenu

Pour de petites quantités de contenu, écrivez du HTML statique directement.

Pour du contenu répété comme des articles ou des projets, utilisez :

  • Du HTML statique répété lorsque la liste est courte.
  • Un objet de données JavaScript local plus un rendu JavaScript vanilla lorsque cela améliore la maintenabilité.
  • Un petit fichier JSON uniquement lorsque le site est autorisé à nécessiter du HTTP local/hébergement statique pour cette fonctionnalité, et que la page principale fonctionne toujours sans cela.

N'inventez pas de faits personnels détaillés. Utilisez des espaces réservés clairement lorsque les données utilisateur manquent.

Gardez les espaces réservés faciles à trouver et à remplacer. Préférez stocker le contenu répété dans un endroit clairement nommé comme data/*.json, un bloc de données documenté dans assets/script.js, ou une section HTML répétée avec des noms de classe stables.

Marquez clairement le texte d'espace réservé, les articles de démonstration, les exemples de projets et les liens factices dans les fichiers ou EDITING.md afin que l'utilisateur ou un modèle futur puisse les remplacer avant publication.

Règle du guide d'édition

Lors de la création d'un nouveau site ou d'une refonte matérielle d'un site existant, incluez EDITING.md dans le dossier de sortie.

EDITING.md est principalement destiné à un modèle ou agent futur qui modifiera le site généré plus tard. Restez concis mais concret. Expliquez :

  • Hiérarchie des dossiers et à quoi chaque fichier/dossier sert.
  • Formats de fichiers utilisés par le site : HTML, CSS, JS, JSON/blocs de données et images.
  • Carte des pages : quel fichier généré est l'accueil, à propos/profil, blog/liste, article/détail, projets, notes, liens ou autres types de pages.
  • Régions de mise en page partagée : en-tête, navigation, navigation mobile, contenu principal, pied de page, barres latérales, superpositions ou contrôles de thème.
  • Où se trouve chaque région majeure de la page d'accueil dans index.html, en utilisant les noms de section/classe à proximité.
  • Où se trouve chaque modèle de sous-page et comment les liens internes y connectent.
  • Où le contenu répété est stocké et son format d'objet/balisage attendu.
  • Comment modifier le titre du site, le slogan, l'avatar/logo, la navigation, les articles en vedette, les listes de projets, les listes de liens, les images, les couleurs et les variables de thème.
  • Quel contenu est uniquement un espace réservé et doit être remplacé avant publication.

Règle d'intégrité de l'encodage

Les fichiers source générés doivent être en UTF-8 valide et lisibles par un humain dans leur forme source, pas seulement corrects visuellement dans des captures d'écran de navigateur.

Pour les pages ou guides d'édition contenant du texte chinois, japonais, coréen, latin accentué ou autre contenu non ASCII :

  • Incluez <meta charset="utf-8"> dans les fichiers HTML.
  • Écrivez les fichiers en UTF-8.
  • Vérifiez la lisibilité de la source avec un lecteur compatible UTF-8 avant la livraison finale.

...

[abrégé pour la traduction]

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 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

Publish, deploy, or prepare a finished static personal website, blog, portfolio, or style recreation for hosting on GitHub Pages, Cloudflare Pages, Netlify, or Vercel. Use when the user asks to publish a static site, configure deployment settings, add GitHub Pages workflows, choose a static hosting platform, prepare a repo for Pages/Cloudflare/Netlify/Vercel, verify a deployed URL, or explain how to deploy a site folder such as site/, dist/, out/, public/, or docs/.

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