Communitygithub.com

GanderBite/relay

Compétence complète pour créer des sites web avec Astro.build. À utiliser lorsque l'utilisateur souhaite créer un site web avec Astro, doit sélectionner un thème approprié parmi les thèmes gratuits d'Astro, nécessite un accès à la documentation d'Astro, ou veut développer des composants et des pages Astro. Cette compétence gère la sélection des thèmes, l'accès à la documentation, la configuration du projet et les patterns de développement spécifiques à Astro.

Qu'est-ce que relay ?

Cette compétence spécialisée guide l'utilisateur dans la création de sites web modernes avec Astro.build, en automatisant les étapes clés du workflow : compréhension des besoins, sélection de thèmes gratuits compatibles React, configuration du projet et implémentation de composants. Elle s'appuie sur une documentation intégrée (astro_docs.md) et des appels web_fetch vers le répertoire officiel des thèmes et la documentation LLM d'Astro. La compétence couvre tous les types de sites (blogs, portfolios, documentation, landing pages, e-commerce) et les intégrations de frameworks (React, Vue, Svelte). Elle met en avant l'architecture d'îles (Islands Architecture), l'optimisation des performances via le composant Image d'Astro et les astuces de dépannage courantes. Elle inclut des scripts d'analyse automatique des thèmes (theme_analyzer.py) et des workflows d'exemple détaillés (blog, portfolio, site de documentation).

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/GanderBite/relay/tree/HEAD/.claude/skills/astro-builder

Demander à votre IA préférée

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

Documentation

Constructeur de sites web Astro

Cette compétence vous aide à créer des sites web avec Astro.build en vous guidant dans la sélection des thèmes, l'accès à la documentation, et les bonnes pratiques de développement. Utilisez cette compétence dès qu'un utilisateur mentionne la création avec Astro, souhaite créer un site web, ou a besoin d'aide avec des fonctionnalités spécifiques à Astro.

Quand utiliser cette compétence

Activez cette compétence lorsque :

  • L'utilisateur mentionne "Astro" ou "astro.build" dans sa demande
  • L'utilisateur souhaite créer un site web et Astro est approprié (blogs, documentation, portfolios, sites marketing, etc.)
  • L'utilisateur doit sélectionner un thème pour son projet Astro
  • L'utilisateur a besoin d'aide avec les composants, le routage ou la configuration d'Astro
  • L'utilisateur veut intégrer React, Vue ou d'autres frameworks avec Astro
  • L'utilisateur a besoin d'accéder à la documentation d'Astro ou aux bonnes pratiques

Aperçu du workflow

Lors de la création d'un site web Astro, suivez ce processus :

  1. Comprendre les besoins - Déterminer le type de site web et les fonctionnalités nécessaires
  2. Sélectionner le thème approprié - Choisir parmi les thèmes gratuits d'Astro en fonction des exigences
  3. Accéder à la documentation - Consulter la documentation Astro pour les fonctionnalités spécifiques
  4. Initialiser le projet - Mettre en place la structure du projet
  5. Développer les composants - Construire en utilisant l'architecture des composants Astro
  6. Optimiser et déployer - Suivre les bonnes pratiques de performance

Étape 1 : Comprendre les besoins

Tout d'abord, identifiez le type de site web et ses exigences :

Types de sites web :

  • Blog / Site de publication
  • Portfolio / Vitrine
  • Site de documentation
  • Page d'atterrissage / Marketing
  • Site e-commerce
  • Site d'entreprise / professionnel
  • Site personnel

Questions clés à poser :

  • Quel est l'objectif principal du site ?
  • Quels types de contenu aura-t-il ? (articles de blog, projets, produits, etc.)
  • A-t-il besoin d'interactivité ? (formulaires, recherche, contenu dynamique)
  • Quels frameworks l'utilisateur préfère-t-il ? (React, Vue, Svelte, etc.)
  • A-t-il besoin de fonctionnalités spécifiques ? (mode sombre, i18n, intégration CMS)

