spec

Generate TaskSpec, WorkstreamSpec, or MasterSpec documents from requirements.md.

Updated Mar 23, 2026
One-click install
npx skills add https://github.com/mattphanm/Codex-Agentic --skill spec-mattphanm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec
Source: https://github.com/mattphanm/Codex-Agentic/tree/main/.codex/skills/spec
Command: npx skills add https://github.com/mattphanm/Codex-Agentic --skill spec-mattphanm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Specifications are the authoritative contract that prevents scope creep and misinterpretation during implementation, aligning design, development, and testing from a single source of truth.

Core Features & Use Cases

  • Generates TaskSpec, WorkstreamSpec, or MasterSpec documents from gathered requirements.
  • Validates prerequisites (spec group directory, requirements.md, and manifest.json) and records decisions for traceability.
  • Supports a structured spec workflow from /prd to /spec, including requirements extraction, context/goal definition, risk/open questions, and task planning.
  • Useful for coordinating multi-workstream efforts via orchestrated specs with clear interfaces and acceptance criteria.

Quick Start

Follow the workflow by providing a spec group and requirements, then run the /spec command to generate the spec.md.

Frequently Asked Questions about spec

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

FAQPage Schema
How do I generate a specification document from gathered requirements?

To generate a specification document, provide a spec group and your requirements, then run the /spec command to produce a spec.md file. This creates an authoritative contract to prevent scope creep during implementation.

What is the best way to coordinate specifications across multiple workstreams?

Coordinating multi-workstream efforts requires orchestrated MasterSpec or WorkstreamSpec documents. These specifications establish clear interfaces and acceptance criteria across teams to prevent misinterpretation during development.

What prerequisites do I need to validate before drafting a task specification?

Before drafting a task specification, you must validate the existence of a spec group directory, a requirements.md file, and a manifest.json file. These prerequisites ensure structured workflow traceability and proper context.

How does a structured spec workflow prevent scope creep in software development?

A structured spec workflow prevents scope creep by enforcing requirements extraction, context definition, risk identification, and task planning. This process creates a single source of truth aligning design, development, and testing.

Can I record decisions and traceability context within my specification workflow?

Yes, the specification workflow explicitly records decisions and progress within the generated spec.md file. This structured approach ensures full traceability from initial requirements through final implementation and testing.