Communitygithub.com

sandbox-safemode/365-castle-logos

Construisez des sites web distinctifs et de qualité production, en évitant l'esthétique générique de l'IA. Chaque choix — typographie, couleur, mouvement, mise en page — doit être intentionnel. Déployez sous forme de bundles HTML/CSS/JS statiques sur S3.

Qu'est-ce que 365-castle-logos ?

Cette compétence est conçue pour les développeurs souhaitant créer des sites web statiques de haute qualité, en évitant le design générique souvent associé à l'IA. Elle couvre l'ensemble du processus, de la conception à la publication, avec un accent sur des choix esthétiques intentionnels. La compétence fournit des directives détaillées sur la direction artistique, les systèmes de design (palette Nexus, typographie), la génération d'actifs (logos SVG, images), et le déploiement sur Amazon S3. Elle inclut également des processus d'assurance qualité visuelle avec Playwright pour les sites complexes. La compétence propose un routage basé sur le type de projet (sites d'information, applications web, jeux), chaque type ayant ses propres sous-fichiers de guidance. Elle est compatible avec tous les environnements de développement où des outils d'IA sont utilisés pour générer du code.

Compatible avec✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/sandbox-safemode/365-castle-logos/tree/HEAD/skills/website-building

Demander à votre IA préférée

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

Documentation

Construction de sites web

Construisez des sites web distinctifs et de qualité production, en évitant l'esthétique générique de l'IA. Chaque choix — typographie, couleur, mouvement, mise en page — doit être intentionnel. Déployez sous forme de bundles HTML/CSS/JS statiques sur S3.

Cette compétence couvre tout ce qui concerne les projets web. Lorsqu'elle est chargée via load_skill("website-building"), tous les fichiers sont copiés dans workspace/. Lisez les sous-fichiers selon les besoins de votre projet. Pour les applications web, chargez la compétence enfant : load_skill("website-building/webapp").

Les principes de conception universels (philosophie des couleurs, palette par défaut, sélection des polices) sont partagés avec d'autres compétences via design-foundations. Les fichiers partagés de cette compétence étendent ces fondations avec une implémentation spécifique au web (variables CSS, jetons réactifs, feuilles de style de base). Vous n'avez pas besoin de charger design-foundations séparément — les versions spécifiques au web dans shared/ sont complètes.

Utilisez read avec le chemin complet, par exemple shared/01-design-tokens.md


Routage par type de projet

Étape 1 : Identifiez le type de projet et chargez les directives spécifiques au domaine :

Type de projetActionExemples
Sites d'informationread informational/informational.mdSites personnels, portfolios, éditoriaux/blogs, petites entreprises, pages d'accueil
Applications webload_skill("website-building/webapp")Produits SaaS, tableaux de bord, panneaux d'administration, e-commerce, expériences de marque
Jeux navigateurread game/game.md + game/game-testing.mdJeux Canvas 2D, Three.js/WebGL, jeux HTML5, expériences 3D interactives

Étape 2 : Lisez les fichiers partagés — lisez shared/01-design-tokens.md et shared/02-typography.md en premier (obligatoire pour TOUS les types de projets, y compris les applications web). Ceux-ci établissent les valeurs par défaut du système de design Nexus et les règles typographiques qui s'appliquent universellement. Pour les applications web et les tableaux de bord, ignorez les fichiers marqués avec † ci-dessous — ceux-ci contiennent des détails d'implémentation préconfigurés dans le modèle fullstack.

Si l'utilisateur dit simplement « site web » ou « site » sans détails, demandez quel type ou par défaut pour les sites d'information.


Référence des sous-fichiers

Partagés (shared/) — Chaque projet

FichierCouvreChargement
shared/01-design-tokens.mdÉchelle typographique, espacement, palette Nexus, base.cssToujours
shared/02-typography.mdSélection de polices, appairage, chargement, liste noireToujours
shared/04-layout.mdComposition spatiale, responsive, mobile-firstToujours †
shared/05-taste.mdChargeurs squelettes, états vides/erreur, polissageToujours
shared/08-standards.mdAccessibilité, performance, anti-modèlesToujours
shared/09-technical.mdStructure du projet, bac à sable, déploiement, liste de vérificationToujours †
shared/03-motion.mdAnimations de défilement, bibliothèque Motion, plugins SVG GSAP, survol/curseurQuand animé
shared/06-css-and-tailwind.mdTailwind CSS v3, shadcn/ui, CSS moderneQuand vous utilisez Tailwind
shared/07-toolkit.mdBibliothèques CDN, React, Three.js, icônes, cartes, motifs/filtres SVG, esm.shQuand vous choisissez des bibliothèques
shared/10-charts-and-dataviz.mdChart.js, Recharts, D3, KPI, sparklinesQuand la visualisation de données est nécessaire
shared/11-web-technologies.mdVersions des frameworks, compatibilité navigateurLors de la vérification de la compatibilité
shared/12-playwright-interactive.mdPersistant QA navigateur Playwright, captures d'écran, tests visuelsLors des tests
shared/19-backend.mdServeurs FastAPI/Express/Flask, WebSocket, SSE, transfert de portQuand un backend est nécessaire
shared/20-llm-api.mdChat LLM, génération d'images/vidéos/audio, transcription — modèles, identifiants, SDK d'aideQuand le site utilise des API IA/LLM

Tous les chemins sont relatifs à ``.

† Ignorer pour les applications web et les tableaux de bord — détails d'implémentation préconfigurés dans le modèle fullstack. Les jetons de design et la typographie NE sont PAS ignorés — ils fournissent les valeurs par défaut du système de design et les directives de sélection de polices pour tous les types de projets.

Spécifiques au domaine — Chargez-en un

FichierQuand charger
load_skill("website-building/webapp")SaaS, tableau de bord, administration, e-commerce, expérience de marque (compétence enfant avec modèle fullstack)
skills/website-building/webapp/dashboards.mdTableau de bord ou interface à forte densité de données (compagnon de l'application web)
informational/informational.mdSite personnel, portfolio, éditorial, petite entreprise, page d'accueil
game/game.mdJeu navigateur, Three.js, WebGL, 3D interactif
game/2d-canvas.mdJeu Canvas 2D (compagnon de game.md)
game/game-testing.mdTout jeu navigateur — chargez-le avec game.md

QA interactif : Lisez shared/12-playwright-interactive.md pour l'automatisation persistante du navigateur avec Playwright (captures d'écran, tests fonctionnels, QA visuel). Requis pour les tests de jeux, utile pour tout site complexe.


Flux de travail

  1. Direction artistique : Clarifiez l'objectif, choisissez une direction esthétique
  2. Contrôle de version : Exécutez git init dans le répertoire du projet après l'échafaudage. Validez après chaque étape majeure avec un message court.
  3. Construction : Construisez le site page par page, en prenant des captures d'écran via Playwright pour le QA visuel
  4. Publication : Validez toutes les modifications, puis deploy_website() renvoie une URL publique

Utilisez tous les outils

  • Recherchez d'abord. Cherchez sur le web des sites de référence, des tendances et des exemples de concurrents avant de concevoir. Parcourez des exemples primés du type de site spécifique. Récupérez toutes les URL fournies par l'utilisateur.
  • Générez des actifs réels — généreusement. Générez des images pour les héros, les illustrations de section, les visuels éditoriaux, les arrière-plans atmosphériques — pas seulement une seule image de héros. Chaque page longue doit avoir un rythme visuel avec des images générées qui correspondent à la direction artistique du site. Pas d'espaces réservés. Générez un logo SVG personnalisé pour chaque projet (voir ci-dessous) — le SVG est pour les logos uniquement, sauf si l'utilisateur demande explicitement une sortie SVG. Enregistrez des images de référence web qui informent la direction.
  • Prenez des captures d'écran via Playwright (sites complexes uniquement). Pour les sites multi-pages, les applications web, les tableaux de bord et les jeux, lisez skills/website-building/shared/12-playwright-interactive.md pour prendre des captures d'écran à la fois en bureau (1280px+) et en mobile (375px). Ignorez Playwright pour les sites statiques simples d'une seule page — voir QA visuel ci-dessous.
  • Écrivez directement du code de production. HTML, CSS, JS, SVG. Utilisez bash pour les outils de construction et le traitement des fichiers.

Génération de logo SVG

Chaque projet reçoit un logo SVG personnalisé intégré. Ne remplacez jamais par un en-tête de texte stylisé.

  1. Comprenez la marque — objectif, ton, un mot déterminant
  2. Écrivez SVG directement — formes géométriques, lettres ou marques abstraites. Une forme mémorable.
  3. Principes : Géométrique/minimal (Paul Rand, Vignelli). Fonctionne à 24px et 200px. Monochrome d'abord — ajoutez la couleur en amélioration. Utilisez currentColor pour les modes clair/sombre.
  4. Implémentez intégré avec aria-label, viewBox, fill="none", traits currentColor
  5. Générez un favicon — version simplifiée 32x32 si nécessaire

Pour l'animation SVG (DrawSVG, MorphSVG), voir shared/03-motion.md. Pour les motifs/filtres SVG, voir shared/07-toolkit.md.


Processus de test QA visuel

Quand utiliser Playwright QA

Ignorez Playwright pour les sites simples. Les sites statiques d'une seule page n'ont PAS besoin de captures d'écran Playwright. Examinez le code directement, puis déployez. Playwright QA ajoute un temps considérable et n'en vaut pas la peine pour un contenu statique simple.

Utilisez Playwright pour les sites complexes. Les sites multi-pages, les applications web, les tableaux de bord, les jeux et tout site avec des fonctionnalités interactives (formulaires, paniers, filtres, graphiques, glisser-déposer) DOIVENT utiliser Playwright QA. Lisez skills/website-building/shared/12-playwright-interactive.md pour l'automatisation persistante du navigateur.

Processus Playwright QA (sites complexes uniquement)

Cycle : Construire → Playwright QA → Évaluer → Corriger → Répéter → Déployer quand prêt

Étape 1 : QA page par page

Après avoir construit chaque page :

  1. Prenez une capture d'écran en bureau (1280px+) et mobile (375px) via Playwright
  2. Évaluez de manière critique : A-t-il l'air professionnellement conçu (pas généré par IA) ? La typographie est-elle distinctive ? Les espaces blancs sont-ils généreux ? Y a-t-il une hiérarchie visuelle claire ?
  3. Corrigez chaque problème avant de passer à la suite. Pas de dette visuelle.

Étape 2 : QA final (avant publication)

  1. Prenez une capture d'écran de chaque page en bureau et mobile
  2. Vérifiez la cohérence entre les pages (espacement, couleur, traitement typographique)
  3. Vérifiez le mode sombre (prenez une capture d'écran des deux thèmes pour la page d'accueil au minimum)
  4. Vérifiez les états interactifs : survol, focus, actif, chargement, vide, erreur
  5. Test d'impression à froid : a-t-il l'air soigné et intentionnel ?

Échecs QA : débordement de texte, espacement incohérent, couleurs hors norme, mode sombre manquant, mobile écrasé, aspect générique IA, contenu d'espace réservé, logo manquant.


Étape 1 : Direction artistique — Inférez avant de demander, demandez avant de prendre par défaut

Chaque site doit avoir une identité visuelle dérivée de son contenu. Ne passez pas directement à la palette de secours Nexus. La palette Nexus est un dernier recours lorsque l'inférence et la demande ont toutes deux échoué — pas un défaut pratique.

  1. Inférez à partir du sujet. Un site de torréfacteur → bruns terreux, crème chaude, aspect dessiné à la main. Un tableau de bord fintech → ardoise froide, sans-serif net, dense en données. Une application d'apprentissage pour enfants → primaires vives, typographie arrondie, mouvement ludique. Le contenu lui-même vous indique la palette, la typographie et l'espacement avant que l'utilisateur ne dise un mot.
  2. Consultez les tableaux de direction artistique. Chaque fichier de domaine (informational.md, webapp/SKILL.md, game/game.md) a un tableau de direction artistique mappant les types de sites/produits à des directions conceptuelles et des points de départ de jetons. Utilisez-les comme tremplin.
  3. Dérivez les cinq piliers : Couleur (chaude/froide, accent du sujet), Typographie (serif/sans, personnalité d'affichage), Espacement (dense/généreux), Mouvement (minimal/expressif), Imagerie (photo/illustration/type uniquement).
  4. Si le sujet est vraiment ambigu, demandez — « Quelle ambiance visez-vous ? » et « Des sites de référence ? » Une question suffit.
  5. Repli Nexus — uniquement lorsque l'inférence ET la demande ne donnent rien. Si l'utilisateur a été interrogé et n'a donné aucune direction, ET que le sujet ne donne aucun signal clair, alors revenez aux valeurs par défaut Nexus/Suisse.

Le repli : Propre et suisse (dernier recours)

Lorsque l'inférence n'a donné aucune direction claire ET que l'utilisateur a été interrogé mais n'a donné aucune directive de style, utilisez les valeurs par défaut de shared/01-design-tokens.md avec :

  • Typographie : Satoshi ou General Sans pour le corps (Fontshare — préféré), ou Inter/DM Sans. Contraste de poids plutôt que contraste de polices. 3-4 tailles maximum. Gardez le texte compact — --text-3xl/--text-hero sont pour les héros de sites d'information uniquement.
  • Couleur : Palette Nexus. Surfaces neutres + un accent sarcelle pour les CTA uniquement.
  • Mise en page : Aligné sur la grille. Marges généreuses. Asymétrique là où c'est intéressant.
  • Mouvement : Minimal, fonctionnel. Transitions d'état fluides uniquement.
  • Imagerie : Générez des visuels propres et pertinents. Pas de photos stock.

Direction artistique — Évitez l'esthétique IA

Voir shared/08-standards.md pour la liste complète des anti-modèles.


Étape 2 : Publier

Appelez deploy_website() avec le chemin du projet et le nom du site. Renvoie une URL publique S3. Pour mettre à jour, modifiez les fichiers locaux et redéployez avec le même chemin. Voir shared/09-technical.md pour l'appel exact et des exemples.

Skills associés