gsd-spec-phase

Generate a SPEC.md document with ambiguity scoring for phase deliverables.

Updated May 3, 2026
One-click install
npx skills add https://github.com/ThiagoVitale/endless-crystal --skill gsd-spec-phase-thiagovitale
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-spec-phase
Source: https://github.com/ThiagoVitale/endless-crystal/tree/main/.codex/skills/gsd-spec-phase
Command: npx skills add https://github.com/ThiagoVitale/endless-crystal --skill gsd-spec-phase-thiagovitale

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill aids in clarifying the deliverables of a phase with ambiguity scoring, generating a SPEC.md before the discuss-phase.

Core Features & Use Cases

  • Ambiguity Scoring: Score ambiguity across 4 weighted dimensions after each round.
  • SPEC.md Generation: Produces a SPEC.md document with falsifiable requirements.
  • Use Case: Utilize this Skill to ensure that the what/why aspects of a phase are well-defined before moving into the discuss-phase, locking in critical details.

Quick Start

Execute the gsd-spec-phase skill with --auto to skip interactive questions and write SPEC.md with recommended defaults.

Frequently Asked Questions about gsd-spec-phase

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

FAQPage Schema
How do I generate a SPEC.md with structured requirements for software development?

To generate a SPEC.md with structured requirements, you can execute the skill with the `--auto` flag to skip interactive questions and automatically write the document using recommended defaults for your software development workflow.

What is ambiguity scoring and how does it validate phase deliverables?

Ambiguity scoring evaluates phase deliverables across four weighted dimensions after each clarification round, providing quantitative analysis to ensure phase requirements are falsifiable and well-defined before moving to the next development phase.

When do I need to define phase deliverables before transitioning to the discuss-phase?

You need to define phase deliverables when the what and why aspects of a phase are unclear, locking in critical details through ambiguity scoring to ensure structured requirements are validated before transitioning into the discuss-phase.

Can I skip interactive prompts and automatically produce a SPEC.md with default settings?

Yes, you can skip interactive prompts by executing the skill with the `--auto` flag, which writes the SPEC.md document directly using recommended defaults instead of requiring manual input for each clarification question.

Does ambiguity scoring work for validating falsifiable requirements in software development workflows?

Yes, ambiguity scoring works by applying quantitative analysis across four weighted dimensions to validate that your phase deliverables contain falsifiable requirements before they are locked into the SPEC.md document.

What are the limitations of using auto-generated defaults for phase deliverable clarification?

Using the `--auto` flag skips the interactive clarification process, meaning the generated SPEC.md relies entirely on recommended defaults without the iterative ambiguity scoring rounds that help reduce uncertainty in complex phase requirements.