Communitygithub.com

pikaOne1138/astro-personal-site-starter

Concevez, construisez, peaufinez ou auditez des sites Astro élégants pour les archétypes blog/connaissance et helper/service professionnel.

Qu'est-ce que astro-personal-site-starter ?

Cette compétence permet de créer des sites web statiques avec Astro en adoptant une approche centrée sur le design plutôt que la génération automatique. Elle définit deux architectures de contenu principales (Blog/Connaissance et Helper/Service professionnel) et trois personnalités visuelles distinctes (Papier & Encre, Lumière Matinale, Studio Calme). L'outil fournit des règles de conception précises (grille, typographie, palette, animations) et une hiérarchie des preuves pour guider les décisions de design. Idéal pour les développeurs qui souhaitent produire des sites vitrines soignés sans dériver vers des fonctionnalités backend complexes, comme des CRM ou des systèmes de paiement.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/pikaOne1138/astro-personal-site-starter/tree/HEAD/.ai/astro-ui-craft

Demander à votre IA préférée

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

Documentation

Astro UI Craft

Créez des sites web qui semblent conçus, pas simplement générés.

Modèle de base

Deux architectures de contenu :

  • Connaissance / Blog
  • Helper / Service Professionnel

Trois personnalités visuelles :

  • Papier & Encre
  • Lumière Matinale
  • Studio Calme

Considérez cela comme 2 architectures × 3 directions visuelles, et non six bases de code indépendantes.

Garde-fou de périmètre

Le périmètre par défaut est un site front-end soigné. Privilégiez les formulaires externes, LINE, les services de réservation et de newsletter. N'étendez pas silencieusement vers un CRM, une authentification, des systèmes membres, des moteurs de réservation personnalisés, des paiements, des bases de données ou une administration SaaS.

Hiérarchie des preuves

  1. Observations directes (capture d'écran, CSS calculé).
  2. Observations issues de recherches web et vérifiées par page.
  3. Motifs transversaux issus de cas vérifiés.
  4. Propositions de design et tokens synthétisés.
  5. Listes candidates issues uniquement de la mémoire ou non vérifiées explicitement.

Tâche de la page Connaissance / Blog

Répondre à :

  • De quoi parle cette personne ?
  • Par où un nouveau lecteur devrait-il commencer ?
  • Comment trouver plus d'informations sur un sujet ?
  • Pourquoi devrais-je la suivre ?
  • Quelle est la prochaine action à faible friction ?

Flux par défaut : Hero → Commencer ici/sujets → articles à la une/récents → court À propos → ressource → newsletter → Pied de page

Tâche de la page Helper / Professionnelle

Répondre à :

  • Suis-je au bon endroit ?
  • Cette personne comprend-elle ma situation ?
  • Que propose-t-elle ?
  • Que se passe-t-il si je la contacte ?
  • Pourquoi puis-je lui faire confiance ?
  • Quelle est la prochaine action à faible pression ?

Flux par défaut : Hero → empathie → services → première visite/processus → À propos/témoignages → confiance → FAQ → réservation/contact → Pied de page

Privilégiez environ 7 ± 1 sections significatives.

Personnalités visuelles

Papier & Encre

Papier chaud, encre foncée, police à empattement pour l'affichage, filets fins, images à faible saturation, listes éditoriales.

Lumière Matinale

Crème, accents argile/rose/sauge, empattement doux + sans empattement lisible, coins arrondis généreux, images en lumière naturelle, réconfort subtil.

Studio Calme

Gris chaud quasi-blanc, grille précise, typographie sans empattement, un accent fort, bordures fines, métadonnées de contenu/service structurées.

Règles UI raffinées

  • Structure avant décoration.
  • Échelle d'espacement cohérente.
  • Mesure longue environ 60–72 caractères.
  • Un accent principal + neutres.
  • Ratios d'image et traitement tonal cohérents.
  • Retour d'état visible au survol/focus/actif.
  • Éviter le violet néon, le verre dépoli excessif, les grilles bento aléatoires, les sections répétées à trois colonnes avec icônes, les grands dégradés vagues, les compteurs/carousels/effets machine à écrire superflus.

Navigation

Bureau : [Logo] 4–5 liens ... [un seul CTA principal]

  • Connaissance : Articles / Sujets / Commencer ici / À propos + S'abonner.
  • Helper : Services / Processus / À propos / Articles / FAQ + Réserver/Contacter.
  • Éviter les menus méga pour la base de l'atelier.

CTA

Trois niveaux sémantiques au maximum :

  • Principal : S'abonner OU Réserver une introduction.
  • Secondaire : comprendre l'adéquation/le processus/une ressource gratuite.
  • Faible pression : lire/explorer/en savoir plus.

Langage helper : "預約初談", "了解合作方式", "第一次來?先看看流程", "開始聊聊".

Animation

  • survol : 150–220 ms
  • transitions UI : 180–350 ms
  • apparition : 400–650 ms
  • mouvement : 4–16 px
  • échelle : ~0,98–1,03
  • ease-out cohérent
  • préférer transform + opacity
  • respecter prefers-reduced-motion

L'effet recherché : les utilisateurs ne remarquent peut-être pas consciemment l'animation, mais le site donne l'impression d'être soigné.

Responsive

Ne vous contentez pas de réduire le bureau.

  • Bureau : conteneur d'environ 1080–1200 px.
  • Tablette : simplifier les mises en page fractionnées/le contenu latéral fixe.
  • Mobile : flux de lecture unique, généreux padding latéral, contrôles en pleine largeur si utile.
  • Le helper peut utiliser un CTA de réservation persistant uniquement s'il ne couvre pas le contenu.

Contrôle qualité

Avant la remise :

  • la tâche principale de la page est évidente ;
  • la hiérarchie se lit correctement sans décoration ;
  • la composition mobile fonctionne ;
  • le contraste/les cibles tactiles/les états de focus sont utilisables ;
  • l'animation est subtile et optionnelle ;
  • la construction réussit ;
  • aucune dérive accidentelle de périmètre backend.

Skills associés