Communitygithub.com

ASoudy/AGS

Créez des sites web centrés sur le contenu avec Astro — zéro JavaScript par défaut, architecture en îles, composants multi-frameworks et support Markdown/MDX.

Qu'est-ce que AGS ?

Astro est un framework web conçu pour les sites riches en contenu — blogs, documentations, portfolios, sites marketing et e-commerce. Son innovation centrale est l'architecture en îles : par défaut, Astro n'envoie aucun JavaScript au navigateur ; les composants interactifs sont hydratés de manière sélective sous forme d'îlots isolés. Il prend en charge React, Vue, Svelte, Solid et d'autres frameworks UI simultanément dans le même projet, vous permettant de choisir l'outil approprié pour chaque composant. Cette compétence (ASoudy/AGS) vous guide à travers la configuration du projet, la syntaxe des composants Astro, le routage basé sur les fichiers, les collections de contenu (Markdown/MDX), les directives client:directives pour l'hydratation sélective, les layouts, et le mode SSR avec adaptateurs (comme Vercel). Elle est idéale pour les projets où la performance et les Core Web Vitals sont prioritaires, et où l'on souhaite une sortie statique (SSG) avec possibilité de rendu dynamique (SSR).

Compatible avec✓Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/AGAS/plugins/antigravity-awesome-skills-claude/skills/astro

Demander à votre IA préférée

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

Documentation

Framework Web Astro

Vue d'ensemble

Astro est un framework web conçu pour les sites riches en contenu — blogs, documentations, portfolios, sites marketing et e-commerce. Son innovation centrale est l'architecture en îles : par défaut, Astro n'envoie aucun JavaScript au navigateur. Les composants interactifs sont hydratés de manière sélective sous forme d'îles isolées. Astro prend en charge React, Vue, Svelte, Solid et d'autres frameworks UI simultanément dans le même projet, vous permettant de choisir l'outil approprié pour chaque composant.

Quand utiliser cette compétence

  • Utilisez-la lors de la création d'un blog, d'un site de documentation, d'une page marketing ou d'un portfolio
  • Utilisez-la lorsque la performance et les Core Web Vitals sont la priorité absolue
  • Utilisez-la lorsque le projet est riche en contenu avec des fichiers Markdown ou MDX
  • Utilisez-la lorsque vous souhaitez une sortie SSG (statique) avec un SSR optionnel pour les routes dynamiques
  • Utilisez-la lorsque l'utilisateur pose des questions sur les fichiers .astro, Astro.props, les collections de contenu ou les directives client:

Comment ça fonctionne

Étape 1 : Configuration du projet

npm create astro@latest my-site
cd my-site
npm install
npm run dev

Ajoutez les intégrations selon les besoins :

npx astro add tailwind        # Tailwind CSS
npx astro add react           # Support des composants React
npx astro add mdx             # Support MDX
npx astro add sitemap         # sitemap.xml automatique
npx astro add vercel          # Adaptateur SSR Vercel

Structure du projet :

src/
  pages/          ← Routage basé sur les fichiers (.astro, .md, .mdx)
  layouts/        ← Coques de page réutilisables
  components/     ← Composants UI (.astro, .tsx, .vue, etc.)
  content/        ← Collections de contenu type-safe (Markdown/MDX)
  styles/         ← CSS global
public/           ← Actifs statiques (copiés tels quels)
astro.config.mjs  ← Configuration du framework

Étape 2 : Syntaxe des composants Astro

Les fichiers .astro ont une clôture de code en haut (côté serveur uniquement) et un modèle en dessous :

---
// src/components/Card.astro
// Ce bloc s'exécute UNIQUEMENT sur le serveur — jamais dans le navigateur
interface Props {
  title: string;
  href: string;
  description: string;
}

const { title, href, description } = Astro.props;
---

<article class="card">
  <h2><a href={href}>{title}</a></h2>
  <p>{description}</p>
</article>