Étape 2 : Sélectionner le thème approprié

Utilisez web_fetch pour parcourir les thèmes gratuits compatibles React :

URL : https://astro.build/themes/1/?search=&technology%5B%5D=react&price%5B%5D=free

Critères de sélection du thème :

Pour les blogs / publications :

  • Rechercher des thèmes avec une typographie soignée
  • Doit prendre en charge Markdown/MDX
  • Doit avoir des étiquettes/catégories
  • Prise en charge des flux RSS
  • Considérer : astro-paper, astro-blog-template

Pour les portfolios :

  • Présentation visuelle des projets
  • Sections À propos / Contact
  • Animations fluides
  • Considérer : astro-portfolio, thèmes personnal-portfolio

Pour la documentation :

  • Utiliser Starlight (framework officiel de documentation Astro)
  • Fonctionnalités : Recherche, navigation latérale, mode sombre, i18n
  • Idéal pour : Documentation technique, références API, guides

Pour les pages d'atterrissage :

  • Section héros avec appel à l'action (CTA)
  • Sections Fonctionnalités / Avantages
  • Formulaires de contact
  • Optimisé pour la conversion

Pour l'e-commerce :

  • Listes de produits et filtres
  • Fonctionnalité de panier d'achat
  • Prêt pour l'intégration de paiement
  • Pages de détail produit

Action : Récupérez la page des thèmes, analysez les thèmes disponibles, et recommandez 2 à 3 options qui correspondent le mieux aux besoins de l'utilisateur. Expliquez pourquoi chaque thème est approprié.

Étape 3 : Accéder à la documentation d'Astro

Lorsque vous avez besoin d'une documentation spécifique à Astro, référencez :

  1. Référence intégrée : references/astro_docs.md - Contient les concepts fondamentaux d'Astro, la syntaxe et les patterns courants
  2. Documentation complète : Récupérez depuis https://docs.astro.build/llms-full.txt pour des informations exhaustives

Quand consulter la documentation :

  • Questions sur la syntaxe des composants → Consultez astro_docs.md
  • Routage et pages → Consultez astro_docs.md
  • Options de style → Consultez astro_docs.md
  • Fonctionnalités avancées → Récupérez depuis docs.astro.build
  • Configuration d'intégration → Récupérez depuis docs.astro.build
  • Détails de l'API → Récupérez depuis docs.astro.build

Étape 4 : Initialiser un projet Astro

Utilisation de l'interface en ligne de commande Create Astro

# Créer un nouveau projet
npm create astro@latest

# Ou avec un modèle spécifique
npm create astro@latest -- --template <nom-utilisateur-theme-github>/<depot-theme>

Configuration de la structure du projet

Après l'initialisation, assurez-vous d'une structure correcte :

projet/
├── src/
│   ├── components/     # Composants réutilisables
│   ├── layouts/        # Mises en page
│   ├── pages/          # Routes (OBLIGATOIRE)
│   │   └── index.astro # Page d'accueil
│   ├── content/        # Collections de contenu (optionnel)
│   └── assets/         # Images optimisées
├── public/             # Ressources statiques
├── astro.config.mjs    # Configuration
├── package.json
└── tsconfig.json

Critique : Le répertoire src/pages/ est OBLIGATOIRE pour le bon fonctionnement du routage.

Étape 5 : Développer des composants et des pages

