connection-schema-design
Connection profile and state schema design rules and core profile selection
npx skills add majiayu000/claude-skill-registry --skill connection-schema-design-zerobias-org-module --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Connection Profile & State Design Rules **Rules for designing connectionProfile.yml and connectionState.yml schemas** ## 🚨 CRITICAL RULES ### Rule 1: Always Extend Core Profiles **NEVER create custom profiles from scratch - ALWAYS extend core profiles** ```yaml # ❌ WRONG - Custom profile type: object properties: apiKey: type: string # ✅ CORRECT - Extend core profile $ref: './node_modules/@zerobias-org/types-core/schema/tokenProfile.yml' ``` ### Rule 2: connectionState MUST Extend baseConnectionState **🚨 MANDATORY**: connectionState.yml MUST extend baseConnectionState.yml for expiresIn ```yaml # ✅ CORRECT - Extends base with expiresIn allOf: - $ref: './node_modules/@zerobias-org/types-core/schema/baseConnectionState.yml' - type: object properties: accessToken: type: string # ❌ WRONG - Missing baseConnectionState type: object properties: accessToken: type: string # Missing expiresIn! ``` **WHY**: Server uses expiresIn to schedule automatic token refresh cronjobs ### Rule 3: expiresIn Must Be in Seconds ```yaml # ✅ CORRECT expiresIn: type: integer description: Token expiry time in SECONDS from now # ❌ WRONG expiresAt: type: string # Don't use expiresAt, convert to expiresIn ``` **
- 🚨 CRITICAL RULES
- Rule 1: Always Extend Core Profiles
- Rule 2: connectionState MUST Extend baseConnectionState
- Rule 3: expiresIn Must Be in Seconds
- Core Profile Selection
- Available Core Profiles
- Selection Decision Tree
- Available Core States
- State Selection
- Common Patterns
- Pattern 1: Simple API Token
- Pattern 2: OAuth Client Credentials
- Pattern 3: OAuth with Refresh Token
- Pattern 4: Custom Fields (Extend Core)
Check what tokenProfile.yml provides cat node_modules/@zerobias-org/types-core/schema/tokenProfile.yml Check what basicConnection.yml provides cat node_modules/@zerobias-org/types-core/schema/basicConnection.yml Check what baseConnectionState.yml provides cat node_modules/@zerobias-org/types-core/schema/baseConnectionState.yml
What does the connection-schema-design skill do?
Connection profile and state schema design rules and core profile selection
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill connection-schema-design-zerobias-org-module --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.