feature-setup

Create a feature branch, worktree, and documentation skeleton with templates.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/oletizi/writingcontrol.org --skill feature-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: feature-setup
Source: https://github.com/oletizi/writingcontrol.org/tree/main/.claude/skills/feature-setup
Command: npx skills add https://github.com/oletizi/writingcontrol.org --skill feature-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill creates a repeatable workflow to initialize a feature development environment, including a git worktree, a dedicated branch, and a standardized documentation scaffold.

Core Features & Use Cases

  • Automated worktree and branch setup: Creates a distinct workspace per feature to prevent cross-contamination between tasks.
  • Documentation scaffolding: Generates a docs directory structure (docs/1.0/001-IN-PROGRESS/<slug>) and template files for PRD, workplan, README, and implementation summary.
  • Use Case: When starting a new feature, you run the setup to automatically prepare the repository with a new feature branch and a ready-to-edit docs suite, enabling immediate PR readiness.
  • Definition-driven workflow: If a feature-definition file exists at /tmp/feature-definition-<slug>.md, its contents are used to populate templates; otherwise blank templates are created.

Quick Start

Run the feature-define flow to create templates and initialize a new feature worktree.

Frequently Asked Questions about feature-setup

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

FAQPage Schema
How do I create a git worktree and feature branch with documentation templates?

To create a git worktree and feature branch with documentation templates, run the feature setup workflow to automatically establish an isolated workspace, generate a dedicated branch, and scaffold PRD and workplan documents in a standardized docs directory for immediate development.

What is the best way to scaffold PRD and workplan docs for a new feature?

Scaffolding PRD and workplan docs is best handled by a definition-driven workflow that generates a standardized docs directory structure, populating templates from an existing feature-definition file or creating blank ones to ensure immediate PR readiness.

Can I use an existing feature definition to populate documentation templates?

Yes, you can use an existing feature definition to populate documentation templates by placing a feature-definition markdown file at the expected temporary path, which the setup process reads to automatically fill in the PRD and workplan skeletons.

Does setting up isolated worktrees prevent cross-contamination between feature tasks?

Setting up isolated worktrees prevents cross-contamination between feature tasks by creating a distinct, dedicated workspace per feature, ensuring that branch dependencies and file changes remain completely separated until merged.

How does documentation scaffolding work for git branch workflows?

Documentation scaffolding for git branch workflows works by automatically generating a standardized directory structure with template files for the PRD, workplan, README, and implementation summary, ensuring consistent readiness across isolated feature branches.

Do I need to manually create a docs directory structure for every new feature?

You do not need to manually create a docs directory structure for every new feature because the setup process automatically generates the required nested folders and template files, enforcing a consistent readiness process across all projects.