Understanding Meta-Skills

Meta-skills are a special category of skills that generate project-specific skills based on your tech stack and configuration. Instead of providing generic instructions, they analyze your project and create tailored workflows.

What Makes Meta-Skills Different

Project Skills

  • Generic workflows that work for any project
  • Loaded and executed immediately
  • Examples: PRD creation, merge conflicts, screenshots

Meta-Skills

  • Generate project-specific skills tailored to your stack
  • Analyze your project.json and codebase first
  • Output: A custom skill file saved to your project

How Meta-Skills Work

When you invoke a meta-skill, it goes through a generation process:

1

Read Project Configuration

The meta-skill reads your project.json to understand your tech stack — database type, authentication method, API patterns, UI framework, etc.

2

Analyze Existing Patterns

It examines your existing codebase to understand how you've implemented similar patterns before — your naming conventions, file organization, and coding style.

3

Ask Clarifying Questions

If there are ambiguities or choices to be made, the meta-skill will ask you questions to ensure the generated skill matches your preferences.

4

Generate Tailored Skill

Finally, it generates a customized skill file and saves it to docs/skills/ in your project. This skill can then be used by any agent working on your project.

Example: auth-skill-generator

If your project uses Supabase Auth with Next.js App Router, the auth-skill-generator might create:

# docs/skills/auth-flow/SKILL.md
## Authentication Patterns
- Use `createServerClient()` from @supabase/ssr
- Protect routes with middleware at `middleware.ts`
- Store session in cookies, not localStorage
- Redirect to /login on 401...

Available Meta-Skills (11)

These meta-skills can generate project-specific patterns for your codebase:

meta

Ai Tools Skill Generator

Generate a project-specific AI tools skill. Use when a project has ai: true and aiTools configuration. Triggers on: generate ai tools skill, create chatbot tools, ai-tools-skill-generator.

meta

Api Endpoint Skill Generator

Generate a project-specific API patterns skill. Use when a project has api: true to document endpoint creation patterns. Triggers on: generate api skill, create endpoint patterns, api-endpoint-skill-generator.

meta

Auth Skill Generator

Generate a project-specific auth-flow skill. Use when a project has authentication: true but no auth-flow skill. Triggers on: generate auth skill, create auth patterns, auth-skill-generator.

meta

Crud Skill Generator

Generate a project-specific CRUD patterns skill. Use for any project with a database to document entity creation patterns. Triggers on: generate crud skill, create crud patterns, crud-skill-generator.

meta

Database Migration Skill Generator

Generate a project-specific database migration skill. Use for any project with a database to document migration patterns. Triggers on: generate migration skill, create migration patterns, database-migration-skill-generator.

meta

Email Skill Generator

Generate a project-specific transactional email skill. Use when a project has email: true or email integration (resend, sendgrid, etc). Triggers on: generate email skill, create email patterns, email-skill-generator.

meta

Form Skill Generator

Generate a project-specific form patterns skill. Use for frontend apps to document form handling. Triggers on: generate form skill, create form patterns, form-skill-generator.

meta

Multi Tenant Skill Generator

Generate a project-specific tenant-context skill. Use when a project has multiTenant: true but no tenant-context skill. Triggers on: generate tenant skill, create multi-tenant patterns, multi-tenant-skill-generator.

meta

Stripe Skill Generator

Generate a project-specific payments skill for Stripe integration. Use when a project has stripe in integrations. Triggers on: generate stripe skill, create payment patterns, stripe-skill-generator.

meta

Supabase Skill Generator

Generate a project-specific Supabase database skill covering RLS, client patterns, and query types. Use when a project has supabase in integrations. Triggers on: generate supabase skill, supabase patterns, supabase-skill-generator.

meta

Table Skill Generator

Generate a project-specific data table patterns skill. Use for frontend apps to document table/list handling. Triggers on: generate table skill, create table patterns, table-skill-generator.

When to Use Meta-Skills

✅ New project setup

After bootstrapping a project, run relevant meta-skills to generate patterns for your stack.

✅ Adding new capabilities

When you add authentication, payments, or email to your project, generate the corresponding skill.

✅ Onboarding new team members

Generated skills document your project's patterns, helping new developers understand conventions.

✅ Ensuring consistency

Skills encode your patterns so agents follow them consistently across the codebase.

Ready to generate skills for your project?

Browse the available meta-skills and start generating project-specific patterns.

Browse Meta-Skills