Modèle de développement de composants

  1. Créer le fichier du composant dans src/components/
  2. Définir l'interface des props (si TypeScript est utilisé)
  3. Écrire le script du composant (s'exécute au moment de la construction)
  4. Créer le template (HTML avec syntaxe Astro)
  5. Ajouter des styles limités (optionnel)

Exemple :

---
interface Props {
  title : chaîne de caractères ;
  description? : chaîne de caractères ;
}
const { title, description } = Astro.props ;
---

<article>
  <h2>{title}</h2>
  {description && <p>{description}</p>}
</article>

<style>
  article {
    padding : 1rem ;
    border : 1px solid #ccc ;
  }
</style>

Modèle de développement de pages

  1. Créer le fichier de la page dans src/pages/ (détermine la route)
  2. Importer les composants et les mises en page nécessaires
  3. Définir getStaticPaths() pour les routes dynamiques
  4. Composer la page à l'aide des composants

Exemple de page :

---
import Layout from '../layouts/Layout.astro' ;
import Hero from '../components/Hero.astro' ;

const title = "Ma page" ;
---

<Layout title={title}>
  <Hero />
  <!-- Plus de contenu -->
</Layout>

Ajout d'interactivité

Lorsque vous avez besoin d'interactivité côté client :

  1. Installer l'intégration du framework : npx astro add react
  2. Créer un composant du framework (.jsx, .vue, .svelte)
  3. Importer et utiliser avec une directive client :
---
import ReactComponent from '../components/ReactComponent.jsx' ;
---

<!-- Statique (pas de JS) -->
<ReactComponent />

<!-- Interactif -->
<ReactComponent client:load />
<!-- Options : client:idle, client:visible, client:media -->

Étape 6 : Consulter la documentation selon les besoins

Avant d'écrire du code, lisez les sections pertinentes de references/astro_docs.md :

  • Questions sur les composants → Lire la section "Syntaxe des composants"
  • Problèmes de routage → Lire la section "Routage"
  • Style → Lire la section "Style"
  • Images → Lire la section "Images et ressources"
  • Configuration → Lire la section "Configuration"

Pour les sujets avancés, récupérez la documentation complète :

web_fetch : https://docs.astro.build/llms-full.txt

Bonnes pratiques

Optimisation des performances

  1. Garder les composants statiques par défaut - N'ajouter client:* que lorsque c'est réellement nécessaire
  2. Utiliser le composant Image d'Astro - Optimisation automatique
  3. Tirer parti de l'architecture d'îles - JavaScript minimal par défaut
  4. Division du code - Astro divise automatiquement par page

Workflow de développement

  1. Commencer par la structure - Mettre en place les mises en page et les pages de base en premier
  2. Orienté composants - Construire des composants réutilisables
  3. Sécurité des types - Utiliser TypeScript pour les props et une meilleure expérience développeur
  4. Collections de contenu - Pour une gestion de contenu type-safe
  5. Tester localement - Exécuter npm run dev fréquemment

Modèles courants à suivre

  • Utiliser des mises en page pour une structure de page cohérente
  • Créer un composant SEO pour les balises meta
  • Mettre en place des interfaces TypeScript appropriées
  • Implémenter des pages d'erreur correctes (404, 500)
  • Ajouter un texte alternatif approprié aux images
  • Utiliser un HTML sémantique

Dépannage

Problèmes courants

"Module introuvable"

  • Vérifier les chemins d'importation corrects
  • Vérifier que les intégrations sont installées
  • Vérifier que astro.config.mjs a une configuration d'intégration correcte

"La page ne s'affiche pas"

  • Vérifier que le fichier se trouve dans le répertoire src/pages/
  • Vérifier les erreurs de syntaxe dans le frontmatter
  • Vérifier que l'extension de fichier est correcte (.astro, .md, .mdx)

"Les styles ne s'appliquent pas"

  • Les styles limités ne s'appliquent qu'au propre HTML du composant
  • Utiliser is:global pour les styles globaux
  • Vérifier la configuration Tailwind si vous utilisez Tailwind

"Le composant n'est pas interactif"

  • Ajouter une directive client:* aux composants du framework
  • Vérifier que l'intégration est installée (par exemple @astrojs/react)
  • Vérifier la console du navigateur pour les erreurs JavaScript

Ressources

Scripts

  • scripts/theme_analyzer.py - Aide à récupérer et analyser les thèmes Astro depuis la page officielle des thèmes. Utilisez-le pour explorer programmatiquement les options de thème en fonction des filtres de technologie et de prix.

Références

  • references/astro_docs.md - LISEZ CECI EN PREMIER pour les concepts fondamentaux d'Astro, la syntaxe des composants, le routage, le style et les modèles courants. Il s'agit de votre référence principale pour le développement Astro.

Ressources externes

Exemples de workflows

Exemple 1 : Construire un blog

Utilisateur : "Je veux construire un blog avec Astro et React"

Workflow :

  1. Identifier les besoins : Site blog, nécessite le support React, veut un thème gratuit
  2. Récupérer les thèmes : web_fetch https://astro.build/themes/1/?technology%5B%5D=react&price%5B%5D=free
  3. Recommander un thème : Suggérer 2-3 thèmes orientés blog avec explications
  4. Lire references/astro_docs.md pour consulter les modèles de composants
  5. Guider la configuration : Fournir les commandes d'installation et la structure
  6. Aider à la construction : Créer la mise en page des articles de blog, page de liste, pages d'articles individuels
  7. Ajouter de l'interactivité : Montrer comment ajouter des composants React avec client:load pour des fonctionnalités comme les commentaires

Exemple 2 : Site portfolio

Utilisateur : "Créez un site portfolio pour moi en utilisant https://astro.build/"

Workflow :

  1. Clarifier les besoins : Quoi exposer (projets, compétences, expérience ?)
  2. Récupérer les thèmes portfolio depuis la page des thèmes Astro
  3. Recommander la meilleure correspondance en fonction du domaine de l'utilisateur (développeur, designer, etc.)
  4. Lire la syntaxe des composants depuis references/astro_docs.md
  5. Mettre en place la structure du projet avec le thème sélectionné
  6. Créer/personnaliser les composants (Hero, grille Projets, À propos, Contact)
  7. Ajouter des transitions fluides si nécessaire
  8. Optimiser les images à l'aide du composant Image d'Astro

Exemple 3 : Site de documentation

Utilisateur : "J'ai besoin d'un site de documentation avec recherche et mode sombre"

Workflow :

  1. Identifier : Site de documentation, nécessite recherche et mode sombre
  2. Recommander Starlight (framework officiel de documentation Astro)
  3. Montrer la configuration : npm create astro@latest -- --template starlight
  4. Consulter la documentation Starlight depuis la documentation complète d'Astro
  5. Configurer la structure de navigation latérale
  6. Mettre en place la structure du contenu
  7. Activer le mode sombre (intégré)
  8. Configurer la recherche (intégrée avec Pagefind)

Rappels importants

  1. Lisez toujours references/astro_docs.md EN PREMIER avant de répondre à des questions sur les composants ou la syntaxe
  2. Récupérez les thèmes depuis la page des thèmes Astro lorsque l'utilisateur a besoin d'un point de départ
  3. Utilisez web_fetch pour la documentation complète si nécessaire
  4. Gardez les choses simples - Astro est conçu pour être simple ; ne compliquez pas trop
  5. Architecture d'îles - Rappelez-vous que les composants sont statiques par défaut
  6. Sécurité des types - Encouragez l'utilisation de TypeScript pour une meilleure expérience de développement

Critères de succès

Un projet Astro est correctement configuré lorsque :

  • ✅ La structure du projet suit les conventions Astro
  • ✅ Le répertoire src/pages/ existe avec au moins index.astro
  • ✅ Un thème approprié a été sélectionné en fonction des besoins
  • ✅ Les composants respectent les modèles de syntaxe Astro
  • ✅ L'interactivité côté client n'est ajoutée que là où c'est nécessaire
  • ✅ Les interfaces TypeScript sont définies pour les props des composants
  • ✅ Les images sont optimisées à l'aide du composant Image d'Astro
  • ✅ Le site s'exécute correctement avec npm run dev

Skills associés