skills.rest
XinheLIU
XinheLIUCOMMUNITY
Explore all skills by this author →
GitHub

spec

Create a git worktree and feature branch with a draft spec.md from a template.

Updated Apr 26, 2026
Search Tags:#workflow#planning#templates#spec#product-management#git-worktree#feature-launch
One-click install
npx skills add https://github.com/XinheLIU/human-leverage --skill spec-xinheliu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec
Source: https://github.com/XinheLIU/human-leverage/tree/main/.claude/skills/spec
Command: npx skills add https://github.com/XinheLIU/human-leverage --skill spec-xinheliu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the kickoff of a new feature by creating a dedicated git worktree, a feature branch, and a draft spec.md based on a standard template, ensuring a reproducible, auditable start.

Core Features & Use Cases

  • Create a new worktree and feature branch from a concise feature description.
  • Generate a draft spec located at specs/NNN-<short-name>/spec.md derived from references/spec-template.md.
  • Switch into the new worktree session so follow-on commands operate in the correct context.
  • Track and document the created branch and paths for auditability.

Quick Start

Describe the feature you want to start and let the skill create a new git worktree, a feature branch, and a draft spec at specs/NNN-<short-name>/spec.md.

Frequently Asked Questions about spec

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

FAQPage Schema
How do I create a git worktree and feature branch for a new product spec?▼

A git worktree isolates feature development by creating an independent working directory linked to a new feature branch. This lets you seed a spec workflow without disrupting your main branch.

How do I start a feature spec workflow with a standard template?▼

Start a feature spec workflow by providing a concise feature description. The skill derives a draft spec from a template at specs/NNN-<short-name>/spec.md, including user stories, requirements, and acceptance criteria.

Do I need an existing git repository to generate a feature spec?▼

Yes, you need an existing git repository to generate a feature spec. The skill requires a current git repository and a non-empty feature description to create the worktree and branch successfully.

What is the best way to track a created feature branch and spec location?▼

The best way to track a created feature branch and spec location is through automated worktree generation. The skill documents and tracks the created branch and paths for auditability during the spec kickoff.

Can I switch into a new git worktree session automatically after creating a spec?▼

Yes, you can switch into a new git worktree session automatically. The skill switches into the new worktree context after generating the spec.md file, ensuring follow-on commands operate correctly.

What sections are included in a generated feature spec template?▼

A generated feature spec template includes structured sections for user stories, requirements, and acceptance criteria. This enforces a standard spec workflow derived from references/spec-template.md.

Related Skills

Explore More Product & Management Skills→
good-ideagood-idea
3

using-git-worktrees

Create Git worktrees for isolated feature development and cleanup optionally deleting branches.

Community
Intermediate
notquenotque
415

spec-writer

Create a SPEC.md with user stories, acceptance criteria, and risks.

Community
Advanced
sjevsjev
1

merge

Merges a feature branch into the base branch using a commit.

Community
Intermediate
Doyajin174Doyajin174
1

using-git-worktrees

Create isolated Git worktrees for parallel feature development.

Community
Advanced