task-init

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

4|Updated Sep 25, 2025
One-click install
npx skills add https://github.com/cowwoc/styler --skill task-init
Or copy as Structured Prompt for Agent
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.