InsForge Agent Skills

Agent Skills to help developers using AI agents build applications with InsForge Backend-as-a-Service.

Installation

Using the skills registry

npx skills add insforge/insforge-skills

Claude Code

/install-skills insforge/insforge-skills

Available Skills

insforge - InsForge Backend-as-a-Service Development

Build full-stack applications with InsForge. This skill provides comprehensive guidance for:

• Database: CRUD operations, schema design, RLS policies, triggers
• Authentication: Sign up/in flows, OAuth, sessions, email verification
• Storage: File uploads, downloads, bucket management
• Functions: Serverless function deployment and invocation
• AI: OpenRouter via project Model Gateway key setup, chat completions, image/video/audio generation, embeddings, and model discovery
• Real-time: WebSocket connections, subscriptions, event publishing
• Payments: Stripe Checkout Sessions, subscriptions, and Billing Portal redirects
• Deployments: Frontend app deployment to InsForge hosting

Key distinction: Backend infrastructure uses the CLI skill. Most client integration uses @insforge/sdk; new AI features use OpenRouter APIs with an API key set up by npx @insforge/cli ai setup.

insforge-cli - InsForge CLI Project Management

Create and manage InsForge projects from the command line. This skill provides comprehensive guidance for:

• Authentication: Login (OAuth/password), logout, session verification
• Project Management: Create, link, and inspect projects
• Database: Raw SQL execution, schema inspection, RLS, import/export
• Edge Functions: Deploy, invoke, and view function source
• Storage: Bucket and object management (upload, download, list)
• Deployments: Frontend app deployment and status tracking
• AI: OpenRouter key setup with npx @insforge/cli ai setup
• Payments: Stripe key setup, catalog sync, products/prices, webhooks
• Secrets: Create, update, and manage project secrets
• CI/CD: Non-interactive workflows using environment variables

Key distinction: Use this skill for infrastructure management via @insforge/cli. For writing application code with the InsForge SDK, use the insforge skill instead.

insforge-debug - InsForge Debugging & Diagnostics

Diagnose errors, bugs, and performance issues in InsForge projects. This skill guides diagnostic command execution for:

• SDK Errors: Frontend SDK error objects and unexpected behavior
• HTTP Errors: 4xx/5xx responses from InsForge backend
• Edge Functions: Failures, timeouts, and deploy errors
• Database: Slow queries and performance degradation
• Auth: Authentication and authorization failures
• Real-time: Channel connection and subscription issues
• Deployments: Frontend (Vercel) and edge function deploy failures

Key distinction: This skill guides diagnostic command execution to locate problems — it does not provide fix suggestions.

insforge-integrations - Third-Party Auth Provider Integrations

Integrate third-party authentication providers with InsForge for Row Level Security (RLS). Each integration covers JWT configuration, token signing, and InsForge client setup:

• Auth0: Post Login Action, Auth0 v4 SDK, custom claim embedding
• Clerk: JWT Template config, client-side getToken() flow
• Kinde: Server-side JWT signing (no custom signing key support)
• Stytch: Magic link flow, server-side session validation
• WorkOS: AuthKit middleware, server-side JWT signing

Key distinction: Use these guides when connecting an external auth provider to InsForge. For InsForge's built-in authentication, use the insforge skill instead.

Usage

Once installed, AI agents can access InsForge-specific guidance when:

• Setting up backend infrastructure (tables, buckets, functions, auth, AI)
• Integrating @insforge/sdk into frontend applications
• Implementing database CRUD operations with proper RLS
• Building authentication flows with OAuth and email verification
• Deploying serverless functions and frontend apps

Skill Structure

Each skill follows the Agent Skills Open Standard:

skills/
├── insforge/
│   ├── SKILL.md              # Main skill manifest and overview
│   ├── database/
│   │   ├── sdk-integration.md
│   │   ├── pgvector.md
│   │   └── postgres-rls.md
│   ├── auth/
│   │   ├── sdk-integration.md
│   │   └── ssr-integration.md
│   ├── storage/
│   │   ├── sdk-integration.md
│   │   ├── s3-gateway.md
│   │   └── postgres-rls.md
│   ├── functions/
│   │   └── sdk-integration.md
│   ├── ai/
│   │   ├── overview.md
│   │   ├── chat-completions.md
│   │   ├── image-generation.md
│   │   ├── video-generation.md
│   │   ├── audio.md
│   │   ├── embeddings-and-rag.md
│   │   └── models-list.md
│   ├── realtime/
│   │   └── sdk-integration.md
│   ├── payments/
│   │   └── sdk-integration.md
│   └── email/
│       └── sdk-integration.md
├── insforge-cli/
│   ├── SKILL.md              # CLI skill manifest and command reference
│   └── references/
│       ├── auth.md
│       ├── login.md
│       ├── create.md
│       ├── db-query.md
│       ├── db-export.md
│       ├── db-import.md
│       ├── functions-deploy.md
│       ├── payments.md
│       └── deployments-deploy.md
├── insforge-debug/
│   └── SKILL.md              # Debug & diagnostics skill
└── insforge-integrations/
    ├── auth0/
    │   └── SKILL.md          # Auth0 integration guide
    ├── clerk/
    │   └── SKILL.md          # Clerk integration guide
    ├── kinde/
    │   └── SKILL.md          # Kinde integration guide
    ├── stytch/
    │   └── SKILL.md          # Stytch integration guide
    └── workos/
        └── SKILL.md          # WorkOS integration guide

Documentation Pattern

• sdk-integration.md: How to use app-facing SDKs/APIs in application code.
• AI capability guides: ai/overview.md links to smaller OpenRouter-focused guides for chat completions, image generation, video generation, audio, embeddings/RAG, and model discovery.
• Specialized guides: Focused references such as postgres-rls.md, pgvector.md, s3-gateway.md, or provider-specific integration guides.

Contributing

To create or improve skills, first install the skill-creator tool:

npx skills add anthropics/skills -s skill-creator

See CONTRIBUTING.md for guidelines on adding or improving skills.

License

MIT License - see LICENSE for details.