sds-yaml

Author SDS YAML documents mapping to SEA-DSL for domain models and CQRS operations.

1|Updated Oct 1, 2025
One-click install
npx skills add https://github.com/GodSpeedAI/SEA --skill sds-yaml
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sds-yaml
Source: https://github.com/GodSpeedAI/SEA/tree/main/.claude/skills/sds-yaml
Command: npx skills add https://github.com/GodSpeedAI/SEA --skill sds-yaml

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

SDS YAML authoring for SEA-DSL enables machine-readable service design specs and smooth transition to code generation by standardizing the SDS structure and validation workflow.

Core Features & Use Cases

  • Schema-aligned SDS authoring: Create SDS YAML files that map to SEA-DSL flows for domain models, CQRS operations, ports, and runtime configuration.
  • Validation-ready templates: Includes guidance to validate against the SDS schema and ensure CQRS completeness and SEA-DSL alignment.
  • Use Case: Designers define a service's contracts once, then generate consistent implementation scaffolds and documentation.

Quick Start

  1. Create a file named service.sds.yaml using the SDS template.
  2. Fill required fields under sds: id, bounded_context, version, and status, and provide domain, cqrs, events, ports, and runtime as needed.
  3. Run the validator to ensure schema conformity: tools/validate_sds.py path/to/service.sds.yaml and then verify SEA-DSL alignment with your flows.

Frequently Asked Questions about sds-yaml

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

FAQPage Schema
How do I author SDS YAML for SEA-DSL domain models and CQRS operations?▼

To author SDS YAML for SEA-DSL domain models and CQRS operations, create a service.sds.yaml file using the SDS template and fill in required fields like id, bounded_context, version, and status under the sds block, then provide domain, cqrs, events, and ports configurations as needed.

What is the best way to validate SDS YAML schema compliance before code generation?▼

Validating SDS YAML schema compliance before code generation involves running the validator tool, specifically tools/validate_sds.py path/to/service.sds.yaml, to ensure schema conformity and verify SEA-DSL alignment with your configured flows.

Do I need bounded context and CQRS definitions to generate a service design spec?▼

Yes, bounded context and CQRS definitions are required to generate a service design spec. You must fill required fields under sds including id, bounded_context, version, and status, and provide domain, cqrs, events, ports, and runtime configurations to enable validation and consistent implementation scaffolds.

Why does my SDS YAML fail validation against the SEA-DSL schema?▼

SDS YAML validation against the SEA-DSL schema fails when required fields like id, bounded_context, version, or status are missing, or when the defined domain models, CQRS operations, ports, and runtime configuration lack schema conformity and SEA-DSL alignment.

Can I use SDS YAML to define runtime configuration and ports for SEA-Forge services?▼

Yes, you can use SDS YAML to define runtime configuration and ports for SEA-Forge services. The SDS template allows you to specify ports and runtime configurations alongside domain models and CQRS operations to generate consistent implementation scaffolds.