Communitygithub.com

Anhvu1107/all-agent-skill

SEMPRE use esta skill quando a solicitação corresponder ao Astro: Crie sites focados em conteúdo com Astro — zero JavaScript por padrão, arquitetura de ilhas, componentes multi-framework e suporte a Markdown/MDX.

O que é all-agent-skill?

Esta skill capacita assistentes de IA (como Claude Code, Cursor ou Codex) a construir e gerenciar sites focados em conteúdo usando o framework web Astro. O Astro é conhecido por sua arquitetura inovadora de Ilhas, que envia zero JavaScript ao navegador por padrão, hidratando seletivamente componentes interativos conforme necessário. A skill cobre todo o fluxo de trabalho de desenvolvimento: configuração do projeto com `npm create astro@latest`, uso de arquivos `.astro` com sintaxe de cerca de código, implementação de roteamento baseado em arquivos (incluindo rotas dinâmicas e dinâmicas com `getStaticPaths`), criação de coleções de conteúdo com tipagem segura usando `astro:content`, e aplicação de hidratação seletiva com diretivas `client:`. Ela também aborda layouts, suporte multi-framework (React, Vue, Svelte, Solid), modo SSR com adaptadores como Vercel e práticas recomendadas de otimização de desempenho. O guia prático inclui exemplos completos de blog com feed RSS, endpoints de API e componentes React como ilhas interativas, bem como segurança, armadilhas comuns e soluções. O documento é estruturado em etapas claras e inclui seções de visão geral, quando usar, como funciona, exemplos, melhores práticas, notas de segurança, armadilhas comuns e limitações, garantindo que o assistente de IA possa executar tarefas complexas de desenvolvimento web com precisão.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Framework Web Astro

Regra de Leitura Seletiva

Comece com:

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

Em seguida, carregue apenas os documentos, scripts, assets ou exemplos herdados que correspondam à tarefa real do usuário.

Visão Geral

Astro é um framework web projetado para sites ricos em conteúdo — blogs, documentações, portfólios, sites de marketing e e-commerce. Sua inovação principal é a Arquitetura de Ilhas: por padrão, o Astro envia zero JavaScript para o navegador. Componentes interativos são hidratados seletivamente como "ilhas" isoladas. O Astro suporta React, Vue, Svelte, Solid e outros frameworks de UI simultaneamente no mesmo projeto, permitindo que você escolha a ferramenta certa para cada componente.

Quando Usar Esta Skill

  • Use ao construir um blog, site de documentação, página de marketing ou portfólio
  • Use quando desempenho e Core Web Vitals forem a prioridade máxima
  • Use quando o projeto for pesado em conteúdo com arquivos Markdown ou MDX
  • Use quando você quiser saída SSG (estática) com SSR opcional para rotas dinâmicas
  • Use quando o usuário perguntar sobre arquivos .astro, Astro.props, coleções de conteúdo ou diretivas client:

Como Funciona

Passo 1: Configuração do Projeto

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

Adicione integrações conforme necessário:

npx astro add tailwind        # Tailwind CSS
npx astro add react           # Suporte a componente React
npx astro add mdx             # Suporte a MDX
npx astro add sitemap         # Sitemap.xml automático
npx astro add vercel          # Adaptador SSR Vercel

Estrutura do projeto:

src/
  pages/          ← Roteamento baseado em arquivos (.astro, .md, .mdx)
  layouts/        ← Estruturas de página reutilizáveis
  components/     ← Componentes de UI (.astro, .tsx, .vue, etc.)
  content/        ← Coleções de conteúdo com tipagem segura (Markdown/MDX)
  styles/         ← CSS global
public/           ← Assets estáticos (copiados como estão)
astro.config.mjs ← Configuração do framework

Passo 2: Sintaxe de Componente Astro

Arquivos .astro têm uma cerca de código no topo (somente servidor) e um template abaixo:

