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:
This is the beginning of the README. Read the rest at the original. Read the full README ↗
