Build Zid apps faster with AI coding agents. The Zid Agent Skill teaches tools like Claude, Claude Code, and opencode how Zid's OAuth flow, multi-tenant token model, and Merchant APIs actually work β grounded in this documentation, not guesswork.Why use it#
No hallucinated endpoints. The agent is instructed to reference official Zid docs before implementing any API call.
Correct OAuth handling from the start. Covers the Authorization Code flow, the Authorization / X-Manager-Token header pair, and proactive token refresh β the most common source of integration bugs.
Multi-tenant by default. Encodes patterns for storing and scoping credentials per merchant, so apps scale safely from 1 install to thousands.
Clear error handling. Structured guidance for Zid's response format, rate limits, and how to prepare a report for the Zid technical team when you need to escalate.
Get started#
2.
Add it to your AI agent's skills directory (see the repo's README for Claude, Claude Code, and opencode setup).
3.
Start building β describe what you're building for your Zid app, and the agent applies the skill automatically.
What it covers#
| Area | Description |
|---|
| OAuth 2.0 | Authorization Code grant, token exchange, refresh, token lifetimes |
| Multi-tenancy | Per-merchant credential storage, tenant isolation |
| Error handling | Response formats, status codes, rate limits, retries |
| API reference map | Categorized index of Zid's Merchant, Storefront, Webhook, and Payment APIs |
| Troubleshooting | Partner Dashboard and OAuth debugging tools |
Source#
The skill is open source and maintained alongside this documentation. Contributions and issue reports are welcome: Modified atΒ 2026-07-20 08:45:59
