sdd-init

Initialize Spec-Driven Development directories and generate a tailored openspec/config.yaml.

Updated Feb 21, 2026
One-click install
npx skills add https://github.com/josemartinrodriguezmortaloni/opencode-config --skill sdd-init-josemartinrodriguezmortaloni
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-init
Source: https://github.com/josemartinrodriguezmortaloni/opencode-config/tree/main/skill/sdd-init
Command: npx skills add https://github.com/josemartinrodriguezmortaloni/opencode-config --skill sdd-init-josemartinrodriguezmortaloni

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the setup of the openspec/ directory and its essential configuration files, streamlining the initialization process for Spec-Driven Development (SDD) in any project.

Core Features & Use Cases

  • Automated Directory Creation: Initializes the openspec/, specs/, and changes/ directories.
  • Context-Aware Configuration: Generates a config.yaml file tailored to the project's detected tech stack, architecture, testing, and linting conventions.
  • Use Case: When starting a new project or adopting SDD for an existing one, use this Skill to quickly establish the foundational structure and configuration, ensuring consistency and adherence to SDD principles from the outset.

Quick Start

Run the sdd-init skill to bootstrap the openspec directory for this project.

Frequently Asked Questions about sdd-init

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

FAQPage Schema
What is spec-driven development and how does it structure a project?

Spec-driven development (SDD) structures a project by defining specifications before implementation. This Skill initializes the openspec directory, creating specs and changes folders to manage project requirements and modifications systematically.

How do I initialize an openspec configuration for my existing project?

To initialize openspec configuration, run the sdd-init Skill. It detects your project's tech stack, architecture, and testing conventions to automatically generate a tailored openspec/config.yaml file and the required directory structure.

Can I set up spec-driven development folders for any tech stack?

Yes, you can set up SDD folders for any tech stack. The initialization process detects your project context, including architecture and linting conventions, to generate a tailored configuration file that matches your specific environment.

Does the openspec config.yaml generation support custom linting and testing conventions?

The openspec config.yaml generation automatically detects and supports your project's existing testing and linting conventions. It scans your project context to ensure the generated configuration aligns with your specific development standards.

What directories are required for spec-driven development initialization?

Spec-driven development initialization requires three main directories: openspec/, openspec/specs/, and openspec/changes/. The Skill automatically creates these folders to store configuration, specifications, and change logs respectively.

Why use an automated scaffolding tool for spec-driven development instead of manual setup?

Using automated scaffolding for spec-driven development ensures consistent directory structure and context-aware configuration generation. It eliminates manual setup errors, detects project conventions instantly, and establishes a standardized openspec environment across different projects.