InsForge Agent Skills

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

Installation

Codex plugin marketplace

Add this repository as a Codex plugin marketplace, then install the InsForge plugin:

codex plugin marketplace add InsForge/insforge-skills
codex plugin add insforge@insforge

After installing, start a new Codex thread and ask Codex to use InsForge or one of the bundled skills.

Using the skills registry

npx -y skills add insforge/insforge-skills

Claude Code

/install-skills insforge/insforge-skills

Available Skills

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/Billing Portal and Razorpay Orders/Subscriptions
• 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 -y @insforge/cli ai setup.

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 -y @insforge/cli ai setup
• Payments: Stripe/Razorpay key setup, catalog sync, provider 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.

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.

Connect external providers to InsForge. The auth-provider guides cover JWT configuration, token signing, and InsForge client setup for Row Level Security (RLS); the OKX x402 guide is a separate onchain payment-facilitator flow:

• 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
• Better Auth: Framework-agnostic auth/bridge primitives, RLS policies, client hook
• OKX x402: Onchain pay-per-use billing via the x402 payment facilitator (not an auth provider)

Key distinction: Use these guides when connecting an external auth provider (or the x402 payment facilitator) 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
• Adding Stripe or Razorpay payment flows
• 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
│   ├── 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/
│   │   ├── stripe.md
│   │   └── razorpay.md
│   └── email/
│       └── sdk-integration.md
├── insforge-cli/
│   ├── SKILL.md              # CLI skill manifest and command reference
│   └── references/
│       ├── auth.md
│       ├── login.md
│       ├── create.md
│       ├── config.md
│       ├── realtime.md
│       ├── compute-deploy.md
│       ├── schedules.md
│       ├── diagnostics.md
│       ├── posthog.md
│       ├── functions-deploy.md
│       ├── database/
│       │   ├── migrations.md
│       │   ├── query.md
│       │   ├── access-control.md
│       │   ├── integrity.md
│       │   ├── vector.md
│       │   ├── export.md
│       │   └── import.md
│       ├── branch/
│       │   ├── overview.md
│       │   ├── merge.md
│       │   └── reset.md
│       ├── payments/
│       │   ├── overview.md
│       │   ├── stripe.md
│       │   └── razorpay.md
│       └── deployments/
│           ├── deploy.md
│           └── domains.md
├── insforge-debug/
│   ├── SKILL.md              # Debug & diagnostics skill manifest
│   └── references/
│       ├── error-objects.md
│       ├── logs.md
│       ├── metrics.md
│       ├── db-health.md
│       ├── advisor.md
│       ├── policies.md
│       ├── metadata.md
│       ├── deploy-state.md
│       └── ai-assisted.md
└── insforge-integrations/
    ├── SKILL.md              # Integrations skill manifest
    └── references/
        ├── auth0.md          # Auth0 integration guide
        ├── clerk.md          # Clerk integration guide
        ├── kinde.md          # Kinde integration guide
        ├── stytch.md         # Stytch integration guide
        ├── workos.md         # WorkOS integration guide
        ├── better-auth.md    # Better Auth integration guide
        └── okx-x402.md       # OKX x402 payment facilitator 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 references/database/access-control.md, references/database/integrity.md, storage/postgres-rls.md, s3-gateway.md, references/database/vector.md, payment provider guides, or other provider-specific integration guides.

Contributing

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

npx -y skills add anthropics/skills -s skill-creator

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

License

Apache License 2.0 - see LICENSE for details.