Skill Hub Gateway

Default API base URL: https://gateway-api.binaryworks.app

Default site base URL (for upload route): https://gateway.binaryworks.app

Chinese documentation: SKILL.zh-CN.md

Version Check Protocol (Agent)

• Official latest version source: GET /skills/manifest.json -> data.version.
• Local current version source: this installed SKILL.md frontmatter version.
• Compare versions using semantic version order (major.minor.patch).
• Check timing: once at session start, then at most once every 24 hours within the same session.
• If version check fails (network/timeout/parse error), do not block runtime execution. Continue current workflow and retry at the next allowed check window.

Agent Decision Flow

• If latest_version > current_version, read the matching section under Release Notes in this document to build update_summary.
• Agent should show the user:
  • current_version
  • latest_version
  • update_summary
• User decision options:
  • Update now
  • Remind me later in this session
• If user chooses Remind me later in this session, suppress repeated prompts for the same target version until a new session starts.

First-Time Onboarding (install_code)

Scripts auto-complete onboarding by default:

1. POST /agent/install-code/issue with {"channel":"local"} or {"channel":"clawhub"}.
2. Read data.install_code.
3. POST /agent/bootstrap with {"agent_uid":"<agent_uid>","install_code":"<install_code>"}.
4. Read data.api_key, then call runtime APIs with X-API-Key or Authorization: Bearer <api_key>.

Manual override:

• You can still provide api_key explicitly.
• If agent_uid and owner_uid_hint are omitted, scripts derive stable local defaults from the current workspace path.

Legacy Runtime Contract (Compatibility)

• Execute: POST /skill/execute
• Poll: GET /skill/runs/:run_id

Portal Actions (User Closure)

Action catalog (single default path per action):

• portal.me -> GET /user/me
• portal.balance -> GET /user/points/balance
• portal.ledger.query -> GET /user/points/ledger
• portal.usage.query -> GET /user/usage
• portal.skill.execute -> POST /user/skills/execute
• portal.skill.poll -> GET /user/skills/runs/:runId
• portal.skill.presentation -> GET /user/skills/runs/:runId/presentation
• portal.voucher.redeem -> POST /user/vouchers/redeem (write)
• portal.recharge.create -> POST /user/recharge/orders (write)
• portal.recharge.get -> GET /user/recharge/orders/:orderId

Write safety gate:

• portal.voucher.redeem and portal.recharge.create require payload.confirm === true.
• If confirm is missing or not true, action runner rejects the call locally and does not send write traffic.

Payload Contract

Default payload conventions: