AI Task Hub
Formerly skill-hub-gateway.
Public package boundary:
- Only orchestrates
portal.skill.execute, portal.skill.poll, and portal.skill.presentation.
- Does not exchange
api_key or userToken inside this package.
- Does not handle recharge or payment flows inside this package.
- Assumes host runtime injects short-lived task tokens and attachment URLs.
Chinese documentation: SKILL.zh-CN.md
When to Use This Skill
Use this skill when the user asks to:
- detect people, faces, hands, keypoints, or tags from images
- remove backgrounds or generate cutout/matting results for products or portraits
- transcribe uploaded audio into text (
speech to text, audio transcription)
- generate speech from text input (
text to speech, voice generation)
- convert uploaded files into markdown (
document to markdown)
- start async jobs and check status later (
poll, check job status)
- fetch rendered visual outputs such as
overlay, mask, and cutout
- run embedding or reranking tasks for retrieval workflows
Common Requests
Example requests that should trigger this skill:
- "Detect faces in this image and return bounding boxes."
- "Tag this image and summarize the main objects."
- "Remove the background from this product photo."
- "Create a clean cutout from this portrait image."
- "Transcribe this meeting audio into text."
- "Generate speech from this paragraph."
- "Convert this PDF file into markdown."
- "Start this job now and let me poll the run status later."
- "Fetch overlay and mask files for run_456."
- "Generate embeddings for this text list and rerank the candidates."
Search-Friendly Capability Aliases
vision aliases: face detection, human detection, person detection, image tagging
background aliases: remove background, background removal, cutout, matting, product-cutout
asr aliases: speech to text, audio transcription, transcribe audio
tts aliases: text to speech, voice generation, speech synthesis
markdown_convert aliases: document to markdown, file to markdown, markdown conversion
poll aliases: check job status, poll long-running task, async run status
presentation aliases: rendered output, overlay, mask, cutout files
embeddings/reranker aliases: vectorization, semantic vectors, relevance reranking
Runtime Contract
Default API base URL: https://gateway-api.binaryworks.app
Action to endpoint mapping:
portal.skill.execute -> POST /agent/skill/execute
portal.skill.poll -> GET /agent/skill/runs/:run_id
portal.skill.presentation -> GET /agent/skill/runs/:run_id/presentation
Auth Contract (Host-Managed)
Every request must include:
X-Agent-Task-Token: <jwt_or_paseto>
Recommended token claims:
sub (user_id)
agent_uid
conversation_id
scope (execute|poll|presentation)
exp
jti
CLI argument order for scripts/skill.mjs:
[agent_task_token] <action> <payload_json> [base_url]
- If token arg is omitted, script reads
AGENT_TASK_TOKEN from environment.
- Host runtime should refresh and inject short-lived
AGENT_TASK_TOKEN automatically to avoid user-facing auth friction.
Payload Contract
portal.skill.execute: payload requires capability and input.
payload.request_id is optional and passed through.
portal.skill.poll and portal.skill.presentation: payload requires run_id.
portal.skill.presentation supports include_files (defaults to true).
Attachment normalization:
- Prefer explicit
image_url / audio_url / file_url.
attachment.url is mapped to target media field by capability.
- Local
file_path is disabled in the published package.
- Host must upload chat attachments first, then pass URL fields.
- Example host upload endpoint:
/api/blob/upload-file.
Error Contract
- Preserve gateway envelope:
request_id, data, error.
- Preserve
POINTS_INSUFFICIENT and pass through error.details.recharge_url.
Bundled Files
scripts/skill.mjs
scripts/agent-task-auth.mjs
scripts/base-url.mjs
scripts/attachment-normalize.mjs
scripts/telemetry.mjs (compatibility shim)
references/capabilities.json
references/openapi.json
SKILL.zh-CN.md
1---2name: ai-task-hub3description: AI task hub for image analysis, background removal, speech-to-text, text-to-speech, markdown conversion, and async execute/poll/presentation orchestration. Use when users need hosted AI outcomes while host runtime manages identity, credits, payment, and risk control.4version: 3.1.45metadata:6 source: https://skillmd.com/skills/leoyeai-openclaw-master-skills/ai-task-hub7 openclaw:8 skillKey: ai-task-hub9 emoji: "🧩"10 homepage: https://gateway.binaryworks.app11 requires:12 bins:13 - node14 env:15 - AGENT_TASK_TOKEN16 primaryEnv: AGENT_TASK_TOKEN17---1819# AI Task Hub2021Formerly `skill-hub-gateway`.2223Public package boundary:2425- Only orchestrates `portal.skill.execute`, `portal.skill.poll`, and `portal.skill.presentation`.26- Does not exchange `api_key` or `userToken` inside this package.27- Does not handle recharge or payment flows inside this package.28- Assumes host runtime injects short-lived task tokens and attachment URLs.2930Chinese documentation: `SKILL.zh-CN.md`3132## When to Use This Skill3334Use this skill when the user asks to:3536- detect people, faces, hands, keypoints, or tags from images37- remove backgrounds or generate cutout/matting results for products or portraits38- transcribe uploaded audio into text (`speech to text`, `audio transcription`)39- generate speech from text input (`text to speech`, `voice generation`)40- convert uploaded files into markdown (`document to markdown`)41- start async jobs and check status later (`poll`, `check job status`)42- fetch rendered visual outputs such as `overlay`, `mask`, and `cutout`43- run embedding or reranking tasks for retrieval workflows4445## Common Requests4647Example requests that should trigger this skill:4849- "Detect faces in this image and return bounding boxes."50- "Tag this image and summarize the main objects."51- "Remove the background from this product photo."52- "Create a clean cutout from this portrait image."53- "Transcribe this meeting audio into text."54- "Generate speech from this paragraph."55- "Convert this PDF file into markdown."56- "Start this job now and let me poll the run status later."57- "Fetch overlay and mask files for run_456."58- "Generate embeddings for this text list and rerank the candidates."5960## Search-Friendly Capability Aliases6162- `vision` aliases: face detection, human detection, person detection, image tagging63- `background` aliases: remove background, background removal, cutout, matting, product-cutout64- `asr` aliases: speech to text, audio transcription, transcribe audio65- `tts` aliases: text to speech, voice generation, speech synthesis66- `markdown_convert` aliases: document to markdown, file to markdown, markdown conversion67- `poll` aliases: check job status, poll long-running task, async run status68- `presentation` aliases: rendered output, overlay, mask, cutout files69- `embeddings/reranker` aliases: vectorization, semantic vectors, relevance reranking7071## Runtime Contract7273Default API base URL: `https://gateway-api.binaryworks.app`7475Action to endpoint mapping:7677- `portal.skill.execute` -> `POST /agent/skill/execute`78- `portal.skill.poll` -> `GET /agent/skill/runs/:run_id`79- `portal.skill.presentation` -> `GET /agent/skill/runs/:run_id/presentation`8081## Auth Contract (Host-Managed)8283Every request must include:8485- `X-Agent-Task-Token: <jwt_or_paseto>`8687Recommended token claims:8889- `sub` (user_id)90- `agent_uid`91- `conversation_id`92- `scope` (`execute|poll|presentation`)93- `exp`94- `jti`9596CLI argument order for `scripts/skill.mjs`:9798- `[agent_task_token] <action> <payload_json> [base_url]`99- If token arg is omitted, script reads `AGENT_TASK_TOKEN` from environment.100- Host runtime should refresh and inject short-lived `AGENT_TASK_TOKEN` automatically to avoid user-facing auth friction.101102## Payload Contract103104- `portal.skill.execute`: payload requires `capability` and `input`.105- `payload.request_id` is optional and passed through.106- `portal.skill.poll` and `portal.skill.presentation`: payload requires `run_id`.107- `portal.skill.presentation` supports `include_files` (defaults to `true`).108109Attachment normalization:110111- Prefer explicit `image_url` / `audio_url` / `file_url`.112- `attachment.url` is mapped to target media field by capability.113- Local `file_path` is disabled in the published package.114- Host must upload chat attachments first, then pass URL fields.115- Example host upload endpoint: `/api/blob/upload-file`.116117## Error Contract118119- Preserve gateway envelope: `request_id`, `data`, `error`.120- Preserve `POINTS_INSUFFICIENT` and pass through `error.details.recharge_url`.121122## Bundled Files123124- `scripts/skill.mjs`125- `scripts/agent-task-auth.mjs`126- `scripts/base-url.mjs`127- `scripts/attachment-normalize.mjs`128- `scripts/telemetry.mjs` (compatibility shim)129- `references/capabilities.json`130- `references/openapi.json`131- `SKILL.zh-CN.md`