shep-kit:new-feature

Generate a feature specification directory with YAML templates and Markdown artifacts.

241|51|Updated Feb 1, 2026
One-click install
npx skills add https://github.com/shep-ai/cli --skill shep-kit-new-feature
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shep-kit:new-feature
Source: https://github.com/shep-ai/cli/tree/main/.claude/skills/shep-kit%3Anew-feature
Command: npx skills add https://github.com/shep-ai/cli --skill shep-kit-new-feature

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pnpm, and includes scripts (resource) components.

What problem does it solve?

Quickly scaffolds a complete feature specification workspace to standardize starting new features, reducing manual setup and ensuring consistency across teams.

Core Features & Use Cases

  • Generates YAML templates for spec.yaml, research.yaml, plan.yaml, tasks.yaml
  • Creates a dedicated feature branch and scaffolds a specification directory for collaboration
  • Auto-generates Markdown artifacts (spec.md, research.md, plan.md, tasks.md) from YAML for documentation
  • Use case: Kick off a new feature by provisioning a ready-to-edit spec workspace and a corresponding branch

Quick Start

Run /shep-kit:new-feature to scaffold a new feature spec directory.

Frequently Asked Questions about shep-kit:new-feature

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

FAQPage Schema
How do I scaffold a spec-driven workflow for a new feature?

To scaffold a spec-driven workflow, you can generate a complete specification directory with initial YAML templates and a dedicated feature branch. This creates a ready-to-run workspace enforcing a YAML-first process for feature planning.

What YAML templates are needed to standardize feature specification across teams?

Standardizing feature specification requires templates for spec, research, plan, tasks, and feature state. These YAML files structure the initial project details and auto-generate corresponding Markdown artifacts for documentation.

Do I need pnpm to generate a feature spec workspace?

Yes, pnpm is required as a dependency to run the scripts that generate your feature spec workspace. The scaffolding process relies on this package manager to execute the workflow setup.

How do I create a dedicated branch and spec directory for feature collaboration?

You create a dedicated branch and spec directory by running a scaffolding command that wires the branch automatically. This provisions a ready-to-edit workspace where teams can collaborate on YAML templates.

Can I use this scaffolding tool to revamp an existing feature?

Yes, you can use this scaffolding tool whenever you revamp an existing feature. It generates a fresh specification directory and populates new YAML templates to restart the spec-driven process.

What is the best way to start a new feature using a YAML-first approach?

The best way to start a feature with a YAML-first approach is generating initial spec, research, plan, and tasks templates. This ensures consistency by populating structured YAML files before generating Markdown documentation.