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.