skilld
All skills
jeffallan avatar

/feature-forge

@efebc44
by jeffallanjeffallan/claude-skills12k stars
1,124

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.

Ask your Agent

Use this Skill: https://skilld.dev/gh/jeffallan/claude-skills/feature-forge

This session only. Nothing lands on disk.

referencesears-syntax.md

≈675 tokens on demand. Your agent reads this file only when SKILL.md points to it.

EARS Syntax

EARS Format

Easy Approach to Requirements Syntax for clear, unambiguous requirements.

Basic Pattern

While <precondition>, when <trigger>, the system shall <response>.

Pattern Types

Ubiquitous (Always True)

The system shall [action].

Example: The system shall encrypt all passwords using bcrypt.

Event-Driven

When [trigger], the system shall [action].

Example: When the user clicks "Submit", the system shall save the form data.

State-Driven

While [state], the system shall [action].

Example: While the user is logged in, the system shall display the dashboard.

Conditional (Most Common)

While [state], when [trigger], the system shall [action].

Example: While the cart contains items, when the user clicks "Checkout", the system shall navigate to the payment page.

Optional

Where [feature enabled], the system shall [action].

Example: Where two-factor authentication is enabled, the system shall require a verification code.

Examples by Domain

Authentication

**FR-AUTH-001**: Login
While credentials are valid, when POST /auth/login is called,
the system shall return JWT access token (15min) and refresh token (7d).

**FR-AUTH-002**: Invalid Login
When invalid credentials are provided,
the system shall return 401 and increment failed login counter.

**FR-AUTH-003**: Account Lockout
While failed login count exceeds 5, when login is attempted,
the system shall reject the attempt and require password reset.

E-commerce

**FR-CART-001**: Add to Cart
While user is logged in, when they click "Add to Cart",
the system shall add the item and update the cart badge count.

**FR-CART-002**: Apply Coupon
While the cart contains items, when a valid coupon code is applied,
the system shall reduce the total by the discount amount.

**FR-ORDER-001**: Checkout
While payment method is valid, when user confirms order,
the system shall create order, charge payment, and send confirmation email.

Data Management

**FR-EXPORT-001**: CSV Export
While user has data access permission, when they click "Export",
the system shall generate a CSV file and initiate download.

**FR-DELETE-001**: Soft Delete
When a resource is deleted,
the system shall set deleted_at timestamp instead of removing the record.

Quick Reference

Type Structure Use When
Ubiquitous shall [action] Always applies
Event When [X], shall On trigger
State While [X], shall Continuous state
Conditional While [X], when [Y], shall State + trigger
Optional Where [X], shall Feature flag

Source: SKILL.md on GitHub

Third-party checks

1 alert16d5 checks · Risk CRITICAL
  • Gen Agent Trust Hub16d

    This skill and its documentation URL have been flagged as malicious by automated scanners. The skill also possesses a vulnerability to indirect prompt injection due to its method of ingesting and processing untrusted user requirements.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: LOW · No issues

  • Runlayer6mo

    6 files scanned · No issues

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Provenance

Signed by skilld at efebc44. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 months ago.

Steadyupdated 5 months ago

Capability

Other metadata
metadata
{
  "author": "https://github.com/Jeffallan",
  "version": "1.1.0",
  "domain": "workflow",
  "triggers": "requirements, specification, feature definition, user stories, EARS, planning",
  "role": "specialist",
  "scope": "design",
  "output-format": "document",
  "related-skills": "fullstack-guardian, spec-miner, test-master"
}

Topics

  • requirements
  • specification
  • user-stories
  • ears
  • acceptance-criteria
  • planning
  • prd
  • workshop
  • feature-definition

README badge

README badge for jeffallan/claude-skills/feature-forge

What it does

Conducts structured requirements workshops using PM and Dev perspectives to produce feature specifications, EARS-format functional requirements, acceptance criteria, and implementation checklists. Targets feature definition, requirements gathering, and specification writing workflows with systematic discovery and validation phases.

Generated from the current SKILL.md.

Frequently asked

Does this skill write the spec automatically, or does it require user input?
It requires structured user input through interviews and discovery questions. The skill conducts a systematic workshop using the AskUserQuestions tool to gather requirements before producing the specification.
What output formats does this skill produce?
It produces EARS-format functional requirements, Given/When/Then acceptance criteria, non-functional requirements, error handling tables, and implementation TODO checklists, all saved as a markdown specification document.
Can this skill handle complex features that span multiple domains?
Yes. The skill includes guidance for using multi-agent discovery with Task subagents on features spanning multiple domains, documented in the pre-discovery-subagents reference.
Does this skill cover non-functional requirements like performance and security?
Yes. It explicitly requires inclusion of non-functional requirements, security considerations, and error handling as part of the specification output.

Generated from the current SKILL.md. These answers refresh after source changes.