Skills

Qué son las skills

supastack incluye Agent Skills: instrucciones cortas y centradas en tareas que tu agente de código carga cuando un trabajo coincide. En lugar de adivinar las convenciones del kit en cada prompt, el agente sigue los mismos pasos para funciones, pagos, cambios de base de datos y tests. Las skills siguen el formato abierto Agent Skills, así que funcionan en Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI y otros agentes compatibles.

Dónde viven las skills

Las skills viven en .agents/skills/, una carpeta por skill con un SKILL.md dentro. Hay copias idénticas en .claude/skills/ para Claude Code.

Qué agentes las leen

Codex, Cursor, GitHub Copilot, Gemini CLI y OpenCode leen .agents/skills/. Claude Code lee .claude/skills/. Tu agente elige una skill automáticamente cuando tu petición coincide con su descripción, o puedes nombrarla — di «use the database-schema-change skill».

Qué repositorios las incluyen

El repositorio all-platforms incluye todas las skills. Los repositorios web, mobile y desktop incluyen las skills que les corresponden; las skills de pruebas de extremo a extremo y de CI solo se incluyen con el repositorio all-platforms.

Configuración y entorno

Skills para poner el kit en marcha, desplegarlo y configurarlo.

• Configuración del entorno local (local-environment-setup) — al preparar o reparar el entorno local: primer clon, un .env ausente o roto, Postgres, migraciones o puertos.
• Despliegue y variables de entorno (deploy-and-env-vars) — al desplegar, elegir un destino de hosting o añadir o cambiar una variable de entorno.
• Añadir una dependencia (adding-a-dependency) — al añadir, actualizar, mover o quitar una dependencia npm, o cuando CI falla la comprobación de licencias o auditoría.
• Actualizar desde upstream (upgrading-from-upstream) — al traer una versión más reciente de supastack a un producto construido sobre ella.

Construir funciones

Skills para añadir superficie de producto en cada plataforma.

• Añadir una función web (add-a-web-feature) — para una página o sección de producto con sus datos, server actions, navegación y tests.
• Añadir un endpoint de API (add-an-api-endpoint) — al añadir o cambiar un endpoint público /api/v1, su documentación OpenAPI o los scopes de API key.
• Añadir un componente de UI (add-a-ui-component) — para una sección, bloque, control de formulario o componente reutilizable que siga las reglas de estilo del kit.
• Cambiar el tema o el estilo (change-the-theme-or-style) — al cambiar el aspecto del producto: estilo de diseño, pack de color, densidad, radio, fuente o layout.
• Añadir una página de marketing o post (add-a-marketing-page-or-blog-post) — al añadir o editar una página pública, página de precios, página legal, post de blog o guía de documentación.
• Añadir una pantalla móvil (add-a-mobile-screen) — al añadir o cambiar una pantalla en la app móvil Expo.
• Añadir una capacidad de escritorio (add-a-desktop-capability) — al cambiar la app de escritorio Tauri: ventana, bandeja, atajo global o actualizaciones automáticas.
• Añadir una notificación (add-a-notification) — para una notificación in-app, notificación push o un elemento del digest.

Auth y pagos

Skills para inicio de sesión, facturación y planes.

• Añadir un método de auth (add-an-auth-method) — al cambiar el inicio de sesión: proveedores sociales, magic links, códigos por email, passkeys o dos factores.
• Añadir un proveedor de pago (add-a-payment-provider) — al activar un proveedor de facturación o escribir un nuevo adaptador con checkout, portal de cliente y webhooks.
• Cambiar planes y precios (change-plans-and-pricing) — al añadir, renombrar o cambiar el precio de un plan: precios, pruebas, seats, entitlements, límites de uso o créditos.

Datos e integraciones

Skills para el esquema, la IA, los jobs, el email, el storage y las traducciones.

• Cambio de esquema de base de datos (database-schema-change) — al añadir o cambiar una tabla, columna, índice o relación y generar la migración.
• Añadir una función de IA (add-an-ai-feature) — para una llamada a modelo, una herramienta de chat o agente, una tarea de IA durable, presupuestos o bring-your-own-key.
• Añadir un job en segundo plano (add-a-background-job) — para trabajo que corre después de una petición, con temporizador o por workspace.
• Añadir o editar un email (add-or-edit-an-email) — al añadir o cambiar un email transaccional o cambiar el proveedor que lo entrega.
• Usar almacenamiento de archivos (use-file-storage) — para subidas o archivos guardados como avatares, logos o adjuntos.
• Añadir traducciones (add-translations) — al añadir o cambiar texto visible para el usuario, traducirlo o añadir un locale.

Calidad y entrega

Skills para tests, verificación, revisiones y CI.

• Escribir tests unitarios (writing-unit-tests) — al escribir o arreglar tests unitarios o de integración con Vitest.
• Escribir tests e2e (writing-e2e-tests) — al añadir o arreglar tests end-to-end de Playwright, en local o en CI.
• Verificar cambios (verify-changes) — antes de entregar, commitear o abrir un pull request, para elegir y ejecutar los checks correctos.
• Depurar un run de CI fallido (debugging-a-failing-ci-run) — cuando un run de GitHub Actions falla y tienes que encontrar y arreglar la causa.
• Revisar un PR (reviewing-a-pr) — al revisar un pull request o diff en busca de corrección, aislamiento de workspace y convenciones.

Añade las tuyas

Añade una carpeta cuyo nombre coincida con el name de su frontmatter, con un name y una description que digan cuándo usarla. Cópiala también a .claude/skills/ para que todos los agentes la encuentren.