gsd-spec-phase

Generate SPEC.md documents with ambiguity scoring for project phases.

Updated Mar 23, 2026
One-click install
npx skills add https://github.com/roycolumbia-code/claude-global-config --skill gsd-spec-phase-roycolumbia-code
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-spec-phase
Source: https://github.com/roycolumbia-code/claude-global-config/tree/main/skills/_audit-disabled-20260706-1136/gsd-spec-phase
Command: npx skills add https://github.com/roycolumbia-code/claude-global-config --skill gsd-spec-phase-roycolumbia-code

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the process of specifying phases in a project with ambiguity scoring, producing a SPEC.md document that clarifies the deliverables before the discussion phase.

Core Features & Use Cases

  • Automated Phase Specification: Generates a SPEC.md document that outlines the deliverables of a phase with ambiguity scoring.
  • Socratic Interview Loop: Conducts a structured Socratic interview loop to refine phase requirements.
  • Ambiguity Scoring: Scores ambiguity across weighted dimensions after each round of the interview loop.
  • Output SPEC.md: Produces a SPEC.md document with falsifiable requirements that locks "what/why" before the discussion phase.

Quick Start

Run the gsd-spec-phase skill with the phase number you want to specify, e.g., gsd-spec-phase 1.

Frequently Asked Questions about gsd-spec-phase

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

FAQPage Schema
How do I automate phase specification and generate a SPEC.md document for my project?

Automating phase specification involves running a structured Socratic interview loop to refine requirements, which then generates a SPEC.md document with falsifiable deliverables and ambiguity scoring for your project phase.

What is ambiguity scoring in project management specifications?

Ambiguity scoring in project management specifications evaluates requirements across weighted dimensions during an interview loop, ensuring deliverables are clearly defined and falsifiable before moving to the discussion phase.

How do I conduct a Socratic interview loop to clarify project phase deliverables?

To conduct a Socratic interview loop for phase deliverables, execute the specification workflow with your phase context files, allowing the system to ask structured questions and score ambiguity until requirements are locked.

Do I need phase context files to run automated specification generation?

Yes, phase context files and workflow execution are required to run automated specification generation, as they provide the necessary inputs for the Socratic questioning loop and ambiguity scoring process.

When should I use an automated specification document instead of manual project planning?

Use an automated specification document when you need to lock the 'what and why' of project phases early, ensuring falsifiable requirements and reducing ambiguity before entering the discussion phase.

Can I specify a specific project phase number for automated SPEC.md generation?

Yes, you can specify a particular project phase number for automated SPEC.md generation by passing the phase number as an argument when executing the specification workflow command.