openspec-plus-spec

Generates verified OpenSpec specification files through interactive analysis and Gherkin scenarios.

1|Updated Oct 27, 2025
One-click install
npx skills add https://github.com/WndDnz/modelo-relatorio-unifei-ict --skill openspec-plus-spec-wnddnz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-plus-spec
Source: https://github.com/WndDnz/modelo-relatorio-unifei-ict/tree/main/.opencode/skills/openspec-plus-spec
Command: npx skills add https://github.com/WndDnz/modelo-relatorio-unifei-ict --skill openspec-plus-spec-wnddnz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing software specifications often produces vague, untestable, or incomplete requirements that drift from the approved proposal. This Skill enforces a rigid four-phase workflow that turns an approved OpenSpec proposal into a complete, testable specification with Gherkin scenarios before any design or implementation begins. ## Core Features & Use Cases - Interactive Requirement Analysis: Runs a seven-step analysis (context, extraction, completeness, ambiguity, edge cases, stakeholders, scenarios) asking one question at a time so no gap is silently assumed. - Gherkin Scenario Enforcement: Requires every functional requirement to carry uppercase GIVEN/WHEN/THEN scenarios covering positive, negative, and edge cases. - Drift Check and Compliance Review: Verifies the spec against the proposal and design, then dispatches a single-shot reviewer subagent to catch placeholders, contradictions, and template violations. - Use Case: After approving an OpenSpec change proposal, run the spec phase to produce a specification where every requirement is testable, aligned with the proposal, and reviewed before design work starts. ## Quick Start Ask the AI to create the OpenSpec specification for the current approved change proposal and walk through the requirement analysis questions.

Frequently Asked Questions about openspec-plus-spec

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

FAQPage Schema
How do I write an OpenSpec specification from a proposal?

Run the spec phase after the proposal is approved. The skill resolves the template via the openspec CLI, then walks through requirement extraction, gap analysis, ambiguity resolution, and Gherkin scenario writing before producing the spec file.

What format do OpenSpec requirement scenarios use?

Scenarios use Gherkin syntax with uppercase GIVEN, WHEN, THEN keywords, plus AND and BUT only when natural. Every functional or behavioral requirement needs at least one scenario covering positive, negative, and edge cases.

Can the spec phase read source code for context?

Code reading is prohibited by default since specs describe what, not how. When a requirement explicitly references existing behavior, an explore subagent must be dispatched to report only observable behavior, never implementation details.

Does the spec skill work when a design document already exists?

Yes, it supports both proposal-spec-design and proposal-design-spec orderings. When a design exists, it is read as a constraint on acceptable spec language, and the spec must align with both proposal and design.

Why does the skill refuse to write the spec file immediately?

Writing before completing interactive analysis, user confirmation, and the drift check is a defined skill violation. The phased workflow prevents unverified assumptions and scope drift from propagating into design and implementation.