Communitygithub.com

Anhvu1107/all-agent-skill

Úsalo SIEMPRE cuando la solicitud coincida con Astro: Crea sitios web centrados en contenido con Astro — cero JS por defecto, arquitectura de islas, componentes multi-framework y soporte para Markdown/MDX.

¿Qué es all-agent-skill?

Esta habilidad proporciona una guía completa para construir sitios web ricos en contenido utilizando el framework Astro. Está diseñada para desarrolladores y agentes de IA que necesitan crear blogs, sitios de documentación, portafolios o sitios de marketing con un rendimiento excepcional y una huella mínima de JavaScript. La habilidad cubre desde la configuración inicial del proyecto y la sintaxis de componentes `.astro` hasta temas avanzados como colecciones de contenido, hidratación selectiva de islas y modos SSR. Soporta múltiples plataformas, incluyendo React, Vue, Svelte y Solid, dentro del mismo proyecto. Incluye ejemplos prácticos, mejores prácticas de rendimiento, notas de seguridad y solución de problemas comunes, lo que la convierte en un recurso valioso tanto para principiantes como para usuarios experimentados de Astro.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Anhvu1107/all-agent-skill/tree/HEAD/.agent/skills/astro

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Framework Web Astro

Regla de Lectura Selectiva

Comienza con:

  • references/senior-master-standard.md
  • references/usage-routing.md
  • references/quality-checklist.md

Luego carga solo los documentos heredados, scripts, activos o ejemplos que coincidan con la tarea real del usuario.

Resumen

Astro es un framework web diseñado para sitios web ricos en contenido: blogs, documentación, portafolios, sitios de marketing y comercio electrónico. Su innovación principal es la Arquitectura de Islas: por defecto, Astro envía cero JavaScript al navegador. Los componentes interactivos se hidratan selectivamente como "islas" aisladas. Astro soporta React, Vue, Svelte, Solid y otros frameworks de UI simultáneamente en el mismo proyecto, permitiéndote elegir la herramienta adecuada para cada componente.

Cuándo Usar Esta Habilidad

  • Úsala al construir un blog, sitio de documentación, página de marketing o portafolio
  • Úsala cuando el rendimiento y las Core Web Vitals sean la máxima prioridad
  • Úsala cuando el proyecto tenga mucho contenido con archivos Markdown o MDX
  • Úsala cuando quieras una salida SSG (estática) con SSR opcional para rutas dinámicas
  • Úsala cuando el usuario pregunte sobre archivos .astro, Astro.props, colecciones de contenido o directivas client:

Cómo Funciona

Paso 1: Configuración del Proyecto

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

Añade integraciones según sea necesario:

npx astro add tailwind        # Tailwind CSS
npx astro add react           # Soporte para componentes React
npx astro add mdx             # Soporte para MDX
npx astro add sitemap         # sitemap.xml automático
npx astro add vercel          # Adaptador SSR para Vercel

Estructura del proyecto:

src/
  pages/          ← Enrutamiento basado en archivos (.astro, .md, .mdx)
  layouts/        ← Plantillas de página reutilizables
  components/     ← Componentes de UI (.astro, .tsx, .vue, etc.)
  content/        ← Colecciones de contenido con tipo seguro (Markdown/MDX)
  styles/         ← CSS global
public/           ← Activos estáticos (se copian tal cual)
astro.config.mjs  ← Configuración del framework

Paso 2: Sintaxis de Componentes Astro

Los archivos .astro tienen un bloque de código en la parte superior (solo servidor) y una plantilla debajo:

