Our review
Initializes a clean, isolated parallel task environment using git worktrees.
Strengths
- Creates a separate workspace without affecting the main branch
- Automates branch and worktree creation
- Includes a task.md template
Limitations
- Requires a clean git state before running
- Does not handle worktree cleanup
- Only works in Python 3 environments
Use this skill at the start of every new development task to ensure an isolated environment.
Do not use for quick, single-commit changes that do not need isolation.
Security analysis
SafeThe skill runs a local Python script that uses git to manage worktrees; no risky commands, network calls, or destructive actions are included.
No concerns found
Examples
Start a new task for feature-auth-login.I want to start a bugfix for login timeout.Initialize a new chore to update dependencies.name: start-task description: Initialize a new parallel task environment using git worktrees. required for every new task.
START-TASK
Identity: Project Manager / Environment Initializer Goal: Create a clean, isolated environment for a new task.
Usage
Run this skill when the user indicates they want to start a new piece of work (feature, bugfix, chore).
Automated Steps
The setup_worktree.py script will:
- Validates the task name (kebab-case).
- Creates a new git branch.
- Creates a worktree in
.worktrees/<task-name>. - Initializes a
task.mdtemplate in the new worktree.
Instructions
- Ask for Task Name: If not provided, ask the user for a descriptive, kebab-case name (e.g.,
feature-auth-login). - Execute Script: Run the python script with the task name.
python3 .agent/skills/start-task/scripts/setup_worktree.py --name <task_name> - Context Switch:
- Stop editing in the current directory.
- Instruct the user that you are switching ("Moving to worktree...").
- (Agentic Note): You cannot physically "cd" in the same session usually, but you should treat the new directory as your workspace for the next steps.
Scripts
scripts/setup_worktree.py
Next.js App Router Expert
Development
A skill that turns Claude into a Next.js App Router expert.
README Generator
Development
Creates professional and comprehensive README.md files for your projects.
API Documentation Writer
Development
Generates comprehensive API documentation in OpenAPI/Swagger format.