acceptance-criteria-drafter

Interview users to collect feature requirements and generate a Markdown Acceptance Criteria draft.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/atman-33/skills --skill acceptance-criteria-drafter
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: acceptance-criteria-drafter
Source: https://github.com/atman-33/skills/tree/main/skills/acceptance-criteria-drafter
Command: npx skills add https://github.com/atman-33/skills --skill acceptance-criteria-drafter

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill reduces the time and ambiguity in defining Acceptance Criteria by guiding a structured interview process and generating a ready-to-use Markdown draft stored in the .tmp folder.

Core Features & Use Cases

  • Interview-driven AC drafting: collects feature goals, actors, and success criteria.
  • Markdown draft output: saves a .tmp/ac-draft-YYYYMMDD-N.md file for review and refinement.
  • Edge-case handling: captures optional constraints and non-functional requirements.
  • Use Case: When starting a new feature, run AC Drafter to produce a draft that product and dev teams can review.

Quick Start

Interact with the user to elicit feature requirements, then generate and save the Acceptance Criteria draft to .tmp/ac-draft-YYYYMMDD-1.md. The agent should allow iterative refinement by re-asking clarifying questions and regenerating the draft until approval.

Frequently Asked Questions about acceptance-criteria-drafter

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

FAQPage Schema
How do I draft acceptance criteria for a new feature requirement?▼

You can draft acceptance criteria by engaging in a structured interview process that collects feature goals, actors, and success criteria, then generates a structured Markdown draft saved in the .tmp folder for team review.

What is the best way to generate testable requirements for GitHub Issues?▼

Generating testable requirements for GitHub Issues is best handled by an interview-driven approach that elicits user goals and constraints, producing a concise Markdown draft focused on verifiable conditions.

Can I use an interview process to capture edge cases and non-functional requirements?▼

Yes, you can use an interview process to capture edge cases and non-functional requirements, as the structured questioning specifically targets optional constraints to ensure comprehensive acceptance criteria.

How do I save acceptance criteria drafts as Markdown files for iterative refinement?▼

You can save acceptance criteria drafts as Markdown files by completing the interview process, which outputs a structured file named ac-draft-YYYYMMDD-N.md directly into the .tmp folder for immediate review and iterative refinement.

Does the acceptance criteria drafting process support iterative refinement?▼

Yes, the acceptance criteria drafting process supports iterative refinement by allowing you to answer clarifying questions repeatedly and regenerate the Markdown draft until the criteria meet your approval.

What format do I need for acceptance criteria to ensure verifiability?▼

You need a Markdown format for acceptance criteria to ensure verifiability, as the drafting process focuses on producing concise, testable conditions that clearly define user goals and success metrics.