oc-api-dev

Design and build APIs with OpenAPI/GraphQL specifications and SDK generation.

Updated May 15, 2026
One-click install
npx skills add https://github.com/asfbay-bit/opchain-skills --skill oc-api-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oc-api-dev
Source: https://github.com/asfbay-bit/opchain-skills/tree/main/skills/oc-api-dev
Command: npx skills add https://github.com/asfbay-bit/opchain-skills --skill oc-api-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill simplifies the process of designing and building APIs with strict schema parity, robust versioning, and comprehensive lifecycle management, saving time and reducing errors in the development process.

Core Features & Use Cases

  • API Design & Build Harness: Full-cycle support from design, schema-to-code parity, versioning, SDK generation, and documentation.
  • Versioning & Deprecation: Automated version planning, deprecation notifications, and migration guidance.
  • Idempotency & Error Handling: Ensures consistent responses for repeatable requests and standardized error handling.
  • Use Case: Designing a new API for a web application that requires OpenAPI/GraphQL schema definition, SDK generation, and robust testing.

Quick Start

Use the /oc-api design command to start the API design process for your new project.

Frequently Asked Questions about oc-api-dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design and build an API with OpenAPI or GraphQL schema parity?

API development with schema parity is handled by designing OpenAPI or GraphQL specifications and enforcing schema-to-code consistency. This Skill manages the full lifecycle from design through testing, SDK generation, and documentation.

What's the best way to plan API versioning and deprecation for a web application?

API versioning and deprecation are managed through automated version planning, deprecation notifications, and migration guidance. This ensures robust lifecycle management and consistent behavior across API updates.

How do I generate an SDK from my API schema?

SDK generation is performed directly from your OpenAPI or GraphQL schema definitions. The Skill enforces schema-to-code parity to ensure the generated SDKs match your first-party API specifications accurately.

How does idempotency and error handling work during API development?

Idempotency and error handling are enforced by ensuring consistent responses for repeatable requests and standardizing error outputs. This reduces errors and maintains reliable API behavior during the development lifecycle.

Can I use this for third-party API integrations and external services?

Third-party API integrations require coordination with the oc-integrations-engineer skill. This Skill focuses strictly on first-party API development, handling design, versioning, and SDK generation for your internal services.

When do I need to start the API design process for a new project?

API design for a new project starts by using the design command to initiate the process. It supports defining OpenAPI or GraphQL schemas, generating SDKs, and establishing robust testing from the beginning.