task-init

Initialize task workspaces with state tracking, worktrees, and agent branches.

4|Updated Sep 25, 2025

Search Tags:#automation #worktrees #branch management #task-init #session ownership

Ready to run

npx skills add https://github.com/cowwoc/styler --skill task-init

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: task-init
Source: https://github.com/cowwoc/styler/tree/main/.claude/skills/task-init
Command: npx skills add https://github.com/cowwoc/styler --skill task-init

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill initializes a full task structure with state tracking, dedicated worktrees, and multi-agent branches, reducing setup errors and ensuring protocol compliance.

Core Features & Use Cases

Task scaffolding: Creates task.json, task.md, code/ and agents/ directories per task.
Branch provisioning: Creates main and per-agent branches for isolation.
Ownership tracking: Embeds a session_id to prevent cross-instance conflicts.

Quick Start

TASK_NAME="implement-formatter-api" SESSION_ID="your-session-id-from-startup" /workspace/main/.claude/scripts/task-init.sh "$TASK_NAME" "" "$SESSION_ID"

Frequently Asked Questions about task-init

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

FAQPage Schema

How do I automate task workspace initialization with branch management?▼

Task initialization automates creating a complete task workspace including state tracking via task.json, dedicated worktrees for code and agents, and isolated branches per agent. Run the task-init script with your task name and session ID to scaffold the full structure and enforce ownership configuration in one step.

What does session ownership mean in task setup?▼

Session ownership uses a session_id embedded in task initialization to prevent cross-instance conflicts when multiple agents coordinate on the same task. The session_id tracks which Claude instance owns the task, ensuring protocol compliance and preventing concurrent modification errors.

Can I set up multi-agent task coordination with isolated branches?▼

Yes. Task initialization creates a main branch and per-agent branches automatically, isolating each agent's work while maintaining a shared task state in task.json. This enables coordinated multi-agent tasks without merge conflicts or ownership collisions.

What gets created during task scaffolding?▼

Task scaffolding creates task.json in INIT state, generates task.md templates, builds code/ and agents/ worktrees, provisions main and per-agent branches, and outputs a standardized JSON artifact containing paths, status, and timestamps for the new task.

How do I prevent setup errors when initializing a new task from todo.md?▼

Task initialization enforces protocol infrastructure automatically—correct directory structure, branch naming, and ownership configuration—reducing manual setup errors. A single command creates the complete workspace and outputs validation status so you know setup succeeded.