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.