aibdd-form-api-spec

Converts AIBDD inference packages into boundary-aware OpenAPI 3.x YAML contract files.

77|15|Updated May 12, 2026
One-click install
npx skills add https://github.com/Waterball-Software-Academy/aixbdd --skill aibdd-form-api-spec-waterball-software-academy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: aibdd-form-api-spec
Source: https://github.com/Waterball-Software-Academy/aixbdd/tree/main/.agents/skills/aibdd-form-api-spec
Command: npx skills add https://github.com/Waterball-Software-Academy/aixbdd --skill aibdd-form-api-spec-waterball-software-academy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It converts an AIBDD inference package into boundary-aware OpenAPI 3.x YAML files so your acceptance requirements become enforceable API contracts.

Core Features & Use Cases

  • OpenAPI 3.x YAML generation by slice_list: Produces one or more YAML outputs per Planner-provided slice strategy, plus shared common.yml schema patterns.
  • Boundary-safe mapping: Maps each inferred endpoint to an exact REST path and HTTP method without making cross-boundary decisions.
  • Correct cross-file $ref + error schema alignment: Writes modular $ref links and standardizes error responses via ErrorResponse in common.yml.
  • Guardrails for contract correctness: Asserts target_path follows the ${CONTRACTS_DIR} flat directory constraint and fails fast to prompt Planner repair when violated.

Quick Start

Ask the AI to delegate aibdd-form-api-spec with a complete inference package and a Planner-provided slice_list so it outputs N OpenAPI .yml files into ${CONTRACTS_DIR}.

Frequently Asked Questions about aibdd-form-api-spec

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

FAQPage Schema
How do I generate OpenAPI 3.x YAML contracts from an inference package?▼

To generate OpenAPI 3.x YAML contracts, you provide an inference package and a Planner-provided slice list to produce modular YAML files with standardized error schemas in your target contracts directory.

How does boundary-aware planning work when mapping API endpoints to REST paths?▼

Boundary-aware planning maps each inferred endpoint to an exact REST path and HTTP method while preserving boundary-scope ownership, ensuring no cross-boundary decisions are made during the API contract generation.

How do I split a large OpenAPI specification into modular YAML files using a slice list?▼

You can split a large OpenAPI specification by using a Planner-provided slice list to generate per-slice YAML files that utilize correct cross-file $ref links and shared common.yml schema patterns.

What happens if my generated OpenAPI target_path violates the flat directory constraint?▼

If the target_path violates the flat directory constraint, the generation fails fast and prompts the Planner for repair, enforcing strict target_path assertions to maintain contract correctness.

Do I need a Planner to standardize ErrorResponse schemas in OpenAPI YAML generation?▼

You need a Planner to provide the slice list for splitting outputs, while the generation process automatically standardizes ErrorResponse usage via common.yml to align error schemas across files.

Why does my OpenAPI YAML generation fail when the input slice list is incomplete?▼

Generation fails on incomplete input because the tool enforces target_path assertions and requires a complete Planner-provided slice list, falling back to the Planner for repair when input is incomplete.