skills.rest
crowi
crowiOFFICIAL
Explore all skills by this author →
WebsiteGitHub

crowi-kickoff

Automates worktree creation and agent session launch from approved implementation specs.

1.1k|165|Updated Aug 18, 2014
Search Tags:#worktree#Git Workflow#kickoff#agent automation#spec validation#Tmux#serial chain
One-click install
npx skills add https://github.com/crowi/crowi --skill crowi-kickoff
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: crowi-kickoff
Source: https://github.com/crowi/crowi/tree/main/.claude/skills/crowi-kickoff
Command: npx skills add https://github.com/crowi/crowi --skill crowi-kickoff

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Starting implementation from an approved spec involves repetitive manual steps: creating a git worktree, opening a tmux window, launching an agent session, and typing the initial instruction. This Skill collapses that entire entry sequence into a single command while refusing to start specs that are not implementation-ready.

Core Features & Use Cases

  • Readiness validation: Runs a shared validator against the spec contract (scope, acceptance criteria, implementation map, freshness of grounded symbols) and aborts with an enumerated list of gaps when the spec is not ready.
  • Automated worktree and session launch: Invokes gw start so hooks wire up feature state, open a tmux window, and start a claude session, then injects the implementation instruction via send-keys to the correct pane.
  • Serial spec chains: Accepts multiple spec IDs and runs them one at a time, automatically kicking off the next spec after the previous one is integrated.
  • Use Case: Run /crowi-kickoff feature-attachment-thumbnail from the main worktree to validate the spec, create the worktree, launch the agent, and hand off the implementation instruction in one step.

Quick Start

Ask the assistant to kick off implementation for an approved spec by running /crowi-kickoff followed by the spec ID from the main worktree.

Frequently Asked Questions about crowi-kickoff

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

FAQPage Schema
How do I start implementing an approved spec in a git worktree?▼

Run /crowi-kickoff with the spec ID from the main worktree. It validates the spec, creates the worktree via gw start, and injects the implementation instruction into the auto-launched tmux claude session.

How do I run multiple feature specs sequentially instead of in parallel?▼

Pass multiple spec IDs to /crowi-kickoff to create a serial chain. Only the first spec launches immediately; each subsequent spec is kicked off automatically after the previous one is integrated into main.

What happens if a spec is not implementation-ready?▼

The kickoff aborts and lists the missing elements reported by the validator, such as absent acceptance criteria or stale grounded symbols. The spec must be rebuilt or re-reviewed before kickoff will proceed.

Can I create the worktree without launching the agent session?▼

Yes, pass the --no-launch flag. The worktree is created and queue state initialized, but no instruction is injected; the skill prints manual steps for starting the session yourself.

Why does kickoff refuse to run inside a worktree?▼

Kickoff must run from the main worktree because it creates new worktrees and coordinates chain state. Running it inside an existing worktree is aborted with a message directing you to the main session.

Related Skills

Explore More Software Engineering Skills→
forecast-bioforecast-bio
27

design

Author codebase-grounded feature design documents in .design/<slug>.md.

Official
Advanced
mariasebarespersonamariasebarespersona

worktree-merge

Merge parallel worktree branches into main with conflict detection and verification.

Community
Advanced
mindroom-aimindroom-ai
232

agent-cli-tmux-supervision

Supervise parallel agent-cli Codex worktrees with tmux sessions.

Official
Advanced
leonvanzylleonvanzyl
426

implement-feature

Orchestrate parallel coder agent waves with code review gates for feature specs.

Community
Intermediate