Communitygithub.com

Gyschuaner/from-idea-to-personal-site

Utilisez cette compétence pour effectuer des modifications ciblées et limitées sur un site web statique généré : blog personnel, portfolio, jardin numérique ou recréation de style. Idéale pour ajuster une section, un composant, un détail visuel, un bloc de texte, un problème responsive ou une interaction légère sans reconstruire l'ensemble du site.

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

Cette compétence est conçue pour les agents d'IA (comme Claude Code, Cursor, Codex, etc.) spécialisés dans l'édition de sites web statiques. Elle permet de réaliser des modifications circonscrites et précises sur une partie spécifique d'un site existant, qu'il s'agisse d'un blog, d'un portfolio, d'un jardin numérique ou d'une recréation de style. L'agent reçoit en entrée le dossier du site, la page cible, une capture d'écran ou une description en langage naturel, et il doit effectuer le changement le plus petit et cohérent possible tout en préservant le reste du site. La compétence définit un contrat strict : elle ne doit pas reconstruire le site entier, changer la direction du thème, importer des articles ou publier. Elle valide le résultat via un navigateur interactif (ou Playwright en dernier recours) et met à jour le fichier `EDITING.md` uniquement si les instructions d'édition futures doivent changer. La compétence garantit que l'édition reste locale, ne touche pas aux pages non liées et préserve les conventions existantes (chemins relatifs, design language, etc.).

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

Demander à votre IA préférée

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

Documentation

Modifier une partie du site

Objectif

Apporter une amélioration ciblée à une partie d'un site statique existant tout en préservant le reste du site.

Cette compétence est destinée au polissage itératif après que le site existe déjà. Elle doit ressentir une édition locale minutieuse, et non une nouvelle passe de génération.

Contrat

Entrées :

  • Dossier du site statique existant, page cible, capture d'écran/URL locale, ou description en langage naturel de la zone cible.
  • EDITING.md et fichiers HTML/CSS/JS pertinents.
  • Changement souhaité (texte, style, comportement responsive ou petite interaction).

Sorties :

  • Une modification ciblée de la section, du composant, du bloc de texte, de la règle de style ou de l'interaction concernée.
  • EDITING.md mis à jour uniquement lorsque les instructions d'édition futures doivent changer.
  • Bref rapport indiquant où la modification a été effectuée, les fichiers modifiés et la validation réalisée.

Limites :

  • Ne pas reconstruire l'ensemble du site, changer la direction du thème, importer des articles, personnaliser plusieurs champs ou publier.
  • Ne pas toucher aux pages/ressources non liées.
  • Ne pas introduire de dépendances, d'étapes de construction ou de chemins racine-absolus locaux au site.

Critère de succès :

  • Le changement local demandé est visible dans la même région du navigateur qui a été confirmée avant l'édition.
  • Les vérifications desktop/mobile ou d'interaction réussissent pour la surface concernée.
  • Aucun changement de mise en page ou de navigation non lié n'a été introduit.

En cas d'échec :

  • Remapper la région du navigateur vers la source et effectuer la plus petite correction corrective.
  • Exécuter ou suggérer review-static-site lorsque le problème affecte la navigation partagée, de nombreuses pages, les ressources, l'encodage ou l'état de publication.

Quand utiliser

Utilisez cette compétence lorsque l'utilisateur demande de :

  • Modifier une section, une carte, un bloc, un composant ou une région de page.
  • Rendre un détail visuel plus petit, plus calme, plus dense, plus propre, plus ludique, plus technique ou moins distrayant.
  • Corriger un problème de mise en page mobile, un débordement de texte, un problème d'espacement ou un alignement maladroit.
  • Ajuster une petite interaction comme un survol, un bouton de thème, un comportement de menu, un bouton de copie, un filtre, un onglet ou une animation.
  • Réécrire ou raccourcir un morceau spécifique de texte visible.
  • Faire correspondre une capture d'écran ou un commentaire d'utilisateur pour une zone localisée.

N'utilisez pas cette compétence pour la génération complète du site, la recherche de thème, la recréation proche d'un nouveau site de référence, le remplacement de contenu personnel important, la migration d'articles, le déploiement ou la conversion de framework.

