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

Ready to run

npx skills add https://github.com/mlbright/notes --skill feature-spec-mlbright

💬 Prompt for ChatGPT / Claude Chat▼

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.