---
// src/components/Card.astro
// Este bloco executa APENAS no servidor — nunca no 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>
  /* Escopo automático para este componente */
  .card { border: 1px solid #eee; padding: 1rem; }
</style>

Passo 3: Páginas e Roteamento Baseado em Arquivos

src/pages/index.astro          → /
src/pages/about.astro          → /about
src/pages/blog/[slug].astro    → /blog/:slug (dinâmica)
src/pages/blog/[...path].astro → /blog/* (coringa)

Rota dinâmica com 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 />

Passo 4: Coleções de Conteúdo

Coleções de conteúdo fornecem acesso com tipagem segura a arquivos Markdown e 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>

Passo 5: Ilhas — Hidratação Seletiva

Por padrão, componentes de frameworks de UI renderizam como HTML estático sem JS. Use diretivas client: para hidratar:

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

<!-- HTML estático — nenhum JavaScript enviado ao navegador -->
<Counter initialCount={0} />

<!-- Hidrata imediatamente ao carregar a página -->
<Counter initialCount={0} client:load />

<!-- Hidrata quando o componente entra na viewport -->
<VideoPlayer src="/demo.mp4" client:visible />

<!-- Hidrata apenas quando o navegador está ocioso -->
<Analytics client:idle />

<!-- Hidrata apenas em uma media query específica -->
<MobileMenu client:media="(max-width: 768px)" />

Passo 6: Layouts

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

<html lang="pt-BR">
  <head>
    <meta charset="utf-8" />
    <title>{title}</title>
    <meta name="description" content={description} />
  </head>
  <body>
    <nav>...</nav>
    <main>
      <slot />  <!-- o conteúdo da página é renderizado aqui -->
    </main>
    <footer>...</footer>
  </body>
</html>
---
// src/pages/about.astro
import BaseLayout from '../layouts/BaseLayout.astro';
---

<BaseLayout title="Sobre Nós">
  <h1>Sobre Nós</h1>
  <p>Bem-vindo à nossa empresa...</p>
</BaseLayout>

Passo 7: Modo SSR (Renderização Sob Demanda)

Ative o SSR para páginas dinâmicas configurando um 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(),
});

Opte por páginas individuais no SSR com export const prerender = false.

Exemplos

Exemplo 1: Blog com 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: 'Meu Blog',
    description: 'Últimos posts',
    site: context.site,
    items: posts.map(post => ({
      title: post.data.title,
      pubDate: post.data.date,
      link: `/blog/${post.slug}/`,
    })),
  });
}

Exemplo 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 obrigatório' }), {
      status: 400,
      headers: { 'Content-Type': 'application/json' },
    });
  }

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

Exemplo 3: Componente React como Ilha

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

Melhores Práticas

  • ✅ Mantenha a maioria dos componentes como arquivos .astro estáticos — hidrate apenas o que deve ser interativo
  • ✅ Use coleções de conteúdo para todo o conteúdo Markdown/MDX — você ganha tipagem segura e validação automática
  • ✅ Prefira client:visible em vez de client:load para componentes abaixo da dobra para reduzir o JS inicial
  • ✅ Use import.meta.env para variáveis de ambiente — prefixe variáveis públicas com PUBLIC_
  • ✅ Adicione <ViewTransitions /> de astro:transitions para navegação suave entre páginas sem um SPA completo
  • ❌ Não use client:load em todos os componentes — isso anula a vantagem de desempenho do Astro
  • ❌ Não coloque segredos no frontmatter de .astro que sejam usados em templates voltados ao cliente
  • ❌ Não ignore getStaticPaths para rotas dinâmicas no modo estático — as builds falharão

Notas de Segurança e Segurança

  • O código do frontmatter em arquivos .astro é executado apenas no lado do servidor e nunca é exposto ao navegador.
  • Use import.meta.env.PUBLIC_* apenas para valores não sensíveis. Variáveis de ambiente privadas (sem prefixo PUBLIC_) nunca são enviadas ao cliente.
  • Ao usar o modo SSR, valide todas as entradas Astro.request antes de consultas ao banco de dados ou chamadas de API.
  • Sanitize qualquer conteúdo fornecido pelo usuário antes de renderizar com set:html — ele ignora o escape automático.

Armadilhas Comuns

  • Problema: O JavaScript de um componente React/Vue não é executado no navegador Solução: Adicione uma diretiva client: (client:load, client:visible, etc.) — sem ela, os componentes renderizam apenas como HTML estático.

  • Problema: Os dados de getStaticPaths ficam desatualizados após atualizações de conteúdo durante o desenvolvimento Solução: O servidor de desenvolvimento do Astro observa arquivos de conteúdo — reinicie se as alterações em content/config.ts não forem refletidas.

  • Problema: O tipo Astro.props é any — sem autocomplete Solução: Defina uma interface ou tipo Props no frontmatter e o Astro irá inferi-lo automaticamente.

  • Problema: O CSS de um componente .astro vaza para outros componentes Solução: Estilos em tags <style> de .astro têm escopo automático. Use :global() apenas quando quiser atingir intencionalmente filhos.

Skills Relacionadas

  • @sveltekit — Quando você precisa de um framework full-stack com UI reativa (em vez do foco em conteúdo do Astro)
  • @nextjs-app-router-patterns — Quando você precisa de um framework full-stack com foco em React
  • @tailwind-patterns — Estilizando sites Astro com Tailwind CSS
  • @progressive-web-app — Adicionando capacidades PWA a um site Astro

Limitações

  • Use esta skill apenas quando a tarefa corresponder claramente ao escopo descrito acima.
  • Não trate a saída como substituta para validação específica de ambiente, testes ou revisão técnica.
  • Pare e peça esclarecimentos se entradas, permissões, limites de segurança ou critérios de sucesso necessários estiverem faltando.

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.

Habilidades Relacionadas