spec-design

Generate design.md and tasks.md artifacts for software development projects.

1|Updated Dec 14, 2025
One-click install
npx skills add https://github.com/komluk/scaffolding.template --skill spec-design-komluk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-design
Source: https://github.com/komluk/scaffolding.template/tree/main/stacks/_common/.claude/skills/spec-design
Command: npx skills add https://github.com/komluk/scaffolding.template --skill spec-design-komluk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the creation of detailed technical specifications and implementation task lists, ensuring clarity and completeness in project design.

Core Features & Use Cases

  • Design Document Generation: Creates design.md outlining context, goals, specifications, decisions, risks, and migration plans.
  • Task List Creation: Generates tasks.md with a structured, actionable checklist for implementation.
  • Use Case: When starting a new feature, use this Skill to generate the foundational design.md and tasks.md files, ensuring all aspects from requirements to implementation steps are clearly defined and organized.

Quick Start

Generate the design.md and tasks.md files for a new feature based on the proposal.md.

Frequently Asked Questions about spec-design

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

FAQPage Schema
How do I generate design and task specifications for software development?

To generate software development specifications, use a tool that creates design.md and tasks.md artifacts. It enforces structured documentation with context, goals, specifications, risks, and a dependency-ordered actionable checklist with file paths and acceptance criteria.

What should be included in a design.md file for a new feature?

A design.md file should include structured documentation outlining context, goals, specifications, decisions, risks, and migration plans. This ensures all aspects of project design are clearly defined and organized before implementation begins.

How do I create a dependency-ordered task list for implementation?

Creating a dependency-ordered task list involves generating a tasks.md file with an actionable checklist. It maps out implementation steps by including specific file paths and acceptance criteria to guide the development workflow.

Can I use OpenSpec to enforce specific formatting rules for requirements and scenarios?

Yes, OpenSpec enforces specific formatting rules for requirements, scenarios, and tasks. It also enforces path configurations for the specs_path to maintain consistency across your software development documentation.

Do I need a proposal.md to start generating technical specifications?

Starting the specification generation process typically uses a proposal.md as the foundational input. This allows the system to automatically generate the corresponding design.md and tasks.md files based on the proposed feature.

What is the best way to structure implementation tasks with file paths and acceptance criteria?

The best way to structure implementation tasks is to generate a tasks.md file with a dependency-ordered, actionable checklist. This file explicitly maps each task to specific file paths and acceptance criteria for clear development tracking.