Claude-skill-registry-data MakerKit Patterns

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry-data
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry-data "$T" && mkdir -p ~/.claude/skills && cp -r "$T/data/makerkit-patterns" ~/.claude/skills/majiayu000-claude-skill-registry-data-makerkit-patterns && rm -rf "$T"
manifest: data/makerkit-patterns/SKILL.md
source content

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:

FilePurposeKey Content
CLAUDE.md
(root)
Project overviewCommands, technologies, architecture
apps/web/CLAUDE.md
Web app patternsRoutes, async params, data fetching
apps/web/supabase/CLAUDE.md
Database patternsSchema workflow, migrations, RLS
packages/features/CLAUDE.md
Feature patternsPersonal vs Team accounts
packages/supabase/CLAUDE.md
Supabase helpersRLS functions, triggers
packages/ui/CLAUDE.md
UI componentsAvailable components, form patterns
packages/next/CLAUDE.md
Next.js patternsenhanceAction, 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:
    has_role_on_account(account_id)
    - verifica membresía en cuenta
  • 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 (public.has_role_on_account(account_id));

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 codigoNecesitas entender conceptos
Que tablas/enums existenComo funciona billing/auth conceptualmente
Patrones de codigo realDocumentacion oficial de configuracion
Introspeccion del proyectoTroubleshooting, 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/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