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 OpenAI SDK, npx @insforge/cli ai setup for key setup, image/video generation, embeddings, deprecated InsForge SDK fallback
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 with the OpenAI SDK and an API key set up with 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
│   │   └── backend-configuration.md
│   ├── auth/
│   │   ├── sdk-integration.md
│   │   └── backend-configuration.md
│   ├── storage/
│   │   ├── sdk-integration.md
│   │   └── backend-configuration.md
│   ├── functions/
│   │   ├── sdk-integration.md
│   │   └── backend-configuration.md
│   ├── ai/
│   │   ├── sdk-integration.md
│   │   └── backend-configuration.md
│   ├── realtime/
│   │   ├── sdk-integration.md
│   │   └── backend-configuration.md
│   ├── payments/
│   │   ├── sdk-integration.md
│   │   └── backend-configuration.md
│   └── deployments/
│       └── workflow.md
├── insforge-cli/
│   ├── SKILL.md              # CLI skill manifest and command reference
│   └── references/
│       ├── 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. For AI, this means OpenRouter through the OpenAI SDK, with the old insforge.ai module only as a deprecated fallback.
backend-configuration.md: How to configure InsForge backend via HTTP API

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.