AgentSkillsCN

makerkit-docs

按需查阅 MakerKit(next-supabase-turbo)官方文档。在需要关于 MakerKit 模式、配置或 API 的信息且不在本地代码中时可运用此技能。包含完整的 150 页索引。

SKILL.md
--- frontmatter
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

code
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

typescript
// 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

SecciónSlugPáginasTemas Clave
Installationinstallation16Setup, comandos, migración, MCP
Configurationconfiguration7Env vars, auth config, feature flags
Customizationcustomization5Tailwind, theme, logo, fonts
Developmentdevelopment17DB architecture, migrations, RBAC, testing
APIapi8Account, Team, Auth, Workspace APIs
Data Fetchingdata-fetching7Supabase clients, Server Actions, React Query
Billingbilling12Stripe, Lemon Squeezy, Paddle, webhooks
Contentcontent6CMS, Keystatic, Wordpress
UI Componentscomponents14Shadcn, forms, tables, marketing
Notificationsnotifications2Config y envío
Translationstranslations3i18n, language selector
Emailsemails6Config, templates, auth emails
Monitoringmonitoring5Sentry, Signoz, PostHog
Super Adminadmin1Adding super admin
Analyticsanalytics5GA, PostHog, Umami, custom
Securitysecurity4Next.js practices, RLS, CSP
Going to Productiongoing-to-production10Deploy Vercel, Cloudflare, Docker
Pluginsplugins6Waitlist, Roadmap, AI Chatbot
Recipesrecipes7Team/Personal accounts, checkout, data model
Developer Toolsdev-tools2Env vars, translations editor
Troubleshootingtroubleshooting7Install, auth, billing, deploy issues

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

Para Desarrollo de Features

TemaPath
Database Architecture/development/database-architecture
Extending DB Schema/development/database-schema
Database Functions/development/database-functions
RBAC: Roles & Permissions/development/permissions-and-roles
Loading Data/development/loading-data-from-database
Writing Data/development/writing-data-to-database
Projects Data Model (Recipe)/recipes/projects-data-model

Para Data Fetching

TemaPath
Supabase Clients/data-fetching/supabase-clients
Server Actions/data-fetching/server-actions
Server Components/data-fetching/server-components
Route Handlers/data-fetching/route-handlers
React Query/data-fetching/react-query

Para APIs

TemaPath
Account API/api/account-api
Team Account API/api/team-account-api
Authentication API/api/authentication-api
Feature Policies API/api/policies-api

Para Billing

TemaPath
How Billing Works/billing/overview
Billing Schema/billing/billing-schema
Stripe/billing/stripe
Lemon Squeezy/billing/lemon-squeezy
Per Seat Billing/billing/per-seat-billing
Handling Webhooks/billing/billing-webhooks

Para Seguridad

TemaPath
Next.js Best Practices/security/nextjs-best-practices
Row Level Security/security/row-level-security
Data Validation/security/data-validation

Para Deploy

TemaPath
Production Checklist/going-to-production/checklist
Deploy Supabase/going-to-production/supabase
Deploy to Vercel/going-to-production/vercel
Deploy to Cloudflare/going-to-production/cloudflare

Cómo Consultar

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

code
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

code
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

code
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

code
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

code
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

code
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

code
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

code
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

Si necesitas...Usa...
Ver tablas del proyectoget_database_summary()
Entender patrones de tablasEste skill → /development/database-architecture
Generar RLSgenerate_rls_policy()
Entender RLS patternsEste skill → /security/row-level-security

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

ProblemaSolución
404 Not FoundVerificar path en INDEX.json
Contenido incompletoUsar prompt más específico
Solo navegaciónLa página usa JS; probar otra subsección
Info desactualizadaWebFetch es en tiempo real, el índice puede estar desactualizado