new-spec

Scaffold a design spec from the canonical SPEC template with pre-filled frontmatter.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Jennyfirrr/workspace-template --skill new-spec-jennyfirrr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: new-spec
Source: https://github.com/Jennyfirrr/workspace-template/tree/main/claude-skills/new-spec
Command: npx skills add https://github.com/Jennyfirrr/workspace-template --skill new-spec-jennyfirrr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Scaffolds a design spec from the canonical SPEC template to capture patterns before coding, ensuring consistency and decision traceability across projects.

Core Features & Use Cases

  • Pre-fills the mechanical frontmatter from the SPEC template and seeds the "sister_specs" field.
  • Surveys the existing spec cohort to decide whether to EXTEND a canonical sister or architect a new spec when needed.
  • Outputs a ready-to-author spec skeleton under DESIGN_SPECS_CATALOG_DIR with required sections left for human input.

Quick Start

Provide the pattern name and optional surface keywords to scaffold a new design-spec document from the canonical template.

Frequently Asked Questions about new-spec

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

FAQPage Schema
How do I scaffold a design spec document from a template?

Surveys existing spec cohorts to decide whether to extend a canonical sister or architect a new design spec. It validates frontmatter against the catalog, ensures required sections exist, and records cross-references to maintain decision traceability across projects.

How does a design spec template connect to related documentation?

A design spec template connects to related documentation by recording sister candidates and cross-references. It surveys the spec cohort to find canonical sisters and validates frontmatter against the catalog, ensuring all related docs link together for decision traceability.

Do I need a design specs catalog directory to write new specs?

Yes, writing new specs requires a design specs catalog directory. The tool writes the generated spec skeleton into DESIGN_SPECS_CATALOG_DIR and validates frontmatter against existing catalog records to maintain consistency across the spec cohort.

When should I extend an existing spec instead of creating a new one?

Extend an existing spec when the tool surveys the spec cohort and finds a suitable canonical sister. If no suitable sister exists in the catalog, it architects a new spec to capture the pattern, ensuring consistency and decision traceability before coding.

What is the pattern-codification lifecycle for design documentation?

The pattern-codification lifecycle is a project workflow that captures patterns before coding by scaffolding design specs. It ensures consistency and decision traceability by validating frontmatter against the catalog and recording cross-references across related docs.