skills.rest
mlbright
mlbrightCOMMUNITY
Explore all skills by this author →
GitHub

feature-spec

Guide structured interviews to create feature specifications with Gherkin scenarios.

Updated Feb 8, 2026
Search Tags:#feature specification#requirements gathering#user stories#agile development#gherkin#pr planning
One-click install
npx skills add https://github.com/mlbright/notes --skill feature-spec-mlbright
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: feature-spec
Source: https://github.com/mlbright/notes/tree/main/.github/skills/feature-spec
Command: npx skills add https://github.com/mlbright/notes --skill feature-spec-mlbright

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the process of defining new features by guiding users through a structured interview to create comprehensive specifications, including Gherkin scenarios and edge cases.

Core Features & Use Cases

  • Structured Interview: Asks targeted questions to gather all necessary details for a feature specification.
  • Gherkin Scenarios: Generates clear, testable scenarios for acceptance criteria and edge cases.
  • PR Breakdown: Assists in planning the implementation by suggesting a breakdown into manageable pull requests.
  • Use Case: When you need to clearly define a new user authentication flow, this Skill will prompt you for details like user stories, acceptance criteria, and potential edge cases, outputting a ready-to-use specification document.

Quick Start

Use the feature-spec skill to start defining a new user login feature.

Frequently Asked Questions about feature-spec

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

FAQPage Schema
How do I write a feature specification with Gherkin scenarios?▼

To write a feature specification with Gherkin scenarios, you can use a guided interview process that prompts you for user stories, acceptance criteria, and edge cases to produce a complete spec document.

What is the best way to gather requirements for a new feature?▼

The best way to gather requirements for a new feature is through a structured interview that asks targeted questions, ensuring all necessary details and edge cases are captured before implementation begins.

How do I break down feature specifications into pull requests for agile development?▼

Breaking down feature specifications into pull requests involves taking the generated Gherkin scenarios and suggesting a breakdown into manageable PRs to assist in planning the agile development implementation.

Can I use this approach to define edge cases for user stories?▼

Yes, you can define edge cases for user stories by going through a structured interview that explicitly prompts you for potential edge cases alongside standard acceptance criteria.

Does feature-spec work without any external dependencies?▼

Feature-spec operates without external dependencies, using only its internal references component to guide the feature specification and PR planning process from start to finish.

Related Skills

Explore More Software Engineering Skills→
avav25avav25
2

feature-design

Convert raw feature ideas into structured PRDs with goals, user stories, and acceptance criteria.

Community
Intermediate
zhizhunbaozhizhunbao

dev-scrum

Generate sprint backlogs, user stories, and task breakdowns from PRD requirements.

Community
Advanced
edithatogoedithatogo
1

conductor-newtrack

Generate spec.md, plan.md, and track metadata for new Conductor tracks.

Community
Intermediate
mberetvasmberetvas

i-shape

Conduct a structured discovery interview and generate a formal design brief.

Community
Advanced