feature-spec

Generate FEATURE_SPEC.md files through a guided Q&A workflow.

39|5|Updated Dec 28, 2025
One-click install
npx skills add https://github.com/benjaminshoemaker/ai_coding_project_base --skill feature-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: feature-spec
Source: https://github.com/benjaminshoemaker/ai_coding_project_base/tree/main/.claude/skills/feature-spec
Command: npx skills add https://github.com/benjaminshoemaker/ai_coding_project_base --skill feature-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a guided, interactive process for converting feature ideas into a structured, shareable FEATURE_SPEC.md, reducing ambiguity and handoff errors.

Core Features & Use Cases

  • Interactive Q&A to elicit core feature definitions, scope, integration details, and constraints.
  • Automated spec output written to features/<feature-name>/FEATURE_SPEC.md, with DEFERRED.md capturing future enhancements.
  • Project-context checks (requires AGENTS.md in project root) to ensure alignment with existing workflows and guardrails.

Quick Start

Run from your project root to generate a feature spec for a feature named 'analytics': /feature-spec analytics

Frequently Asked Questions about feature-spec

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

FAQPage Schema
How do I generate a structured feature spec from product requirements?

Generating a feature spec involves running a guided interactive Q&A workflow that captures product requirements and automatically writes the output to a FEATURE_SPEC.md file in your project directory.

What is the best way to capture deferred requirements during feature specification?

Capturing deferred requirements involves recording future enhancements during the Q&A workflow, automatically logging them into a DEFERRED.md file to ensure they are documented without cluttering the main feature scope.

Do I need an AGENTS.md file in my project root to create a feature specification?

Yes, creating a feature specification requires an AGENTS.md file in the project root directory to provide project context and ensure the generated spec aligns with existing workflows and guardrails.

How do I start guided feature spec generation for a new feature?

To start guided feature spec generation, run the command from your project root with the feature name, triggering a structured Q&A session that elicits scope, integration details, and constraints.

Can I trigger a cross-model review after generating a feature spec?

Yes, you can trigger a cross-model review after generating a feature spec if a Codex CLI is available in your environment, adding an automated validation layer to the specification process.

Where are feature specifications stored when using a guided Q&A workflow?

Feature specifications are stored under features/<feature-name>/FEATURE_SPEC.md, keeping them organized within your project structure while deferred items are recorded separately in DEFERRED.md.