sdd-component-spec

Create OpenSpec Component Implementation Specs with source declarations and gate checks.

Updated Feb 17, 2026
One-click install
npx skills add https://github.com/javierhbr/random-poc --skill sdd-component-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-component-spec
Source: https://github.com/javierhbr/random-poc/tree/main/sdd-mcp/sdd-mcp/mnt/user-data/outputs/sdd-agent/skills/sdd-component-spec
Command: npx skills add https://github.com/javierhbr/random-poc --skill sdd-component-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill guides engineers and tech leads through creating a correct, OpenSpec-compliant Component Implementation Spec, ensuring services accurately reflect platform intentions.

Core Features & Use Cases

  • Component Spec Creation: Assists in defining HOW a service implements platform specifications.
  • Source Declaration: Enforces referencing platform and domain MCPs for all spec sections, preventing invention.
  • Gate Checks: Provides a structured checklist to ensure spec completeness, domain validity, integration safety, NFR compliance, and readiness for implementation.
  • Use Case: A component team engineer receives a fan-out task from the Platform Repo and needs to document how their service will implement the platform's requirements. They use this skill to generate the Component Spec, ensuring all necessary sections and sources are included.

Quick Start

Use the sdd-component-spec skill to help me write my component spec for PLAT-124 v1.

Frequently Asked Questions about sdd-component-spec

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

FAQPage Schema
How do I write a component implementation spec for platform requirements?

To write a component implementation spec, you define how your service implements platform specifications by declaring mandatory source references and passing structural gate checks. This ensures your service accurately reflects platform intentions and adheres to domain invariants.

What is an OpenSpec component implementation spec used for?

An OpenSpec component implementation spec is used to document how a specific service implements platform-level requirements. It defines the service-level how-to implementation derived from platform specs, ensuring integration contracts and domain invariants are strictly followed.

How do I ensure my component spec includes all necessary platform sources?

To ensure your component spec includes necessary platform sources, you must enforce referencing platform and domain MCPs for all spec sections. This mandatory source declaration prevents inventing requirements and maintains alignment with platform specifications.

Can I use this to document service-level implementation for a fan-out task?

Yes, you can use this to document service-level implementation for a fan-out task. When a component team engineer receives a fan-out task from the Platform Repo, this skill guides them to generate the complete Component Spec with all necessary sections and sources included.

What gate checks are required for OpenSpec component spec approval and readiness?

Gate checks for OpenSpec component spec approval and readiness include a structured checklist verifying spec completeness, domain validity, integration safety, and NFR compliance. These checks ensure the spec is fully prepared before actual implementation begins.

Does writing a component spec require referencing domain MCPs?

Yes, writing a component spec requires referencing domain MCPs. The skill enforces mandatory source declarations that reference both platform and domain MCPs across all spec sections to prevent inventing unverified requirements.