Agent skill
long-task
Initialize or resume a long-running task session. Use when starting a complex multi-session task, resuming work from a previous session, or when the user mentions claude-progress.json or long-running work.
Install this agent skill to your Project
npx add-skill https://github.com/genomewalker/cc-soul/tree/main/skills/long-task
SKILL.md
Long Task Management
Mind-powered persistence for tasks that span multiple sessions.
Quick Commands
/long-task- Show active task or start new one/long-task status- Show current task status/long-task complete- Mark task as completed
Starting a Task
When starting a long-running task:
Use long_task_start with:
- task_id: unique identifier (e.g., "implement-feature-x")
- goal: clear description of what you're trying to achieve
- hard_checks: deterministic completion criteria (optional)
- soft_checks: semantic completion criteria (optional)
How It Works
- SessionStart: If active task exists, context auto-injects
- During work: Log significant events with
long_task_event - Stop hook: Automatically logs checkpoint and increments iteration
- Completion: Mark with
[TASK_COMPLETE]or calllong_task_complete
MCP Tools
| Tool | Purpose |
|---|---|
long_task_start |
Start a new long-running task |
long_task_get |
Get task details by ID |
long_task_active |
Get active task for realm |
long_task_update |
Update progress (completed_summary, work_items, blockers) |
long_task_complete |
Mark task as completed |
long_task_event |
Log event (decision, error, checkpoint) |
long_task_snapshot |
Get synthesized context |
long_task_evaluate |
Check completion criteria |
Process
If no arguments (show status or start)
- Check for active task with
long_task_active - If found: show snapshot with
long_task_snapshot - If not found: ask user for task goal and start new task
If "status" argument
- Get active task with
long_task_active - Show detailed snapshot with mode="debug"
If "complete" argument
- Get active task
- Ask for outcome summary
- Call
long_task_complete
Example Usage
Start a task:
/long-task
> No active task. What's your goal?
> Implement the authentication system
Starting task: implement-auth
Goal: Implement the authentication system
Check status:
/long-task status
[LONG_TASK:implement-auth] Implement the authentication system
Iteration: 3 | Status: active
Done: Added login form, API endpoints
Pending: Add password reset; Add OAuth
Complete task:
/long-task complete
Outcome: Authentication system fully implemented with login, logout, and OAuth
Completed task: implement-auth
Completion Markers
The Stop hook detects these markers to auto-complete:
[TASK_COMPLETE][DONE]<promise>COMPLETE</promise>
Multi-Agent Support
Tasks support lease-based coordination:
task_claim: Claim task with leasetask_heartbeat: Extend lease- Expired leases allow other agents to take over
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
kriya
Review soul discoveries (fixes, improvements, corrections) one by one, accept or discard each, implement accepted ones, build chitta, and optionally release.
cc-soul-daemon
Start, stop, or check the chittad daemon
ultrathink
First-principles deep thinking for significant problems
reawaken
Restore context and momentum via Pratyabhijñā (recognition)
shepherd
Autonomous pipeline monitor using sense-think-act loop. Watches snakemake/nextflow jobs, detects errors, applies fixes from memory, restarts on failure.
learn
Didn't find tool you were looking for?