Entrées

Utilisez ce que l'utilisateur fournit :

  • Dossier racine du site et page cible.
  • Une capture d'écran, une vue navigateur, une URL locale ou une description en langage naturel du problème.
  • Le texte exact, le nom de section, le nom de classe ou la zone visuelle à modifier.
  • EDITING.md, s'il est présent.
  • Les fichiers HTML/CSS/JS existants.
  • Toute direction de texte avant/après ou de style souhaitée.

Si la zone cible est ambiguë, inspectez le site et faites l'interprétation la plus petite et raisonnable. Ne posez une courte question de clarification que lorsque plusieurs modifications plausibles produiraient des résultats très différents.

Flux de travail

  1. Avant l'édition, utilisez le navigateur pour confirmer la page cible et la région cible.
  2. Lisez EDITING.md s'il est présent, puis inspectez les fichiers HTML/CSS/JS pertinents.
  3. Utilisez la recherche pour trouver le texte visible correspondant, les ID, les classes, les blocs de données ou le balisage de type composant.
  4. Mappez la région de navigateur confirmée aux fichiers source, sélecteurs, blocs de données ou gestionnaires d'événements pertinents.
  5. Effectuez la plus petite modification cohérente qui satisfait la demande.
  6. Conservez le langage de design existant, sauf si l'utilisateur demande explicitement de le modifier.
  7. Après l'édition, revenez à la même page et région dans le navigateur et vérifiez le changement.
  8. Rapportez ce qui a changé et mentionnez toute validation de suivi nécessaire.

Contrôle de portée

Gardez l'édition locale.

  • Préférez modifier la section, la classe ou l'objet de données existant plutôt que de créer un doublon parallèle.
  • Évitez de réécrire la page entière lorsqu'un changement au niveau de la section suffit.
  • Évitez de modifier les variables CSS partagées, sauf si l'utilisateur souhaite un changement de style à l'échelle du site.
  • Évitez de toucher aux pages, ressources ou contenu non liés.
  • Préservez la navigation, le plan de page, la stratégie d'espace réservé et les conventions EDITING.md.
  • Préservez la stratégie de chemins du site ; n'introduisez pas de chemins locaux racine-absolus tels que /assets/..., /posts/..., /images/... ou /data/... lors d'une édition locale.
  • Si une petite demande révèle un problème structurel plus large, expliquez le compromis avant d'apporter des changements étendus.

Lorsque l'utilisateur demande un changement visuel large sur plusieurs pages, suggérez d'utiliser une compétence de génération plus large ou de refonte plutôt que d'étirer celle-ci.

Localiser le bon endroit

Utilisez une recherche en couches :

  1. Recherchez le texte visible ou les étiquettes proches.
  2. Recherchez dans EDITING.md le plan de section/page.
  3. Inspectez les liens de navigation et les noms de fichiers de page.
  4. Inspectez les balises sémantiques telles que header, main, section, article, aside et footer.
  5. Inspectez les sélecteurs CSS et les crochets d'événements JavaScript.
  6. Utilisez les outils de développement du navigateur ou des captures d'écran lorsque l'emplacement source n'est pas évident.

Si le contenu répété est rendu à partir de données, modifiez les données source plutôt que seulement le balisage généré.

Préservation du design

Adaptez l'édition au site actuel.

  • Réutilisez l'espacement, la typographie, les couleurs, les bordures, les ombres, les icônes et les motifs de mouvement existants.
  • Gardez le texte dans son conteneur sur desktop et mobile.
  • Évitez que les effets décoratifs n'interfèrent avec la lecture.
  • Respectez prefers-reduced-motion lors de la modification d'animations.
  • Gardez les pages d'article/détail plus calmes que les pages d'accueil fortement stylisées, sauf demande contraire de l'utilisateur.
  • N'ajoutez pas de section héroïque de type marketing ou de section décorative non liée à un site personnel ou un blog.

Lorsque vous modifiez du texte, correspondez à la voix existante et à la langue de l'utilisateur.

Modifications d'interaction

