← Back to list
✍️

feature-forge Checked

Conducts structured requirements workshops to produce feature specifications, user stories, EARS-…
✍️ Writing skills By Jeffallan Version v1.0.0 Added 2026-09-07 Updated 2026-09-07 Source ↗
9.0Overall rating
2Views
4Downloads
11.3kStars

Installation

🤖 Install via AI

Copy the prompt below and send it to your AI assistant (e.g. Claude Code) — it will follow the instructions and install automatically.

Install the "feature-forge" skill by following the instructions at https://skill123.me/install/feature-forge.
⌨️ Command line install

Run in your terminal — downloads and installs to ~/.claude/skills/.

curl -fsSL https://skill123.me/install/feature-forge.sh | bash
📦 Download ZIP

Download the zip and extract it into your skills directory (e.g. ~/.claude/skills/), then restart your session.

⬇ Download v1.0.0 · 10 KB
📊 Static rating
9.0/10
Trigger
8.5
Structure
9.3
Workflow
8.4
Content
9.0
Engineering
10.0
Security
9.5

Six-dimension rubric with reviewer rationale.

View scorecard ↓
🛡 Dynamic test
—

Not live-tested yet — this skill is rated on static analysis only.

About this skill

Conducts structured requirements workshops to produce feature specifications, user stories, EARS-format functional requirements, acceptance criteria, and implementation checklists. Use when defining new features, gathering requirements, or writing specifications. Invoke for feature definition, requirements gathering, user stories, EARS format specs, PRDs, acceptance criteria, or requirement matrices.

Feature Forge

Requirements specialist conducting structured workshops to define comprehensive feature specifications.

Documentation

Conducts structured requirements workshops to produce feature specifications, user stories, EARS-format functional requirements, acceptance criteria, and implementation checklists. Use when defining new features, gathering requirements, or writing specifications. Invoke for feature definition, requirements gathering, user stories, EARS format specs, PRDs, acceptance criteria, or requirement matrices.

Feature Forge

Requirements specialist conducting structured workshops to define comprehensive feature specifications.

Role Definition

Operate with two perspectives:

  • **PM Hat**: Focused on user value, business goals, success metrics
  • **Dev Hat**: Focused on technical feasibility, security, performance, edge cases

When to Use This Skill

  • Defining new features from scratch
  • Gathering comprehensive requirements
  • Writing specifications in EARS format
  • Creating acceptance criteria
  • Planning implementation TODO lists

Core Workflow

1. **Discover** - Use AskUserQuestions to understand the feature goal, target users, and user value. Present structured choices where possible (e.g., user types, priority level).

2. **Interview** - Systematic questioning from both PM and Dev perspectives using AskUserQuestions for structured choices and open-ended follow-ups. Use multi-agent discovery with Task subagents when the feature spans multiple domains (see interview-questions.md for guidance).

3. **Document** - Write EARS-format requirements

4. **Validate** - Use AskUserQuestions to review acceptance criteria with stakeholder, presenting key trade-offs as structured choices

5. **Plan** - Create implementation checklist

Reference Guide

Load detailed guidance based on context:

| Topic | Reference | Load When |

|-------|-----------|-----------|

| EARS Syntax | references/ears-syntax.md | Writing functional requirements |

| Interview Questions | references/interview-questions.md | Gathering requirements |

| Specification Template | references/specification-template.md | Writing final spec document |

| Acceptance Criteria | references/acceptance-criteria.md | Given/When/Then format |

| Pre-Discovery Subagents | references/pre-discovery-subagents.md | Multi-domain features needing front-loaded context |

Constraints

### MUST DO

  • Use AskUserQuestions tool for structured elicitation (priority, scope, format choices)
  • Use open-ended questions only when choices cannot be predetermined
  • Conduct thorough interview before writing spec
  • Use EARS format for all functional requirements
  • Include non-functional requirements (performance, security)
  • Provide testable acceptance criteria
  • Include implementation TODO checklist
  • Ask for clarification on ambiguous requirements
View full documentation

### MUST NOT DO

  • Output interview questions as plain text when AskUserQuestions can provide structured options
  • Generate spec without conducting interview
  • Accept vague requirements ("make it fast")
  • Skip security considerations
  • Forget error handling requirements
  • Write untestable acceptance criteria

Output Templates

The final specification must include:

1. Overview and user value

2. Functional requirements (EARS format)

3. Non-functional requirements

4. Acceptance criteria (Given/When/Then)

5. Error handling table

6. Implementation TODO checklist

**Inline EARS format examples** (load references/ears-syntax.md for full syntax):


When <trigger>, the <system> shall <response>.
Where <feature> is active, the <system> shall <behaviour>.
The <system> shall <action> within <measure>.

**Inline acceptance criteria example** (load references/acceptance-criteria.md for full format):


Given a registered user is on the login page,
When they submit valid credentials,
Then they are redirected to the dashboard within 2 seconds.

Save as: specs/{feature_name}.spec.md

Documentation

Score breakdown

Trigger
8.5
Rich What/When/trigger keywords but no explicit When-Not exclusion
Structure
9.3
100-line SKILL.md, five well-classified references with load-when table, no redundancy
Workflow
8.4
Five-step workshop workflow, MUST/MUST-NOT guards, stakeholder validation loop; tool assumption may not exist
Content
9.0
Concise imperative writing with inline EARS and Given/When/Then examples
Engineering
10.0
Valid frontmatter, all reference paths exist, no scripts needed
Security
9.5
No network calls, no injection, no secrets; only benign github.io doc link
Excellent requirements-workshop skill: clear EARS workflow, progressive references with load-when table, strong MUST/MUST-NOT constraints; only lacks explicit When-Not boundary and relies on AskUserQuestions tool not present in Claude Code.