name: makerkit-docs description: > Consulta la documentación oficial de MakerKit (next-supabase-turbo) bajo demanda. Usa cuando necesites información sobre patrones, configuración o APIs de MakerKit que no esté en el código local. Incluye índice completo de 150 páginas. allowed-tools: WebFetch, Read

MakerKit Documentation Access

Anuncio

"Consultando documentación oficial de MakerKit para [tema]."

Cuándo Usar

• Cuando necesites saber "cómo hace MakerKit X"
• Cuando encuentres código que no entiendes y el CLAUDE.md local no ayuda
• Cuando planifiques una feature y quieras validar el approach oficial
• Cuando el MCP no tenga la información (patrones conceptuales vs código)
• Cuando configures billing, auth, emails, o features complejas

Cuándo NO Usar

• Para introspección de código local (usar MCP)
• Para ver qué componentes existen en el proyecto (usar components_search())
• Para entender la DB del proyecto (usar get_database_summary())

URL Base

https://makerkit.dev/docs/next-supabase-turbo

Índice Completo

El archivo INDEX.json en este directorio contiene las 150 páginas de documentación organizadas en 21 secciones.

Cómo Usar el Índice

// Leer el índice para encontrar la página correcta
Read(".claude/skills/makerkit-docs/INDEX.json")

// Buscar la sección y página que necesitas
// Construir URL: base_url + path

Resumen de Secciones

Páginas Más Útiles (Acceso Rápido)

Para Desarrollo de Features

Para Data Fetching

Para APIs

Para Billing

Para Seguridad

Para Deploy

Cómo Consultar

Método 1: URL Directa (si conoces el path)

WebFetch(
  url: "https://makerkit.dev/docs/next-supabase-turbo/development/permissions-and-roles",
  prompt: "Extrae el patrón para implementar RBAC con roles y permisos"
)

Método 2: Buscar en Índice Primero

1. Read(".claude/skills/makerkit-docs/INDEX.json")
2. Buscar la sección relevante
3. WebFetch con el path encontrado

Método 3: Explorar una Sección

WebFetch(
  url: "https://makerkit.dev/docs/next-supabase-turbo/billing/overview",
  prompt: "Lista todas las subsecciones de billing disponibles en el menú lateral"
)

Ejemplos de Uso

Ejemplo 1: Implementar RBAC

WebFetch(
  url: "https://makerkit.dev/docs/next-supabase-turbo/development/permissions-and-roles",
  prompt: "Extrae: estructura de tablas para roles/permisos, funciones SQL, y cómo verificar permisos en el código"
)

Ejemplo 2: Configurar Stripe

WebFetch(
  url: "https://makerkit.dev/docs/next-supabase-turbo/billing/stripe",
  prompt: "Lista: variables de entorno necesarias, configuración de webhooks, y eventos a escuchar"
)

Ejemplo 3: Data Model para Proyectos

WebFetch(
  url: "https://makerkit.dev/docs/next-supabase-turbo/recipes/projects-data-model",
  prompt: "Extrae: schema SQL completo, políticas RLS, y componentes UI necesarios"
)

Ejemplo 4: Server Actions Pattern

WebFetch(
  url: "https://makerkit.dev/docs/next-supabase-turbo/data-fetching/server-actions",
  prompt: "Extrae: cómo usar enhanceAction, validación con Zod, y manejo de errores"
)

Ejemplo 5: Troubleshooting Auth

WebFetch(
  url: "https://makerkit.dev/docs/next-supabase-turbo/troubleshooting/troubleshooting-authentication",
  prompt: "Lista problemas comunes de autenticación y sus soluciones"
)

Integración con Otros Tools

Con makerkit-architecture

Cuando diseñes features:

1. MCP primero: find_complete_features(), analyze_feature_pattern()
2. Docs para validar: Usa este skill para confirmar patrones oficiales
3. Combina: Blueprint informado por código real + docs oficiales

Con MCP Database Tools

Notas Importantes

1. URLs específicas: No existen páginas índice como /billing. Siempre usa paths completos como /billing/overview

2. Índice local: El archivo INDEX.json tiene las 150 URLs validadas. Consúltalo si no encuentras algo.

3. Actualización: El índice fue extraído el 2026-01-01. Si MakerKit reorganiza sus docs, puede necesitar actualización.

4. Contenido dinámico: Algunas páginas cargan contenido con JavaScript. Si WebFetch retorna solo navegación, intenta con un prompt más específico.

Troubleshooting del Skill