<style>
  /* Scopé automatiquement à ce composant */
  .card { border: 1px solid #eee; padding: 1rem; }
</style>

Étape 3 : Pages basées sur les fichiers et routage

src/pages/index.astro          → /
src/pages/about.astro          → /about
src/pages/blog/[slug].astro    → /blog/:slug (dynamique)
src/pages/blog/[...path].astro → /blog/* (tout capturer)

Route dynamique avec getStaticPaths :

---
// src/pages/blog/[slug].astro
export async function getStaticPaths() {
  const posts = await getCollection('blog');
  return posts.map(post => ({
    params: { slug: post.slug },
    props: { post },
  }));
}

const { post } = Astro.props;
const { Content } = await post.render();
---

<h1>{post.data.title}</h1>
<Content />

Étape 4 : Collections de contenu

Les collections de contenu vous offrent un accès type-safe aux fichiers Markdown et MDX :

// src/content/config.ts
import { z, defineCollection } from 'astro:content';

const blog = defineCollection({
  type: 'content',
  schema: z.object({
    title: z.string(),
    date: z.coerce.date(),
    tags: z.array(z.string()).default([]),
    draft: z.boolean().default(false),
  }),
});

export const collections = { blog };
---
// src/pages/blog/index.astro
import { getCollection } from 'astro:content';

const posts = (await getCollection('blog'))
  .filter(p => !p.data.draft)
  .sort((a, b) => b.data.date.valueOf() - a.data.date.valueOf());
---

<ul>
  {posts.map(post => (
    <li>
      <a href={`/blog/${post.slug}`}>{post.data.title}</a>
      <time>{post.data.date.toLocaleDateString()}</time>
    </li>
  ))}
</ul>

Étape 5 : Îles — Hydratation sélective

Par défaut, les composants du framework UI sont rendus en HTML statique sans JavaScript. Utilisez les directives client: pour hydrater :

---
import Counter from '../components/Counter.tsx';  // Composant React
import VideoPlayer from '../components/VideoPlayer.svelte';
---

<!-- HTML statique — aucun JavaScript envoyé au navigateur -->
<Counter initialCount={0} />

<!-- Hydrate immédiatement au chargement de la page -->
<Counter initialCount={0} client:load />

<!-- Hydrate lorsque le composant défile dans la vue -->
<VideoPlayer src="/demo.mp4" client:visible />

<!-- Hydrate uniquement lorsque le navigateur est inactif -->
<Analytics client:idle />

<!-- Hydrate uniquement sur une requête média spécifique -->
<MobileMenu client:media="(max-width: 768px)" />

Étape 6 : Layouts

---
// src/layouts/BaseLayout.astro
interface Props {
  title: string;
  description?: string;
}
const { title, description = 'My Astro Site' } = Astro.props;
---

<html lang="fr">
  <head>
    <meta charset="utf-8" />
    <title>{title}</title>
    <meta name="description" content={description} />
  </head>
  <body>
    <nav>...</nav>
    <main>
      <slot />  <!-- le contenu de la page s'affiche ici -->
    </main>
    <footer>...</footer>
  </body>
</html>
---
// src/pages/about.astro
import BaseLayout from '../layouts/BaseLayout.astro';
---

<BaseLayout title="À propos">
  <h1>À propos de nous</h1>
  <p>Bienvenue dans notre entreprise...</p>
</BaseLayout>

Étape 7 : Mode SSR (Rendu à la demande)

Activez le SSR pour les pages dynamiques en définissant un adaptateur :

// astro.config.mjs
import { defineConfig } from 'astro/config';
import vercel from '@astrojs/vercel/serverless';

export default defineConfig({
  output: 'hybrid',  // 'static' | 'server' | 'hybrid'
  adapter: vercel(),
});

Optez pour des pages individuelles dans le SSR avec export const prerender = false.

Exemples

Exemple 1 : Blog avec flux RSS

// src/pages/rss.xml.ts
import rss from '@astrojs/rss';
import { getCollection } from 'astro:content';

export async function GET(context) {
  const posts = await getCollection('blog');
  return rss({
    title: 'Mon Blog',
    description: 'Derniers articles',
    site: context.site,
    items: posts.map(post => ({
      title: post.data.title,
      pubDate: post.data.date,
      link: `/blog/${post.slug}/`,
    })),
  });
}

Exemple 2 : Point de terminaison API (SSR)

// src/pages/api/subscribe.ts
import type { APIRoute } from 'astro';

export const POST: APIRoute = async ({ request }) => {
  const { email } = await request.json();

  if (!email) {
    return new Response(JSON.stringify({ error: 'Email requis' }), {
      status: 400,
      headers: { 'Content-Type': 'application/json' },
    });
  }

  await addToNewsletter(email);
  return new Response(JSON.stringify({ success: true }), { status: 200 });
};

Exemple 3 : Composant React comme île

// src/components/SearchBox.tsx
import { useState } from 'react';

export default function SearchBox() {
  const [query, setQuery] = useState('');
  const [results, setResults] = useState([]);

  async function search(e: React.FormEvent) {
    e.preventDefault();
    const data = await fetch(`/api/search?q=${query}`).then(r => r.json());
    setResults(data);
  }

  return (
    <form onSubmit={search}>
      <input value={query} onChange={e => setQuery(e.target.value)} />
      <button type="submit">Rechercher</button>
      <ul>{results.map(r => <li key={r.id}>{r.title}</li>)}</ul>
    </form>
  );
}
---
import SearchBox from '../components/SearchBox.tsx';
---
<!-- Hydraté immédiatement — cette île est interactive -->
<SearchBox client:load />

Meilleures pratiques

  • ✅ Gardez la plupart des composants sous forme de fichiers .astro statiques — hydratez uniquement ce qui doit être interactif
  • ✅ Utilisez les collections de contenu pour tout le contenu Markdown/MDX — vous bénéficiez de la sécurité des types et de la validation automatique
  • ✅ Préférez client:visible à client:load pour les composants situés en dessous de la ligne de flottaison afin de réduire le JavaScript initial
  • ✅ Utilisez import.meta.env pour les variables d'environnement — préfixez les variables publiques avec PUBLIC_
  • ✅ Ajoutez <ViewTransitions /> de astro:transitions pour une navigation fluide entre les pages sans SPA complet
  • ❌ N'utilisez pas client:load sur tous les composants — cela annule l'avantage de performance d'Astro
  • ❌ Ne mettez pas de secrets dans le frontmatter .astro qui sont utilisés dans les modèles côté client
  • ❌ N'oubliez pas getStaticPaths pour les routes dynamiques en mode statique — les builds échoueront

Notes de sécurité et de sûreté

  • Le code de frontmatter dans les fichiers .astro s'exécute uniquement côté serveur et n'est jamais exposé au navigateur.
  • Utilisez import.meta.env.PUBLIC_* uniquement pour les valeurs non sensibles. Les variables d'environnement privées (sans le préfixe PUBLIC_) ne sont jamais envoyées au client.
  • Lorsque vous utilisez le mode SSR, validez toutes les entrées de Astro.request avant les requêtes de base de données ou les appels API.
  • Nettoyez tout contenu fourni par l'utilisateur avant de le rendre avec set:html — cela contourne l'auto-échappement.

Pièges courants

  • Problème : Le JavaScript d'un composant React/Vue ne s'exécute pas dans le navigateur Solution : Ajoutez une directive client: (client:load, client:visible, etc.) — sans elle, les composants sont rendus uniquement en HTML statique.

  • Problème : Les données de getStaticPaths sont obsolètes après les mises à jour de contenu pendant le développement Solution : Le serveur de développement d'Astro surveille les fichiers de contenu — redémarrez si les modifications dans content/config.ts ne sont pas répercutées.

  • Problème : Le type de Astro.props est any — pas d'autocomplétion Solution : Définissez une interface Props ou un type dans le frontmatter et Astro l'inférera automatiquement.

  • Problème : Le CSS d'un composant .astro déborde sur d'autres composants Solution : Les styles dans les balises <style> de .astro sont automatiquement scopés. Utilisez :global() uniquement lorsque vous ciblez intentionnellement les enfants.

Compétences connexes

  • @sveltekit — Lorsque vous avez besoin d'un framework full-stack avec une UI réactive (vs l'axe contenu d'Astro)
  • @nextjs-app-router-patterns — Lorsque vous avez besoin d'un framework full-stack axé React
  • @tailwind-patterns — Styliser les sites Astro avec Tailwind CSS
  • @progressive-web-app — Ajouter des capacités PWA à un site Astro

Limitations

  • Utilisez cette compétence uniquement lorsque la tâche correspond clairement au champ décrit ci-dessus.
  • Ne considérez pas le résultat comme un substitut à une validation, un test ou une révision d'expert spécifique à l'environnement.
  • Arrêtez-vous et demandez des clarifications si les entrées requises, les autorisations, les limites de sécurité ou les critères de succès sont manquants.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ASoudy/AGS

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

One sentence - what this skill does and when to invoke it

ASoudy/AGS

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

ASoudy/AGS

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

ASoudy/AGS

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

ASoudy/AGS

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

ASoudy/AGS

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

ASoudy/AGS

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

ASoudy/AGS

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

ASoudy/AGS

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

ASoudy/AGS

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Skills associés