scaffold-design-spec

Create missing design-specification stub files for enabled catalog entries.

15|5|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/sohei56/maul-team --skill scaffold-design-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scaffold-design-spec
Source: https://github.com/sohei56/maul-team/tree/main/skills/scaffold-design-spec
Command: npx skills add https://github.com/sohei56/maul-team --skill scaffold-design-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the manual effort and inconsistency involved in creating design specification files for newly enabled catalog entries during sprint planning.

Core Features & Use Cases

  • Catalog-Driven Scaffolding: Reads enabled specification IDs and cross-references catalog metadata to determine categories, names, and granularity.
  • Structured Stub Creation: Generates correctly named files with required YAML frontmatter, revision history, and category-specific placeholder sections.
  • Idempotent Sprint Planning: Skips existing stubs, supports multi-instance specification types, and reports the files created for governance and handoff.
  • Use Case: When a sprint enables new product, documentation, or technology specifications, use this Skill to create all required design stubs before the sprint base is frozen.

Quick Start

Ask the scaffold-design-spec skill to create missing design specification stubs for the enabled catalog entries in the current sprint.

Frequently Asked Questions about scaffold-design-spec

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

FAQPage Schema
How do I create design specification stubs for newly enabled catalog entries during sprint planning?

Skipping existing stubs during specification scaffolding is an idempotent behavior that prevents data loss by preserving manually edited files. The process scans the catalog, identifies missing stubs, and only generates new design specification files while leaving existing ones untouched.

What is idempotent behavior in specification scaffolding and why does it matter?

Idempotent behavior in specification scaffolding means existing files are skipped to prevent overwriting previous work. This ensures that running the stub generation process multiple times during sprint planning will only create missing design specifications without altering or duplicating current ones.

How do I generate YAML frontmatter and revision history for design documentation automatically?

Yes, specification scaffolding supports multi-instance specification types for product, documentation, and technology categories. It cross-references catalog metadata to determine granularity and generates the appropriate stub structure for each enabled entry.

Does specification scaffolding support multi-instance specification types across product, documentation, and technology categories?

Yes, specification scaffolding supports multi-instance specification types across product, documentation, and technology categories. It cross-references catalog metadata to determine granularity and generates the appropriate stub structure for each enabled entry.

What metadata is required to scaffold design specification stubs for a sprint?

Scaffolding design specification stubs requires catalog metadata and sprint metadata to identify newly enabled entries. The system uses this information to generate correctly named files with complete YAML frontmatter and a report of created paths for governance.