feature-spec

Creates comprehensive feature specification documents in docs/specs/format.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/dr-code/beacon --skill feature-spec-dr-code
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: feature-spec
Source: https://github.com/dr-code/beacon/tree/main/plugins/agent-triforce/skills/feature-spec
Command: npx skills add https://github.com/dr-code/beacon --skill feature-spec-dr-code

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps product teams avoid ambiguous or incomplete requirements by producing a structured, implementation-ready feature specification that captures acceptance criteria, scope, dependencies, risks, and handoff notes.

Core Features & Use Cases

  • Structured spec generation: Produces a full markdown spec file at docs/specs/{feature-name}.md with a problem statement and success metrics.
  • Acceptance criteria: Writes user stories with GIVEN/WHEN/THEN acceptance criteria to drive testable outcomes.
  • Planning & handoff: Identifies in-scope/out-of-scope items, dependencies, risks, open questions, and prepares a Dev agent handoff.
  • Workflow orchestration: Runs sign-in and sign-out checklists and researches existing specs to avoid conflicts.

Quick Start

Create a complete feature spec for user authentication with JWT tokens.

Frequently Asked Questions about feature-spec

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

FAQPage Schema
How do I write user stories with GIVEN/WHEN/THEN acceptance criteria for new features?

To write user stories with GIVEN/WHEN/THEN acceptance criteria, define the feature's problem statement, success metrics, and testable outcomes. This generates a structured markdown specification capturing scope boundaries, dependencies, and risks for implementation readiness.

What is the best way to structure a product feature spec for dev handoff?

The best way to structure a product feature spec for dev handoff is to produce a markdown document containing problem statements, in-scope and out-of-scope items, dependencies, risks, and checklist-driven sign-in and sign-out steps to coordinate PM and engineering workflows.

How do I define scope boundaries and dependencies when planning feature implementation?

Define scope boundaries and dependencies by identifying in-scope and out-of-scope items, mapping technical dependencies, listing risks, and noting open questions within a feature specification to ensure clear implementation planning and avoid ambiguous requirements.

Can I generate a complete feature specification in markdown for product management workflows?

Yes, you can generate a complete feature specification in markdown for product management workflows. The output file is created at docs/specs/{feature-name}.md, containing success metrics, acceptance criteria, scope, and handoff notes.

Does this approach write testable acceptance criteria for engineering teams?

Yes, this approach writes testable acceptance criteria for engineering teams by utilizing GIVEN/WHEN/THEN formats within user stories. This drives testable outcomes and ensures the development team receives implementation-ready requirements.

When do I need a formal feature spec with sign-in and sign-out checklists?

You need a formal feature spec with sign-in and sign-out checklists when coordinating handoffs between PM and engineering, ensuring existing specs are researched to avoid conflicts and that all scope, dependencies, and risks are verified before implementation begins.