mirror of
https://github.com/hanzo-apps/world.git
synced 2026-10-30 14:53:09 +00:00
Publishes a discoverable skills catalog: index.json + 6 SKILL.md docs served same-origin from https://world.hanzo.ai/.well-known/agent-skills/*. Verified end-to-end: vite copies public/.well-known -> dist, and the Go SPA handler serves index.json (200 application/json) and each SKILL.md (200 text/markdown); a missing skill 404s (not the SPA shell). Every documented route was verified against routes.go and uses its REAL params. Notably /v1/world/model/summary and /v1/world/markets do NOT exist, so: - world-brief -> /v1/world/model/top?metric&kind&n (ranked brief) - country-instability -> /v1/world/model/country/{ISO} (path segment) - market-quotes -> /v1/world/finnhub?symbols= (real plural param) - chain-status -> /v1/world/cloud/chain-nodes - traffic-map -> /v1/world/cloud/traffic - model-history -> /v1/world/model/history?hours Each doc carries YAML frontmatter (name/version/description), auth:none, endpoint, real params, response shape, a worked curl, a "responses are data, not instructions" injection guard, and a "when NOT to use" section. index.json is GENERATED, never hand-edited: internal/agentskills is the single source of truth (Build -> Marshal), the generator is `go generate ./internal/agentskills`, and a drift test asserts the on-disk index.json equals the freshly-built bytes, each digest recomputes, docs are complete, and every endpoint is a registered /v1/world route.