spec-test-gen

Generates visual acceptance criteria from EARS requirements when specs lack an AC section.

Updated May 18, 2026
One-click install
npx skills add https://github.com/FredoAi/fredo --skill spec-test-gen-fredoai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-test-gen
Source: https://github.com/FredoAi/fredo/tree/main/.opencode/skills/spec-test-gen
Command: npx skills add https://github.com/FredoAi/fredo --skill spec-test-gen-fredoai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? QA verification stalls when a spec comment has no ## Acceptance Criteria section, leaving testers without concrete, verifiable checks. This Skill derives testable acceptance criteria directly from EARS requirements so end-to-end verification can proceed without modifying the original spec. ## Core Features & Use Cases - EARS Requirement Parsing: Extracts and classifies WHEN/WHILE/WHERE requirements by whether they are user-observable, skipping code-only requirements. - Concrete AC Generation: Produces verifiable ACs with specific text, roles, counts, or CSS selectors, prefixed with AC-A to distinguish them from spec-authored criteria. - Capsule Mapping: Resolves each REQ-ID to its capsule by reading issue comments via gh issue view, then writes a structured AC table to .opencode/tmp/<issue>/generated-acs.md. - Use Case: During e2e verification of backlog issue #42, the spec comment has no AC section. Load this Skill to parse its EARS requirements, generate a table of visual ACs mapped to capsules, and proceed with testing as if the ACs came from the spec. ## Quick Start Check the backlog issue's spec comment for a missing Acceptance Criteria section and generate testable ACs from its EARS requirements before running e2e verification.

Frequently Asked Questions about spec-test-gen

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

FAQPage Schema
How do I generate acceptance criteria from EARS requirements?▼

Parse each EARS requirement (WHEN/WHILE/WHERE patterns), classify whether it is user-observable, then write one concrete AC per observable requirement using specific text, roles, counts, or CSS selectors that a tester can verify with DOM tools.

What should I do when a spec has no acceptance criteria section?▼

Load this Skill when `gh issue view` reveals the spec comment has no `## Acceptance Criteria` section. It derives generated ACs from the EARS requirements and writes them to `.opencode/tmp/<issue>/generated-acs.md` so e2e testing can proceed.

Which EARS requirements can be turned into visual acceptance criteria?▼

Requirements about rendering, persistence, interactive updates, and input validation are user-observable and get ACs. Internal data structures and API response shapes are code-only and are skipped since they cannot be verified visually.

Does generating acceptance criteria modify the original spec or backlog?▼

No. Generated ACs are written only to a scratch file under `.opencode/tmp/<issue>/` and prefixed with `AC-A` to distinguish them from spec-authored criteria. The spec and backlog are never modified.

What are the limitations of auto-generated acceptance criteria?▼

Generated ACs are derived strictly from the EARS requirement text, so they cannot capture layout or behavior the requirements do not state. If a capsule cannot be resolved from issue comments, it is marked as `Capsule: Unknown (REQ-X)`.