agentskills

Overview ¶

Package agentskills is the skill catalogue an AI client reads to learn what it can do.

It serves the Agent Skills Discovery convention (/.well-known/agent-skills/) from a catalogue embedded into the ONE cloud binary.

Surface (root, public, GET-only — the discovery convention):

GET /.well-known/agent-skills/index.json        the brand's MASTER catalogue
GET /.well-known/agent-skills/<skill>/SKILL.md   one skill document

The catalogue is GENERATED by hanzoai/openapi's skills.py from the per-service OpenAPI specs — the ONE source of truth — and embedded here as `catalog/` (regenerated by `go generate ./apps/agentskills` or `make agentskills`). This package does NOT re-derive skills; it only serves the embedded bytes, so the sha256 digests in index.json match the served SKILL.md exactly.

WHITE-LABEL: the brand is decided per request from the Host (BrandForHost, mirroring platform.ts getWhiteLabelBrand) — api.hanzo.ai serves the Hanzo catalogue, api.lux.network the Lux one (`Lux`/`lux.id`), api.zoo.ngo the Zoo one — never Hanzo branding on a Lux/Zoo surface. A Host that resolves to a brand with no embedded catalogue falls back to the deployment brand (CLOUD_BRAND), then to hanzo.

ORDER 8: registered BEFORE IAM (order 50, which mounts app.All("/.well-known/*")) so these exact routes win Fiber's first-match scan, and before the console catch-all `/*`. Public: the routes are installed as plain app routes; the discovery surface carries no secrets and needs no bearer.