Pour les modifications JavaScript ou d'interaction :

  • Trouvez les écouteurs d'événements et les conventions d'état existants avant d'en ajouter de nouveaux.
  • Gardez le JavaScript vanilla si le site est statique simple.
  • Évitez d'introduire des dépendances ou des étapes de construction.
  • Lors de la génération de liens, de résultats de recherche, d'URL d'images ou d'éléments de navigation en JavaScript, utilisez des chemins relatifs à la page qui fonctionnent depuis la profondeur de la page affectée.
  • Testez les états de clic, clavier, mobile et d'utilisation répétée lorsque cela est pertinent.
  • Préservez les bases d'accessibilité telles que le focus, les étiquettes et le comportement de mouvement réduit.

Corrections responsive

Pour les problèmes de mise en page ou mobiles :

  • Vérifiez à la fois les largeurs desktop et mobile.
  • Préférez les modifications CSS qui préservent la mise en page desktop tout en corrigeant les écrans étroits.
  • Utilisez des dimensions stables, l'habillage, les largeurs min/max, les ajustements grid/flex et le contrôle du débordement.
  • Ne cachez pas le contenu important sur mobile juste pour faire correspondre la mise en page.

Guide d'édition

Si la modification affecte la manière dont les futures éditions devraient être effectuées, mettez à jour EDITING.md.

Mettez-le à jour lorsque :

  • Une nouvelle section, classe, champ de données ou modèle d'interaction est introduit.
  • Le stockage du contenu est déplacé vers un nouveau fichier ou objet de données.
  • L'utilisateur a demandé un changement que les futurs agents devraient préserver.

Ne mettez pas à jour EDITING.md pour de petits changements de texte ou d'espacement, sauf si le guide deviendrait autrement trompeur.

Validation

Validez la surface affectée, pas nécessairement l'ensemble du site.

Utilisez un outil de navigateur interactif réellement disponible avant l'édition pour confirmer la page cible et la région. « Disponible » signifie qu'il est exposé dans la liste d'outils appelables du tour actuel. Dans Codex, cela peut être le plugin Browser/navigateur intégré à l'application lorsqu'il est routé dans le tour ; dans d'autres agents, cela peut être un navigateur visible équivalent, un outil de navigation ou un navigateur basé sur les outils de développement. Après l'édition, revenez à cette même page et région dans le navigateur interactif pour vérifier le résultat.

Si aucun outil de navigateur interactif n'est appelable, ne faites pas semblant que la confirmation de navigateur avant/après a eu lieu. Demandez à l'utilisateur d'activer ou d'invoquer l'outil de navigateur si l'édition dépend du mappage de région visuelle ; pour Codex, cela peut signifier envoyer une demande qui mentionne explicitement @browser. Si l'utilisateur ne redirige pas ou que le client n'a pas un tel outil, revenez à Playwright, aux captures d'écran ou à l'inspection du code source et indiquez la limitation.

Ne par défaut pas à Playwright, à la validation par captures d'écran uniquement ou à l'inspection du code source seul lorsqu'un outil de navigateur interactif est réellement appelable. N'utilisez Playwright que comme solution de repli lorsqu'aucun outil de navigateur interactif n'est appelable, lorsque l'utilisateur le demande explicitement ou lorsqu'une régression scriptée reproductible est spécifiquement nécessaire.

Pour les modifications visuelles, responsives ou interactives, vérifiez la région modifiée dans les viewports desktop/mobile pertinents et exercez l'interaction modifiée.

Exécutez ou suggérez review-static-site uniquement lorsque l'édition affecte la navigation partagée, la mise en page globale, de nombreuses pages, les chemins de ressources, l'encodage source ou l'état de publication.

Si l'édition touche à href, src, url(...) CSS, images, polices, favicons, fichiers de données ou URL générées par JavaScript, vérifiez que la page affectée fonctionne toujours avec des chemins relatifs à la page et que l'ouverture directe du fichier statique ne perdra pas CSS, JS ou images.

Sortie

Pour les éditions locales, rapportez uniquement :

  • Où la modification a été effectuée.
  • Quels fichiers ont été modifiés.
  • Quelle validation a été réalisée.

Ne mentionnez la validation plus large review-static-site que lorsqu'elle est réellement recommandée. Ne répétez pas le rapport et ne survolez pas la totalité du codebase.

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

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