---
// src/components/Card.astro
// Este bloque se ejecuta SOLO en el servidor — nunca en el navegador
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>
  /* Se aplica automáticamente a este componente */
  .card { border: 1px solid #eee; padding: 1rem; }
</style>

Paso 3: Páginas y Enrutamiento Basado en Archivos

src/pages/index.astro          → /
src/pages/about.astro          → /about
src/pages/blog/[slug].astro    → /blog/:slug (dinámico)
src/pages/blog/[...path].astro → /blog/* (comodín)

Ruta dinámica con 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 />

Paso 4: Colecciones de Contenido

Las colecciones de contenido te dan acceso con tipo seguro a archivos Markdown y 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>

Paso 5: Islas — Hidratación Selectiva

Por defecto, los componentes del framework de UI se renderizan como HTML estático sin JS. Usa directivas client: para hidratar:

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

<!-- HTML estático — no se envía JavaScript al navegador -->
<Counter initialCount={0} />

<!-- Hidrata inmediatamente al cargar la página -->
<Counter initialCount={0} client:load />

<!-- Hidrata cuando el componente se desplaza a la vista -->
<VideoPlayer src="/demo.mp4" client:visible />

<!-- Hidrata solo cuando el navegador está inactivo -->
<Analytics client:idle />

<!-- Hidrata solo con una consulta de medios específica -->
<MobileMenu client:media="(max-width: 768px)" />

Paso 6: Diseños (Layouts)

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

<html lang="en">
  <head>
    <meta charset="utf-8" />
    <title>{title}</title>
    <meta name="description" content={description} />
  </head>
  <body>
    <nav>...</nav>
    <main>
      <slot />  <!-- el contenido de la página se renderiza aquí -->
    </main>
    <footer>...</footer>
  </body>
</html>
---
// src/pages/about.astro
import BaseLayout from '../layouts/BaseLayout.astro';
---

<BaseLayout title="About Us">
  <h1>Acerca de Nosotros</h1>
  <p>Bienvenido a nuestra empresa...</p>
</BaseLayout>

Paso 7: Modo SSR (Renderizado Bajo Demanda)

Habilita SSR para páginas dinámicas configurando un adaptador:

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

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

Opta por páginas individuales para SSR con export const prerender = false.

Ejemplos

Ejemplo 1: Blog con Feed 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: 'My Blog',
    description: 'Latest posts',
    site: context.site,
    items: posts.map(post => ({
      title: post.data.title,
      pubDate: post.data.date,
      link: `/blog/${post.slug}/`,
    })),
  });
}

Ejemplo 2: Endpoint de 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 required' }), {
      status: 400,
      headers: { 'Content-Type': 'application/json' },
    });
  }

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

Ejemplo 3: Componente React como Isla

// 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">Search</button>
      <ul>{results.map(r => <li key={r.id}>{r.title}</li>)}</ul>
    </form>
  );
}
---
import SearchBox from '../components/SearchBox.tsx';
---
<!-- Hidratada inmediatamente — esta isla es interactiva -->
<SearchBox client:load />

Mejores Prácticas

  • ✅ Mantén la mayoría de los componentes como archivos .astro estáticos — hidrata solo lo que debe ser interactivo
  • ✅ Usa colecciones de contenido para todo el contenido Markdown/MDX — obtienes tipo seguro y validación automática
  • ✅ Prefiere client:visible sobre client:load para componentes debajo del pliegue para reducir el JS inicial
  • ✅ Usa import.meta.env para variables de entorno — prefija las variables públicas con PUBLIC_
  • ✅ Añade <ViewTransitions /> de astro:transitions para una navegación suave entre páginas sin una SPA completa
  • ❌ No uses client:load en cada componente — esto anula la ventaja de rendimiento de Astro
  • ❌ No pongas secretos en el frontmatter de .astro que se use en plantillas del lado del cliente
  • ❌ No omitas getStaticPaths para rutas dinámicas en modo estático — las compilaciones fallarán

Notas de Seguridad

  • El código del frontmatter en archivos .astro se ejecuta solo del lado del servidor y nunca se expone al navegador.
  • Usa import.meta.env.PUBLIC_* solo para valores no sensibles. Las variables de entorno privadas (sin prefijo PUBLIC_) nunca se envían al cliente.
  • Al usar el modo SSR, valida todas las entradas de Astro.request antes de las consultas a bases de datos o llamadas a la API.
  • Desinfecta cualquier contenido proporcionado por el usuario antes de renderizarlo con set:html — evita el escape automático.

Errores Comunes

  • Problema: El JavaScript de un componente React/Vue no se ejecuta en el navegador Solución: Añade una directiva client: (client:load, client:visible, etc.) — sin ella, los componentes se renderizan solo como HTML estático.

  • Problema: Los datos de getStaticPaths están obsoletos después de actualizaciones de contenido durante el desarrollo Solución: El servidor de desarrollo de Astro vigila los archivos de contenido — reinicia si los cambios en content/config.ts no se reflejan.

  • Problema: El tipo de Astro.props es any — sin autocompletado Solución: Define una interfaz o tipo Props en el frontmatter y Astro lo inferirá automáticamente.

  • Problema: El CSS de un componente .astro se filtra a otros componentes Solución: Los estilos en las etiquetas <style> de .astro se aplican automáticamente. Usa :global() solo cuando quieras apuntar intencionalmente a los hijos.

Habilidades Relacionadas

  • @sveltekit — Cuando necesitas un framework full-stack con UI reactiva (frente al enfoque en contenido de Astro)
  • @nextjs-app-router-patterns — Cuando necesitas un framework full-stack con React como prioridad
  • @tailwind-patterns — Diseñar sitios Astro con Tailwind CSS
  • @progressive-web-app — Añadir capacidades PWA a un sitio Astro

Limitaciones

  • Usa esta habilidad solo cuando la tarea coincida claramente con el alcance descrito anteriormente.
  • No trates la salida como un sustituto de la validación, pruebas o revisión de expertos específica del entorno.
  • Detente y pide aclaraciones si faltan entradas requeridas, permisos, límites de seguridad o criterios de éxito.

Individual skills in this repo

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

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches 007: Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Agentfolio: Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Animejs Animation: Advanced JavaScript animation library skill for creating complex, high-performance web animations.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Astropy: Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Emotional ARC Designer: One sentence - what this skill does and when to invoke it

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Fixing Motion Performance: Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches I18n Localization: Internationalization and localization patterns.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Interactive Portfolio: Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches JQ: Expert jq usage for JSON querying, filtering, transformation, and pipeline integration.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Landing Page Generator: Generates high-converting Next.js/React landing pages with Tailwind CSS.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches LEX: Centralized ''Truth Engine'' for cross-jurisdictional legal context (US, EU, CA) and contract scaffolding.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Magic Animator: AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Makepad Animation: CRITICAL: Use for Makepad animation system.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Nextjs APP Router Patterns: Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

Anhvu1107/all-agent-skill

ALWAYS use this when the user mentions Nextjs Best Practices, asks to build, debug, review, document, automate, test, configure, migrate, or make decisions in this domain, or the task clearly depends on Nextjs Best Practices; scope: Next.js App Router principles. Apply the bundled workflow, references, scripts, Senior Master standard, and Codex strict review gate before final output.

Anhvu1107/all-agent-skill

description: ALWAYS use this when the work is specifically about modern Next.js or React architecture, data flow, rendering strategy, routing, or performance-sensitive frontend behavior.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Nextjs Supabase Auth: Expert integration of Supabase Auth with Next.js App Router

Anhvu1107/all-agent-skill

ALWAYS use this when the task involves reading, extracting, splitting, merging, rotating, creating, validating, OCR-ing, form-filling, or otherwise producing or modifying PDF files.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches React Nextjs Development: React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

Anhvu1107/all-agent-skill

ALWAYS use this when working with Remotion code, video compositions, rendering logic, timing, media assets, or React-based motion workflows.

Skills relacionados