external-spec-integration

Transform external specifications into classified tech-context and workflow items.

39|3|Updated Nov 21, 2025
One-click install
npx skills add https://github.com/LiorCohen/sdd --skill external-spec-integration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: external-spec-integration
Source: https://github.com/LiorCohen/sdd/tree/main/plugin/core/skills/external-spec-integration
Command: npx skills add https://github.com/LiorCohen/sdd --skill external-spec-integration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

External specifications often arrive without complete technical details, making it hard to integrate them into a structured development workflow. This skill automates ingestion by transforming the external spec into a classified tech-context, archiving it for audit, and preparing actionable items for the SDD pipeline.

Core Features & Use Cases

  • Transformation & Classification: convert an external spec into structured domain, gaps, and requirements before decomposition.
  • Component Discovery: identify required system components to scope implementation.
  • Decomposition & Context: generate hierarchical workflow items and create per-leaf context files for solicitation.
  • Archival & Audit: archive the original spec to a dedicated archive folder for traceability.
  • Workflow Integration: create and organize items under sdd/workflows and ensure alignment with API-first ordering.

Quick Start

Provide an external specification file to trigger transformation, discovery, and workflow item creation in the SDD system.

Frequently Asked Questions about external-spec-integration

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

FAQPage Schema
How do I turn an external specification into actionable workflow items?

To turn an external specification into actionable items, import the spec file using the /sdd import command. The skill transforms it into classified tech-context, discovers components, and decomposes the spec into hierarchical workflow items.

What is the best way to classify external specs missing technical details?

The best way to classify external specs missing technical details is to import them into the SDD system. The skill automatically transforms the document into structured domains, gaps, and requirements before decomposing it.

How does spec decomposition work for API-first development workflows?

Spec decomposition for API-first workflows works by analyzing the imported external spec, identifying required system components, and generating hierarchical workflow items organized under sdd/workflows with API-first ordering alignment.

Do I need a specific file path to import an external spec?

Yes, you need a specific file path to import an external spec. The skill requires a spec path pointing to the external file and a target workspace to successfully archive the original and generate workflow items.

Can I archive original specifications for auditing after decomposition?

Yes, you can archive original specifications for auditing. During import, the skill archives the original spec to a dedicated archive folder for traceability and returns the archived path alongside the created workflow items.

Why are per-leaf context files generated during spec decomposition?

Per-leaf context files are generated during spec decomposition to provide specific technical context for each leaf-level workflow item. This ensures accurate solicitation and drives the SDD pipeline effectively.