skills.rest
Darkbluelr
DarkbluelrCOMMUNITY
Explore all skills by this author →
GitHub

devbooks-spec-contract

Generate and validate API and schema contract artifacts with contract tests.

84|6|Updated Jan 12, 2026
Search Tags:#requirements#specifications#contract-testing#api-design#acceptance-tests#schema-compatibility
One-click install
npx skills add https://github.com/Darkbluelr/dev-playbooks-cn --skill devbooks-spec-contract
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: devbooks-spec-contract
Source: https://github.com/Darkbluelr/dev-playbooks-cn/tree/main/skills/devbooks-spec-contract
Command: npx skills add https://github.com/Darkbluelr/dev-playbooks-cn --skill devbooks-spec-contract

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, jq, and includes scripts (resource) and references (resource) components.

What problem does it solve?

DevBooks provides a unified approach to defining external behavior specifications and contracts (Requirements/Scenarios/API/Schema/compatibility strategy/migration) and generating contract tests. It merges the functionality of the original spec-delta and contract-data features into a single workflow, ensuring auditable, versioned artifacts for interface agreements and their verification.

Core Features & Use Cases

  • Unified Spec & Contract: Define, version, and validate API and data contract artifacts in one place.
  • Automation Ready: Produces spec deltas and contract tests that integrate with existing workflows.
  • Guided Workflows: Supports end-to-end flows from spec definition to testing and migration planning.

Quick Start

Provide a spec delta and a contract test plan for the change.

Frequently Asked Questions about devbooks-spec-contract

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

FAQPage Schema
How do I define API specifications and generate contract tests for schema compatibility?▼

Contract testing for microservices stabilizes interoperability by defining external behavior specifications and generating executable contract tests. This validates interface agreements and schema compatibility between separate services.

How do I generate a spec delta for API requirements and scenarios?▼

To generate a spec delta, you define external behavior specifications and merge them with contract data capabilities. This produces auditable, versioned artifacts that capture API requirement and scenario modifications.

Do I need git and jq installed to validate OpenAPI schema compatibility?▼

Yes, git and jq are required dependencies for validating OpenAPI schema compatibility. These tools support the scripts and references components that execute the spec delta and contract test generation workflows.

What is the best way to manage data contract migration and versioning?▼

The best way to manage data contract migration uses a unified workflow to define, version, and validate API artifacts in one place. This guides end-to-end flows from spec definition to testing and migration planning.

Can I integrate contract test plans with my existing CI/CD workflows?▼

Yes, contract test plans integrate with existing workflows by producing automation-ready spec deltas and executable tests. These generated artifacts validate interface agreements and run within standard CI/CD pipelines.

When do I need to define external behavior specifications for service interoperability?▼

External behavior specifications are needed when stabilizing interoperability between services requires auditable, versioned interface agreements. Defining these contracts ensures schema compatibility and validates communication boundaries.

Related Skills

Explore More Software Engineering Skills→
juanca202juanca202

speckit-git-initialize

Initialize a Git repository for spec-kit project structures with a single script.

Community
Basic
heaptracetechnologyheaptracetechnology
13

contract-test

Automate API contract testing with schema validation and OpenAPI checks.

Community
Advanced
jakossjakoss

convex

Standardize Convex back-end code with function syntax, validators, and schema conventions.

Community
Advanced
zinohomezinohome
1

contract-testing-builder

Implements API contract testing using Pact or OpenAPI specifications.

Community
Advanced