name	MakerKit Patterns
description	This skill should be used when the user asks about "MakerKit patterns", "CLAUDE.md files", "what MCP tools are available", "how does MakerKit structure", "personal vs team accounts", "RLS patterns in MakerKit", or needs quick reference for MakerKit conventions.
version	1.0.0

MakerKit Patterns Reference

Quick reference for MakerKit project patterns and conventions.

CLAUDE.md File Index

MakerKit includes CLAUDE.md files with patterns for each package:

File	Purpose	Key Content
`CLAUDE.md` (root)	Project overview	Commands, technologies, architecture
`apps/web/CLAUDE.md`	Web app patterns	Routes, async params, data fetching
`apps/web/supabase/CLAUDE.md`	Database patterns	Schema workflow, migrations, RLS
`packages/features/CLAUDE.md`	Feature patterns	Personal vs Team accounts
`packages/supabase/CLAUDE.md`	Supabase helpers	RLS functions, triggers
`packages/ui/CLAUDE.md`	UI components	Available components, form patterns
`packages/next/CLAUDE.md`	Next.js patterns	enhanceAction, enhanceRouteHandler

For detailed content, read references/claude-md-index.md.

Account Types

Personal Account

User owns their data directly
FK: user_id → auth.users.id
RLS: auth.uid() = user_id
Use when: Single-user features, personal settings

Team Account

Data belongs to account, shared by members
FK: account_id → accounts.id
RLS: is_team_member(account_id, auth.uid())
Use when: Collaborative features, shared resources

Essential MCP Tools

Database Analysis

get_database_summary()     → All tables, enums, functions
get_table_info(table)      → Schema details
get_all_enums()            → Existing enum types

Feature Analysis

find_complete_features()          → Reference features
analyze_feature_pattern(feature)  → Implementation pattern

Route Analysis

get_app_routes()           → Route structure
get_server_actions()       → Action patterns

RLS Generation

generate_rls_policy({table, access_type, pattern})
validate_rls_policies({table})

For complete MCP reference, read references/mcp-tools.md.

Quick Patterns

Server Action

export const myAction = enhanceAction(
  async (data, { user }) => {
    const client = getSupabaseServerClient();
    // ... operation
    return { success: true, data: result };
  },
  { schema: MySchema }
);

Page Loader

import 'server-only';

export async function loadPageData(
  client: SupabaseClient<Database>,
  accountId: string,
) {
  const { data, error } = await client
    .from('table')
    .select('*')
    .eq('account_id', accountId);

  if (error) throw error;
  return data ?? [];
}

RLS Policy Order

-- 1. Enable RLS
ALTER TABLE public.my_table ENABLE ROW LEVEL SECURITY;

-- 2. Revoke defaults
REVOKE ALL ON public.my_table FROM authenticated, service_role;

-- 3. Grant specific
GRANT SELECT, INSERT, UPDATE, DELETE ON public.my_table TO authenticated;

-- 4. Create policies
CREATE POLICY my_table_select ON public.my_table
  FOR SELECT TO authenticated
  USING (is_team_member(account_id, auth.uid()));

Official Documentation (makerkit-docs)

Para patrones conceptuales que el MCP no cubre, usa el skill makerkit-docs:

Usar MCP cuando...	Usar makerkit-docs cuando...
Necesitas estructura actual del codigo	Necesitas entender conceptos
Que tablas/enums existen	Como funciona billing/auth conceptualmente
Patrones de codigo real	Documentacion oficial de configuracion
Introspeccion del proyecto	Troubleshooting, guias paso a paso

Como invocar: "Usa el skill makerkit-docs para consultar [tema]"

Secciones mas utiles:

/development/database-architecture - Arquitectura DB
/billing/overview - Sistema de billing
/security/row-level-security - RLS patterns
/troubleshooting/* - Resolucion de problemas

Additional Resources

Reference Files

references/claude-md-index.md - Complete CLAUDE.md file contents
references/mcp-tools.md - All MCP tools with examples

When to Load References

Need specific CLAUDE.md content → read claude-md-index.md
Need MCP tool details → read mcp-tools.md
Quick pattern check → use this SKILL.md

Install Skill

SKILL.md