🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Task Engine
πŸ¦€ ClawHub

Task Engine

by @zeron-g

Multi-agent task orchestration engine with state machine tracking. Use when complex multi-step projects need automated monitoring, multi-agent collaboration,...

Versionv1.0.0
#clawhub
πŸ“‹ Tips & Best Practices

Corrupted index.json

python3 scripts/task_engine.py rebuild-index --json

Scans all tasks/TASK-*/task.json files and reconstructs the index. Skips invalid/unreadable files.

Common errors

| Error | Cause | Fix | |-------|-------|-----| | Invalid transition: X + 'event' | Transition not allowed from current state | Check references/state-transitions.md | | Task TASK-XXX not found | Task doesn't exist or was archived | Check tasks/ and tasks/archive/ | | Cannot archive: not terminal | Task must be COMPLETED/FAILED/REJECTED | Transition to terminal state first | | Agent at capacity | Max parallel instances reached | Wait for running subtasks to complete | | Dependency not DONE | Blocked by incomplete subtask | Complete blocking subtask first |

JSON parse errors

The engine handles corrupt JSON files gracefully:

  • During check: skips bad tasks, logs warning, continues
  • During rebuild-index: skips unreadable files, reports in output
  • All CLI commands catch exceptions and return clean error messages (not tracebacks)

    • View on ClawHub
    TERMINAL
    clawhub install task-engine

    πŸ§ͺ Use this skill with your agent

    Most visitors already have an agent. Pick your environment, install or copy the workflow, then run the smoke-test prompt above.

    Manus
    Task-oriented agent. Great for testing AI skills end-to-end.
    Try Manus β†’
    OpenClaw
    Local-first agent. Install skills via ClawHub CLI.
    Set up OpenClaw β†’
    Claude Code
    Anthropic's coding agent. Paste the prompt or SKILL.md into your session.
    Claude Code docs β†’
    Cursor
    AI-powered IDE. Use the smoke-test prompt in Cursor Agent.
    Open Cursor β†’
    Continue.dev
    Open-source AI code assistant. Add SKILL.md as a custom tool.
    Continue docs β†’
    Windsurf
    Agentic IDE by Codeium. Paste the prompt into Cascade.
    Try Windsurf β†’
    Cline
    VS Code extension for autonomous coding with MCP tools.
    Cline on GitHub β†’
    Copilot Workspace
    GitHub's AI dev environment. Suitable for code-generation skills.
    Copilot Workspace β†’

    πŸ” Can't find the right skill?

    Search 60,000+ AI agent skills β€” free, no login needed.

    Search Skills β†’