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.