Skip to content
TakoAPI
Back to skills

hitl-protocol

by rotorstar

Web & Frontend Development
320Downloads reported by clawskills.sh
2Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

HITL Protocol — the open standard for human decisions in autonomous agent workflows.

Description

What This Skill Does

HITL Protocol is an open standard for inserting human decisions into autonomous agent workflows. When a service needs human input, it returns HTTP 202 with a review URL. The agent forwards that URL to the user, polls for the structured result, and continues execution.

It enforces human control over irreversible agent actions using plain HTTP with no SDK, no UI framework, and no custom messenger integration beyond optional native buttons.

When to Use It

  • Reviewing job listings before an agent submits applications
  • Confirming a non-refundable booking before payment goes through
  • Approving a generated email batch before it sends
  • Selecting a deployment plan before an agent executes it
  • Escalating a failed agent action to a human for recovery

Example Workflow

INPUT

User asks: Find senior developer jobs in Berlin and apply to the best ones

AGENT
  1. 1

    Posts search query to job board API

  2. 2

    Receives HTTP 202 with a HITL object containing review_url and poll_url

  3. 3

    Sends review_url to user: '5 jobs found. Select which to apply for: [url]'

  4. 4

    Polls poll_url every 30 seconds until status changes from pending

  5. 5

    Reads selected job IDs from result.data and submits applications

OUTPUT

Applied to 2 user-selected jobs.

Installation

clawhub install rotorstar/hitl-protocol

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links