insforge-integrations
Use when wiring an external auth provider (Clerk, Auth0, WorkOS, Kinde, Stytch, Better Auth) into InsForge for JWT-based RLS, or when adding
Open source Repository Open in the app JSON README (API)
About
Use when wiring an external auth provider (Clerk, Auth0, WorkOS, Kinde, Stytch, Better Auth) into InsForge for JWT-based RLS, or when adding the OKX x402 payment facilitator for onchain pay-per-use billing.
Details
- Kind
- Agent skills
- Topic
- Finance & crypto
- Publisher
- insforge
- Origin
- skillssh
- Category
- ferramentas
- Stars
- 36
- Forks
- 12
- Open pull requests
- 5
- Last push
- 2026-08-29T01:37:02Z
- Repository state
- ativo
- License
- Apache-2.0
- Added
- 2026-08-30 15:21:09
- Updated
- 2026-09-08 18:02:36
- Origin id
insforge/insforge-skills/insforge-integrations
README
# InsForge Agent Skills
Agent Skills to help developers using AI agents build applications with [InsForge](https://insforge.dev) Backend-as-a-Service.
## Installation
### Codex plugin marketplace
Add this repository as a Codex plugin marketplace, then install the InsForge plugin:
```bash
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
```bash
npx -y skills add insforge/insforge-skills
```
### Claude Code
```bash
/install-skills insforge/insforge-skills
```
## Available Skills
<details>
<summary><strong>insforge</strong> - InsForge Backend-as-a-Service Development</summary>
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`.
</details>
<details>
<summary><strong>insforge-cli</strong> - InsForge CLI Project Management</summary>
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.
</details>
<details>
<summary><strong>insforge-debug</strong> - InsForge Debugging & Diagnostics</summary>
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.
</details>
<details>
<summary><strong>insforge-integrations</strong> - Third-Party Auth Provider Integrations</summary>
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.
</details>
## 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](https://agentskills.io/):
```
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:
```bash
npx -y skills add anthropics/skills -s skill-creator
```
See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on adding or improving skills.
## License
Apache License 2.0 - see [LICENSE](LICENSE) for details.