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
| Sección |
Slug |
Páginas |
Temas Clave |
| Installation |
installation |
16 |
Setup, comandos, migración, MCP |
| Configuration |
configuration |
7 |
Env vars, auth config, feature flags |
| Customization |
customization |
5 |
Tailwind, theme, logo, fonts |
| Development |
development |
17 |
DB architecture, migrations, RBAC, testing |
| API |
api |
8 |
Account, Team, Auth, Workspace APIs |
| Data Fetching |
data-fetching |
7 |
Supabase clients, Server Actions, React Query |
| Billing |
billing |
12 |
Stripe, Lemon Squeezy, Paddle, webhooks |
| Content |
content |
6 |
CMS, Keystatic, Wordpress |
| UI Components |
components |
14 |
Shadcn, forms, tables, marketing |
| Notifications |
notifications |
2 |
Config y envío |
| Translations |
translations |
3 |
i18n, language selector |
| Emails |
emails |
6 |
Config, templates, auth emails |
| Monitoring |
monitoring |
5 |
Sentry, Signoz, PostHog |
| Super Admin |
admin |
1 |
Adding super admin |
| Analytics |
analytics |
5 |
GA, PostHog, Umami, custom |
| Security |
security |
4 |
Next.js practices, RLS, CSP |
| Going to Production |
going-to-production |
10 |
Deploy Vercel, Cloudflare, Docker |
| Plugins |
plugins |
6 |
Waitlist, Roadmap, AI Chatbot |
| Recipes |
recipes |
7 |
Team/Personal accounts, checkout, data model |
| Developer Tools |
dev-tools |
2 |
Env vars, translations editor |
| Troubleshooting |
troubleshooting |
7 |
Install, auth, billing, deploy issues |
Páginas Más Útiles (Acceso Rápido)
Para Desarrollo de Features
| Tema |
Path |
| 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
| Tema |
Path |
| 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
| Tema |
Path |
| 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
| Tema |
Path |
| 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
| Tema |
Path |
| Next.js Best Practices |
/security/nextjs-best-practices |
| Row Level Security |
/security/row-level-security |
| Data Validation |
/security/data-validation |
Para Deploy
| Tema |
Path |
| 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)
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:
- MCP primero:
find_complete_features(), analyze_feature_pattern()
- Docs para validar: Usa este skill para confirmar patrones oficiales
- Combina: Blueprint informado por código real + docs oficiales
Con MCP Database Tools
| Si necesitas... |
Usa... |
| Ver tablas del proyecto |
get_database_summary() |
| Entender patrones de tablas |
Este skill → /development/database-architecture |
| Generar RLS |
generate_rls_policy() |
| Entender RLS patterns |
Este skill → /security/row-level-security |
Notas Importantes
URLs específicas: No existen páginas índice como /billing. Siempre usa paths completos como /billing/overview
Índice local: El archivo INDEX.json tiene las 150 URLs validadas. Consúltalo si no encuentras algo.
Actualización: El índice fue extraído el 2026-01-01. Si MakerKit reorganiza sus docs, puede necesitar actualización.
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
| Problema |
Solución |
| 404 Not Found |
Verificar path en INDEX.json |
| Contenido incompleto |
Usar prompt más específico |
| Solo navegación |
La página usa JS; probar otra subsección |
| Info desactualizada |
WebFetch es en tiempo real, el índice puede estar desactualizado |
1---2name: makerkit-docs3description: 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.4---5
6# MakerKit Documentation Access
7
8## Anuncio
9
10"Consultando documentación oficial de MakerKit para [tema]."
11
12## Cuándo Usar
13
14- Cuando necesites saber "cómo hace MakerKit X"
15- Cuando encuentres código que no entiendes y el CLAUDE.md local no ayuda
16- Cuando planifiques una feature y quieras validar el approach oficial
17- Cuando el MCP no tenga la información (patrones conceptuales vs código)
18- Cuando configures billing, auth, emails, o features complejas
19
20## Cuándo NO Usar
21
22- Para introspección de código local (usar MCP)
23- Para ver qué componentes existen en el proyecto (usar `components_search()`)
24- Para entender la DB del proyecto (usar `get_database_summary()`)
25
26---
27
28## URL Base
29
30```
31https://makerkit.dev/docs/next-supabase-turbo
32```
33
34---
35
36## Índice Completo
37
38El archivo `INDEX.json` en este directorio contiene las **150 páginas** de documentación organizadas en 21 secciones.
39
40### Cómo Usar el Índice
41
42```typescript
43// Leer el índice para encontrar la página correcta
44Read(".claude/skills/makerkit-docs/INDEX.json")
45
46// Buscar la sección y página que necesitas
47// Construir URL: base_url + path
48```
49
50### Resumen de Secciones
51
52| Sección | Slug | Páginas | Temas Clave |
53|---------|------|---------|-------------|
54| Installation | `installation` | 16 | Setup, comandos, migración, MCP |
55| Configuration | `configuration` | 7 | Env vars, auth config, feature flags |
56| Customization | `customization` | 5 | Tailwind, theme, logo, fonts |
57| Development | `development` | 17 | DB architecture, migrations, RBAC, testing |
58| API | `api` | 8 | Account, Team, Auth, Workspace APIs |
59| Data Fetching | `data-fetching` | 7 | Supabase clients, Server Actions, React Query |
60| Billing | `billing` | 12 | Stripe, Lemon Squeezy, Paddle, webhooks |
61| Content | `content` | 6 | CMS, Keystatic, Wordpress |
62| UI Components | `components` | 14 | Shadcn, forms, tables, marketing |
63| Notifications | `notifications` | 2 | Config y envío |
64| Translations | `translations` | 3 | i18n, language selector |
65| Emails | `emails` | 6 | Config, templates, auth emails |
66| Monitoring | `monitoring` | 5 | Sentry, Signoz, PostHog |
67| Super Admin | `admin` | 1 | Adding super admin |
68| Analytics | `analytics` | 5 | GA, PostHog, Umami, custom |
69| Security | `security` | 4 | Next.js practices, RLS, CSP |
70| Going to Production | `going-to-production` | 10 | Deploy Vercel, Cloudflare, Docker |
71| Plugins | `plugins` | 6 | Waitlist, Roadmap, AI Chatbot |
72| Recipes | `recipes` | 7 | Team/Personal accounts, checkout, data model |
73| Developer Tools | `dev-tools` | 2 | Env vars, translations editor |
74| Troubleshooting | `troubleshooting` | 7 | Install, auth, billing, deploy issues |
75
76---
77
78## Páginas Más Útiles (Acceso Rápido)
79
80### Para Desarrollo de Features
81
82| Tema | Path |
83|------|------|
84| Database Architecture | `/development/database-architecture` |
85| Extending DB Schema | `/development/database-schema` |
86| Database Functions | `/development/database-functions` |
87| RBAC: Roles & Permissions | `/development/permissions-and-roles` |
88| Loading Data | `/development/loading-data-from-database` |
89| Writing Data | `/development/writing-data-to-database` |
90| Projects Data Model (Recipe) | `/recipes/projects-data-model` |
91
92### Para Data Fetching
93
94| Tema | Path |
95|------|------|
96| Supabase Clients | `/data-fetching/supabase-clients` |
97| Server Actions | `/data-fetching/server-actions` |
98| Server Components | `/data-fetching/server-components` |
99| Route Handlers | `/data-fetching/route-handlers` |
100| React Query | `/data-fetching/react-query` |
101
102### Para APIs
103
104| Tema | Path |
105|------|------|
106| Account API | `/api/account-api` |
107| Team Account API | `/api/team-account-api` |
108| Authentication API | `/api/authentication-api` |
109| Feature Policies API | `/api/policies-api` |
110
111### Para Billing
112
113| Tema | Path |
114|------|------|
115| How Billing Works | `/billing/overview` |
116| Billing Schema | `/billing/billing-schema` |
117| Stripe | `/billing/stripe` |
118| Lemon Squeezy | `/billing/lemon-squeezy` |
119| Per Seat Billing | `/billing/per-seat-billing` |
120| Handling Webhooks | `/billing/billing-webhooks` |
121
122### Para Seguridad
123
124| Tema | Path |
125|------|------|
126| Next.js Best Practices | `/security/nextjs-best-practices` |
127| Row Level Security | `/security/row-level-security` |
128| Data Validation | `/security/data-validation` |
129
130### Para Deploy
131
132| Tema | Path |
133|------|------|
134| Production Checklist | `/going-to-production/checklist` |
135| Deploy Supabase | `/going-to-production/supabase` |
136| Deploy to Vercel | `/going-to-production/vercel` |
137| Deploy to Cloudflare | `/going-to-production/cloudflare` |
138
139---
140
141## Cómo Consultar
142
143### Método 1: URL Directa (si conoces el path)
144
145```
146WebFetch(
147 url: "https://makerkit.dev/docs/next-supabase-turbo/development/permissions-and-roles",
148 prompt: "Extrae el patrón para implementar RBAC con roles y permisos"
149)
150```
151
152### Método 2: Buscar en Índice Primero
153
154```
1551. Read(".claude/skills/makerkit-docs/INDEX.json")
1562. Buscar la sección relevante
1573. WebFetch con el path encontrado
158```
159
160### Método 3: Explorar una Sección
161
162```
163WebFetch(
164 url: "https://makerkit.dev/docs/next-supabase-turbo/billing/overview",
165 prompt: "Lista todas las subsecciones de billing disponibles en el menú lateral"
166)
167```
168
169---
170
171## Ejemplos de Uso
172
173### Ejemplo 1: Implementar RBAC
174
175```
176WebFetch(
177 url: "https://makerkit.dev/docs/next-supabase-turbo/development/permissions-and-roles",
178 prompt: "Extrae: estructura de tablas para roles/permisos, funciones SQL, y cómo verificar permisos en el código"
179)
180```
181
182### Ejemplo 2: Configurar Stripe
183
184```
185WebFetch(
186 url: "https://makerkit.dev/docs/next-supabase-turbo/billing/stripe",
187 prompt: "Lista: variables de entorno necesarias, configuración de webhooks, y eventos a escuchar"
188)
189```
190
191### Ejemplo 3: Data Model para Proyectos
192
193```
194WebFetch(
195 url: "https://makerkit.dev/docs/next-supabase-turbo/recipes/projects-data-model",
196 prompt: "Extrae: schema SQL completo, políticas RLS, y componentes UI necesarios"
197)
198```
199
200### Ejemplo 4: Server Actions Pattern
201
202```
203WebFetch(
204 url: "https://makerkit.dev/docs/next-supabase-turbo/data-fetching/server-actions",
205 prompt: "Extrae: cómo usar enhanceAction, validación con Zod, y manejo de errores"
206)
207```
208
209### Ejemplo 5: Troubleshooting Auth
210
211```
212WebFetch(
213 url: "https://makerkit.dev/docs/next-supabase-turbo/troubleshooting/troubleshooting-authentication",
214 prompt: "Lista problemas comunes de autenticación y sus soluciones"
215)
216```
217
218---
219
220## Integración con Otros Tools
221
222### Con makerkit-architecture
223
224Cuando diseñes features:
2251. **MCP primero:** `find_complete_features()`, `analyze_feature_pattern()`
2262. **Docs para validar:** Usa este skill para confirmar patrones oficiales
2273. **Combina:** Blueprint informado por código real + docs oficiales
228
229### Con MCP Database Tools
230
231| Si necesitas... | Usa... |
232|-----------------|--------|
233| Ver tablas del proyecto | `get_database_summary()` |
234| Entender patrones de tablas | Este skill → `/development/database-architecture` |
235| Generar RLS | `generate_rls_policy()` |
236| Entender RLS patterns | Este skill → `/security/row-level-security` |
237
238---
239
240## Notas Importantes
241
2421. **URLs específicas:** No existen páginas índice como `/billing`. Siempre usa paths completos como `/billing/overview`
243
2442. **Índice local:** El archivo `INDEX.json` tiene las 150 URLs validadas. Consúltalo si no encuentras algo.
245
2463. **Actualización:** El índice fue extraído el 2026-01-01. Si MakerKit reorganiza sus docs, puede necesitar actualización.
247
2484. **Contenido dinámico:** Algunas páginas cargan contenido con JavaScript. Si WebFetch retorna solo navegación, intenta con un prompt más específico.
249
250---
251
252## Troubleshooting del Skill
253
254| Problema | Solución |
255|----------|----------|
256| 404 Not Found | Verificar path en INDEX.json |
257| Contenido incompleto | Usar prompt más específico |
258| Solo navegación | La página usa JS; probar otra subsección |
259| Info desactualizada | WebFetch es en tiempo real, el índice puede estar desactualizado |