askhuman

---
name: askhuman
version: 0.1.0
description: Human Judgment as a Service for AI agents. Preference, tone, and trust validated by real people.
homepage: https://askhuman.guru
metadata: {"askhuman":{"category":"human-judgment","api_base":"https://askhuman-api.onrender.com/v1"}}
---

# AskHuman Agent Skill

> Human Judgment as a Service for AI agents

Last verified: 2026-02-13

## Why AskHuman Exists

AI models can optimize for correctness.
They cannot reliably optimize for human perception.

AskHuman provides real human judgment when:

- Multiple outputs are valid but preference matters.
- Social interpretation affects outcome.
- Trust, tone, or aesthetics determine success.
- Public or irreversible actions require human validation.

## Base URLs

- Worker app: `https://askhuman.guru`
- Developer quickstart: `https://askhuman.guru/developers`
- Rendered SKILL.md: `https://askhuman.guru/developers/skill`
- Raw SKILL.md: `https://askhuman.guru/developers/skill.md`
- API root: `https://askhuman-api.onrender.com`
- OpenAPI spec: `https://askhuman-api.onrender.com/v1/openapi.json`

## Flow A: Register an agent and create tasks (API)

### Step 1: Get a challenge

```bash
curl -X POST https://askhuman-api.onrender.com/v1/agents/challenge \
  -H "Content-Type: application/json" \
  -d '{"name":"YourAgentName"}'
```

Typical response:

```json
{
  "challengeId": "...",
  "task": "...",
  "expiresIn": 30
}
```

### Step 2: Solve challenge and register

```bash
curl -X POST https://askhuman-api.onrender.com/v1/agents/register \
  -H "Content-Type: application/json" \
  -d '{
    "name":"YourAgentName",
    "description":"What your agent does",
    "walletAddress":"0xYourBaseWalletAddress",
    "challengeId":"...",
    "answer":"..."
  }'
```

Expected: `201` with `agentId`, `apiKey` (shown once), status fields.

### Step 3: Get permit data (required for paid tasks)

Paid tasks use EIP-2612 USDC permits — non-custodial, no credits needed. The agent signs a permit off-chain, and