Checklist
by @welliu
Collaborative task checklist manager for AI agents with sequential, parallel, and looping execution. Features agent coordination, dependencies, deadlock prev...
clawhub install checklistπ About This Skill
name: checklist version: 1.2.1 description: Collaborative task checklist manager for AI agents with sequential, parallel, and looping execution. Features agent coordination, dependencies, deadlock prevention, and loop safety.
Checklist π
Collaborative task checklist manager for AI agents with advanced execution modes.
π― When to Use
Use this skill when:
π Execution Modes
1. Sequential (δΈ²θ‘)
Steps execute one after another:A β B β C β D
2. Parallel (εΉΆθ‘)
Steps execute simultaneously:A
B β Branch together
C
3. Loop (εΎͺη―)
Repeat until exit condition:while condition:
A β B
if exit_condition:
break
β‘ Quick Commands
Execution Control
# Set execution mode
checklist mode sequential # δΈ²θ‘
checklist mode parallel # εΉΆθ‘
checklist mode loop # εΎͺη―Configure loop
checklist loop set 5 # Set max 5 iterations
checklist loop condition "" # Set exit condition
checklist loop count # Show current loop countRun checklist
checklist run # Execute with current mode
checklist run --dry-run # Preview without executingSafety
checklist check # Check for deadlocks
checklist validate # Validate entire workflow
Agent Commands
checklist agent register
checklist agent use
checklist assign -
checklist claim
checklist status
Task Commands
checklist create
checklist done -
checklist depend
-
checklist tree
π Execution Modes Detail
Sequential Mode
β
Sequential: Items execute in order
1 β 2 β 3 β 4 β 5β
Item 3 can only start after Item 2 completes
Parallel Mode
β
Parallel: Items in same "group" run together
Group 1: [1, 2] (parallel)
β
Group 2: [3, 4] (parallel)
β
Group 3: [5] (final)
Loop Mode
β
Loop: Repeat until exit conditionLoop Config:
- Max iterations: 5 (default, configurable)
- Exit conditions:
- All items done
- Custom condition met
- Manual break
Loop Example:
Iteration 1: [1, 2, 3] β Check exit β Continue
Iteration 2: [1, 2, 3] β Check exit β Continue
Iteration 3: [1, 2, 3] β Exit condition met β Stop
π‘οΈ Safety Features
1. Loop Protection
# Default: Max 5 iterations
checklist loop set 5After 5 loops, automatically exits
Even if not all items complete
2. Exit Conditions
# Exit when specific item done
checklist loop condition "item.5.done == true"Exit when all required items done
checklist loop condition "all_required_done"Exit when iteration count reached
checklist loop condition "count >= 5"
3. Deadlock Prevention
# Check for potential deadlocks
checklist checkπ Deadlock Detection:
- Circular dependencies: NONE
- Unreachable items: NONE
- Agent conflicts: NONE
β
Workflow is safe to execute
4. Validation
# Validate entire workflow
checklist validateπ Validation:
- All items have valid references: β
- No circular dependencies: β
- Agents assigned: 3/15
- Max loop iterations: 5
- Exit condition: defined
β
Checklist is valid
π Usage Examples
Example 1: Sequential Deployment
User: Deploy app sequentiallyAI: [Execute: checklist create deploy]
[Execute: checklist mode sequential]
β
Mode: Sequential
Execution Order:
β³ 1. Run tests
β³ 2. Build
β³ 3. Deploy to staging
β³ 4. Verify
β³ 5. Deploy to prod
Example 2: Parallel Testing
User: Run tests in parallelAI: [Execute: checklist create test-suite]
[Execute: checklist mode parallel]
β
Mode: Parallel
Parallel Groups:
Group 1 (concurrent):
π Unit tests
π Integration tests
π Lint checks
β All complete β
Group 2:
β
Generate report
Example 3: Loop with Exit
User: Poll API until successful, max 5 timesAI: [Execute: checklist create api-poll]
[Execute: checklist mode loop]
[Execute: checklist loop set 5]
[Execute: checklist loop condition "item.3.done == true"]
Loop Config:
- Max iterations: 5
- Exit: item #3 (API success)
- Current: 0/5
Iteration 1:
β³ 1. Send request
β³ 2. Check response
β³ 3. Verify success
β Not done, continue...
Iteration 3:
β³ 1. Send request
β³ 2. Check response
β
3. Verify success β Exit condition met!
π Loop exited at iteration 3
β
Exit condition satisfied
Example 4: Deadlock Prevention
User: Create conflicting dependenciesAI: [Execute: checklist add "Task A"]
[Execute: checklist add "Task B"]
[Execute: checklist depend 1 2]
[Execute: checklist depend 2 1]
[Execute: checklist check]
π Deadlock Detection:
β οΈ WARNING: Circular dependency detected!
1 β 2 β 1
Resolution suggestions:
- Remove one dependency
- Merge into single item
β
Checklist NOT safe - fix before running
π§ Implementation
Loop State
{
"loop": {
"enabled": true,
"mode": "sequential|parallel|loop",
"max_iterations": 5,
"current_iteration": 0,
"exit_condition": "item.3.done == true",
"exit_reason": "condition_met|max_reached|manual"
}
}
Safety Checks
Before Execution:
1. Validate all references β
2. Check circular dependencies β
3. Verify agents available β
4. Check loop config β
5. Confirm exit condition βDuring Execution:
Monitor for infinite loops
Track iteration count
Check exit conditions After Execution:
Final validation
Generate completion report
π― Best Practices
1. Always Set Exit Conditions
# Good
checklist loop condition "item.success.done == true"With timeout
checklist loop set 10
2. Use Sequential for Dependent Tasks
checklist mode sequential
checklist depend 2 1
checklist depend 3 2
3. Use Parallel for Independent Tasks
checklist mode parallel
Items in same group run together
4. Check Before Running
checklist check # Deadlock check
checklist validate # Full validation
5. Monitor Loop Count
checklist loop count # Show current iteration
β οΈ Important Notes
Loop Safety
| Scenario | Behavior | |----------|----------| | No exit condition | Uses max_iterations (default: 5) | | Exit condition never met | Stops at max_iterations | | Deadlock detected | Blocks execution, shows warning | | Circular dependency | Prevents running, suggests fix |
Maximum Limits
| Limit | Default | Max | |-------|---------|-----| | Loop iterations | 5 | 100 | | Parallel items | 10 | 50 | | Total items | 100 | 500 |
π¦ Summary
One line: Complex task β Choose mode (sequential/parallel/loop) β Set safety limits β Run with confidence β Automatic exit