Run any Skill in Manus with one click

openapi-spec-design-first-apis

Stars2

Forks1

UpdatedFebruary 1, 2026 at 18:15

[STUB - Not implemented] OpenAPI 3.1.0 design-first API specifications as single source of truth. PROACTIVELY activate for: [TODO: Define on implementation]. Triggers: [TODO: Define on implementation]

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

Agentient

Agentient/vibekit

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

SKILL.md

readonly

name	openapi-spec-design-first-apis
version	0.1
description	[STUB - Not implemented] OpenAPI 3.1.0 design-first API specifications as single source of truth. PROACTIVELY activate for: [TODO: Define on implementation]. Triggers: [TODO: Define on implementation]
core-integration	{"techniques":{"primary":["[TODO]"],"secondary":[]},"contracts":{"input":"[TODO]","output":"[TODO]"},"patterns":"[TODO]","rubrics":"[TODO]"}

OpenAPI Spec Design-First APIs

STUB: This skill is not yet implemented

This placeholder preserves the documented plugin structure. See parent plugin README for planned capabilities.

Planned Capabilities

Design-First Approach: API specification before implementation
OpenAPI 3.1.0 Compliance: Latest specification features
Schema component reuse and references
Request/response examples
Authentication scheme definitions
API versioning strategies

Example Structure

openapi: 3.1.0
info:
  title: User API
  version: 1.0.0
paths:
  /users:
    get:
      summary: List users
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/User'

Anti-Patterns

API implementation before specification
Inconsistent error response formats
Missing authentication documentation

Implementation Status

Core implementation
References documentation
Output templates
Integration tests

More from this repository

same repository

consolidate-research

Agentient/vibekit

Consolidate and synthesize research outputs from multiple AI models or sources into a unified, pattern-aware, provenance-enriched report with quality metrics. Use when the user has research outputs to consolidate, wants to synthesize multiple reports, asks to "consolidate", "synthesize", or "merge" research findings, or needs to reconcile conflicting information from different sources. Works with outputs from Claude, Gemini, GPT-5.2, or any combination of AI/human sources. Supports manifest-driven (from create-research-brief) and standalone operation.

2026-03-042

create-research-brief

Agentient/vibekit

Designs multi-model AI research strategies across 9 research patterns for Claude Opus 4.6, Gemini 3.1 Pro Deep Research, and optionally GPT-5.2 Deep Research (with site restrictions and mid-session intervention) or GPT-5.2 Chat. Generates copy-pasteable prompts optimized per model with pattern-aware role assignment, a consolidation manifest for downstream synthesis, and a merge prompt for consolidating outputs. Accepts Research Request Specification from research-interviewer upstream. Triggers on "create research brief", "research plan", "multi-model research", "research prompts for Claude/Gemini/OpenAI", "design research strategy", "consolidate research outputs", "synthesize research results", "research best practices for...", "best practices for [technology]", "create a best practices guide for...", "research [technology] patterns", "document [technology] best practices", "compare X vs Y", "landscape of [domain]", "compliance requirements for [topic]", "ROI analysis for [decision]". Modes: DUAL (Claude+Gemi

2026-03-042

create-documentation

Agentient/vibekit

Generate reader-centered documentation aligned with the Diátaxis framework and optimized for cognitive load management. Creates tutorials, how-to guides, explanations, and reference documentation with multi-layer quality validation. PROACTIVELY activate for: (1) Write tutorials for learning new skills, (2) Create how-to guides for specific tasks, (3) Write explanations for understanding concepts, (4) Generate reference documentation for APIs or features, (5) Document systems, features, or processes, (6) Create user guides or onboarding documentation. Triggers: "write documentation for", "create docs", "document this", "write a tutorial for", "how-to guide for", "explain [concept]", "reference documentation for", "API docs for", "user guide for", "document the", "create documentation"

2026-02-012

architecture-doc-auditor

Agentient/vibekit

Systematic completeness audit of Architecture Documentation using 188-item viewpoint-based checklist, severity-classified gap detection, technical debt indicators, and architecture anti-pattern scanning. Supports TOGAF, C4, arc42, and IEEE 42010 frameworks. PROACTIVELY activate for: (1) Architecture review gates, (2) ADR validation before implementation, (3) C4 diagram completeness check, (4) Technical debt assessment, (5) Pre-implementation validation, (6) Governance compliance audit, (7) Design doc handoff review. Triggers: "audit architecture", "review ADR", "check architecture doc", "validate design doc", "architecture review", "audit C4 diagrams", "check system context", "technical debt assessment", "architecture health check", "governance review", "architecture completeness"

2026-02-012

assumption-validator

Agentient/vibekit

Systematically surface, classify, and stress-test assumptions in decisions, strategies, and plans. Transforms hidden assumptions into visible, testable propositions with load-bearing analysis and counterfactual validation. PROACTIVELY activate for: (1) Pre-commitment decision reviews, (2) Strategy validation before execution, (3) Investment due diligence, (4) Architecture decision records, (5) Product direction pivots, (6) Risk assessments requiring assumption audit. Triggers: "validate assumptions", "test assumptions", "assumption check", "stress test this decision", "what are we assuming", "pre-mortem", "what could go wrong", "challenge this plan", "devil's advocate"

2026-02-012

compare-options

Agentient/vibekit

Multi-expert comparison and ranking of options with structured deliberation. PROACTIVELY activate for: (1) decision making between alternatives, (2) trade-off analysis, (3) option evaluation, (4) vendor/tool comparison, (5) strategy selection. Triggers: "compare options", "evaluate alternatives", "rank options", "which should I choose", "compare these", "trade-off analysis", "decision between"

2026-02-012

name	openapi-spec-design-first-apis
version	0.1
description	[STUB - Not implemented] OpenAPI 3.1.0 design-first API specifications as single source of truth. PROACTIVELY activate for: [TODO: Define on implementation]. Triggers: [TODO: Define on implementation]
core-integration	{"techniques":{"primary":["[TODO]"],"secondary":[]},"contracts":{"input":"[TODO]","output":"[TODO]"},"patterns":"[TODO]","rubrics":"[TODO]"}

OpenAPI Spec Design-First APIs

STUB: This skill is not yet implemented

This placeholder preserves the documented plugin structure. See parent plugin README for planned capabilities.

Planned Capabilities

Design-First Approach: API specification before implementation
OpenAPI 3.1.0 Compliance: Latest specification features
Schema component reuse and references
Request/response examples
Authentication scheme definitions
API versioning strategies

Example Structure

openapi: 3.1.0
info:
  title: User API
  version: 1.0.0
paths:
  /users:
    get:
      summary: List users
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/User'

Anti-Patterns

API implementation before specification
Inconsistent error response formats
Missing authentication documentation

Implementation Status

Core implementation
References documentation
Output templates
Integration tests