authoring-feature-spec

Elaborate PRD features into testable feature specifications with EARS behavior, state tables, and acceptance criteria.

1|1|Updated May 24, 2026
One-click install
npx skills add https://github.com/bm629/agent-skills --skill authoring-feature-spec-bm629
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: authoring-feature-spec
Source: https://github.com/bm629/agent-skills/tree/main/skills/authoring-feature-spec
Command: npx skills add https://github.com/bm629/agent-skills --skill authoring-feature-spec-bm629

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Product teams often hand engineers feature descriptions that are too vague to build or test against, causing rework, scope disputes, and untestable acceptance criteria. This Skill turns the features named in an approved PRD into implementable, verifiable feature specifications with observable behavior, complete I/O contracts, and pass/fail acceptance criteria. ## Core Features & Use Cases - Per-feature elaboration method: Traces every feature back to a PRD line, specifies observable behavior with EARS phrasing and use-case flows (main/alternate/exception), and enumerates inputs, outputs, state-transition tables, and decision tables. - Testable acceptance criteria: Writes Given/When/Then criteria for deterministic features and metric-threshold criteria on named datasets for probabilistic/ML features, plus edge cases each paired with their expected handling. - Archetype overlays and amend workflow: Applies per-feature NFR targets and archetype overlays (UI, REST/API, data-ML, batch, integration, CLI), and supports versioned in-place amendments with bidirectional ripple analysis across PRD, design, and test docs. - Use Case: Given an approved PRD naming an invoice-reminder feature, produce a spec where each behavior has a trigger and observable response, every edge case names its handling, and a tester can verify each criterion without asking the author. ## Quick Start Use authoring-feature-spec to elaborate the features in my approved PRD into a testable feature specification.

Frequently Asked Questions about authoring-feature-spec

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

FAQPage Schema
How do I write a feature specification from a PRD?

Start from the approved PRD's feature list as your coverage checklist, then elaborate each feature with observable behavior, inputs and outputs, states, edge cases with handling, and testable acceptance criteria. This Skill supplies that method while a template tool supplies the section structure.

How do I write acceptance criteria for ML or probabilistic features?

Use metric-threshold criteria on a named dataset, such as precision at 10 of at least 0.80 on a specific holdout set, plus a low-confidence fallback behavior and data requirements. A deterministic Given/When/Then or a statement like the model is accurate does not fit probabilistic outputs.

What is the difference between a feature spec and a PRD?

The PRD states what the product does and why, and names its features; the feature spec sits one layer below and defines how each named feature behaves in enough detail to build and test. This Skill assumes the approved PRD as input and never re-authors it.

When should I not use this feature spec authoring skill?

Do not use it to author the PRD itself, to review a finished feature spec, or to write engineering design docs such as ADRs or RFCs. Those belong to the upstream PRD-authoring skill, the paired review skill, and the downstream design layer respectively.

How do I amend an approved feature spec without regenerating it?

Scope the delta, edit only the affected blocks in place, re-make the feature's internal chain consistent, analyze the ripple upstream to the PRD and downstream to design and test docs, then bump the version with a changelog entry and mark superseded content.