siade-sync-openapi-payloads

Generate and validate SIADE staging payloads against OpenAPI schemas with rspec.

13|8|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/datagouv/apistration --skill siade-sync-openapi-payloads
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: siade-sync-openapi-payloads
Source: https://github.com/datagouv/apistration/tree/main/mocks/.claude/skills/siade-sync-openapi-payloads
Command: npx skills add https://github.com/datagouv/apistration --skill siade-sync-openapi-payloads

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps ensure that staging payloads for SIADE OpenAPI endpoints stay in sync with the latest API specs by detecting gaps, generating missing payloads that conform to the schema, and validating them with the test suite.

Core Features & Use Cases

  • Detect missing or outdated payload folders by comparing OpenAPI operationIds against existing payloads.
  • Generate schema-compliant payload files for new endpoints to speed up integration testing.
  • Validate payloads with rspec to ensure full OpenAPI compatibility during CI or local development.

Quick Start

Trigger the sync workflow to align all staging payload folders with the latest OpenAPI specs and run the tests.

Frequently Asked Questions about siade-sync-openapi-payloads

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

FAQPage Schema
How do I keep staging API payloads in sync with OpenAPI specifications?

To keep staging API payloads in sync with OpenAPI specifications, compare operationIds against existing payload folders to detect gaps, generate schema-compliant payloads, and validate them using rspec tests.

How do I generate missing OpenAPI payloads for new API endpoints?

Generate missing OpenAPI payloads by applying the latest API specs to create new payload files that match the OpenAPI schemas, ensuring they are ready for immediate integration testing.

Can I validate OpenAPI payload changes using rspec in my test suite?

Yes, you can validate OpenAPI payload changes using rspec in your test suite to ensure full compatibility with the latest schemas during local development or CI pipelines.

What is the best way to detect outdated payload folders for SIADE endpoints?

The best way to detect outdated payload folders for SIADE endpoints is to compare OpenAPI operationIds against existing staging payloads to identify and resolve coverage gaps.

Why does my API testing fail when OpenAPI schemas are updated?

API testing fails when OpenAPI schemas are updated if staging payloads become outdated. Resolving this requires synchronizing the payload folders with the latest specs and verifying them with rspec.