steroid-specify

Generate a formal specification document from a markdown vibe file.

3|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/nzkbuild/steroid-workflow --skill steroid-specify
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: steroid-specify
Source: https://github.com/nzkbuild/steroid-workflow/tree/main/skills/steroid-specify
Command: npx skills add https://github.com/nzkbuild/steroid-workflow --skill steroid-specify

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires steroid-run.cjs, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill transforms vague user ideas captured in vibe.md into a structured, formal specification with clear, testable acceptance criteria, ensuring that development is precise and requirements are not missed.

Core Features & Use Cases

  • Specification Generation: Converts natural language descriptions into detailed user stories and acceptance criteria.
  • Testability Enforcement: Mandates binary pass/fail criteria for all requirements.
  • Constraint Adherence: Ensures all hard constraints from the vibe are carried over verbatim.
  • Use Case: After an AI captures a user's request for a new feature in vibe.md, this Skill automatically generates a spec.md file that outlines exactly what needs to be built and how to test it, preparing it for the research phase.

Quick Start

Use the steroid-specify skill to generate a formal specification from the vibe file.

Frequently Asked Questions about steroid-specify

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

FAQPage Schema
How do I convert natural language ideas into testable acceptance criteria?

To convert natural language ideas into testable acceptance criteria, you can use a specification generation process that parses a markdown file containing user vibes and outputs a formal spec document with binary pass/fail criteria.

What is the best way to formalize user stories for software development?

Formalizing user stories for software development involves transforming vague ideas into a structured specification document, ensuring that all requirements have defined acceptance criteria and hard constraints for precise implementation.

How does specification generation enforce testability in requirements?

Specification generation enforces testability by mandating binary pass/fail criteria for all requirements extracted from the initial user description, ensuring every defined user story is verifiable during development.

Can I use markdown files to define hard constraints for my software specs?

Yes, you can use markdown files to define hard constraints for software specs. The specification process captures these constraints verbatim from the markdown input and carries them directly into the formal specification document.

Do I need a specific markdown file format to generate user stories and acceptance criteria?

You need a markdown file, typically named vibe.md, containing the captured natural language user request. This file serves as the input for generating the detailed user stories and acceptance criteria in the output specification.

Why does my software specification miss scope boundaries during development?

Your software specification may miss scope boundaries if the initial ideas are not formalized into clear, testable acceptance criteria. Generating a formal specification ensures the scope is clearly defined and all requirements are verifiable.