yaowenc2
30b896ec1d
Three things the doc told users to do that the actual CLI scaffold does
differently — all surfaced by running the e2e flow against ba-sdk-test:
1. `pool.on('connect', SET search_path)` races. The listener is async, so
BA/Kysely can dispatch the first query before the SET completes and
hit `relation "user" does not exist`. Switch to
`options: '-c search_path=better_auth,public'` (applied during
connection negotiation, so every query sees the right path from
statement 1) — this is what the GitHub template actually ships.
2. No coverage of the `sslmode=require` + self-signed cert footgun on
InsForge cloud. `pg-connection-string` v2 treats `sslmode=require` as
`verify-full` and silently overrides explicit
`ssl: { rejectUnauthorized: false }`. Add the URL-strip pattern and a
Common Mistakes entry.
3. `requireEnv` is defined once in the doc but used in four files. The
scaffold duplicates it inline so each file copy-pastes cleanly. Add
one line to the helper comment explaining this.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
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 setupfor 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/sdkinto 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 oldinsforge.aimodule 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.