---

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:

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: has_role_on_account(account_id) - verifica membresía en cuenta
• Use when: Collaborative features, shared resources

Essential MCP Tools

Database Analysis

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

Feature Analysis

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

Route Analysis

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

RLS Generation

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

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

Quick Patterns

Server Action

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

Page Loader

Copyimport '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

Copy-- 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 (public.has_role_on_account(account_id));

Official Documentation (makerkit-docs)

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

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/makerkit-consolidado.md - Quick reference con templates copy-paste ready (PREFERIDO)
• references/claude-md-index.md - Complete CLAUDE.md file contents
• references/mcp-tools.md - All MCP tools with examples

When to Load References

• Need templates for Ralph → read makerkit-consolidado.md (PRIMERO)
• 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