Step one of the builder path is now one TypeScript file: sign a CAIP-122 message with the agent's wallet, trade it for a token, mint a key, make a free call, and ask for a USDC deposit address. A wallet seen for the first time gets its own account and organization on the Free plan. The page shows the file's real output from a 2026-10-26 run. The prompt block takes the updated standard prompt, which puts the wallet path first, and the title carries the pitch. Claude-Session: https://claude.ai/code/session_017vrVus6PPBgP5YRzKV1iqW
20 KiB
LLM.md - Hanzo Skills
Overview
A skill is a directory: {name}/SKILL.md says what it covers and names the files beside it. 224 skills, 1,103 markdown files covering the entire Hanzo AI ecosystem. 210 are ours; fourteen are Anthropic's, redistributed under Apache-2.0 — see NOTICE and the section below.
Company
Positioning, verbatim wherever it appears: "The AI operating system for business. Building business software since 2014. Techstars '17."
The source for Hanzo's history is the founder's account (owner override, 2026-10-26: the founder is the authority; there is no claim ledger). Print it in the company's voice, these numbers and no others:
- Working since 2014. Founded as Crowdstart, a crowdfunding and commerce platform; renamed Hanzo in 2016.
- First customer, 2014: SKULLY, the fastest fully-funded campaign on Indiegogo, $1M in about 45 hours (TechCrunch, 2014-08-14). Not "$1M on the first day": the source says 45 hours.
- Go-native platform since October 2014: the first Go file in the commerce repo is from 2014-10-20; the 2014-09-29 first commit is a CoffeeScript prototype. Never "since day 1".
- AI and machine learning in commercial use since 2014; GPT models by 2019.
- 2017: the first blockchain-native commerce platform; the Unikrn ICO raised over 120,000 ETH (Crunchbase News, 2017-10-24, which does not name Hanzo; Hanzo's part is on https://hanzo.ai/customers#unikrn).
- Techstars '17: https://hanzo.blog/2017-06-08-techstars-17/ (2017-06-08) and Startland News, 2017-10-10.
- Clients funded by Y Combinator, 500 Startups, Techstars and other tier-1 firms: hundreds of venture-funded startups, billions in client revenue, two companies past 100 million users, two that went public on Nasdaq in 2024 (Damon Motorcycles, Triller). "Went public", never "IPO": neither listed by IPO.
- What that portfolio taught is what Hanzo's AI is built on. Never say client data trained it.
- First commit of the commerce platform: 2014-09-29.
- Results, each printed with its source: Damon Motorcycles at CES 2020 ($8.4M sold in 30 days, 541:1 return on ad spend, 60,384 people reached on $329 before launch, every AI-generated ad set rated "Above Average" on Facebook within 36 hours, YouTube subscribers +3,752%; https://hanzo.ai/customers/damon-motorcycles); SKULLY ($1M in about 45 hours; TechCrunch); Unikrn (over 120,000 ETH; Crunchbase News). GPT-2 belongs to the founder's account on the about page only, never beside the case-study numbers.
- People, as https://hanzo.ai/about states: CEO Antje Worring (https://www.linkedin.com/in/antje-worring/), CTO Zach Kelling (https://www.linkedin.com/in/zeekay/, https://github.com/zeekay). Nothing else about Antje.
- Contacts: [email protected], [email protected] (sales), [email protected], [email protected] (investors), https://hanzo.ai/contact, https://cal.com/hanzo. Print no other address: one more alias on the domain has no reader. No support response time exists; promise none.
Not yet provable, and the artifact that would prove it:
- "original AI OS", "first AI chat app", "LLM chat before ChatGPT": a dated public record (commit, archived page, press) older than what it is compared with. "First" is printed only where the owner dates it.
- Hosted MCP in Claude Code:
claude mcp get hanzoanswering Connected against https://api.hanzo.ai/v1/mcp. Today Claude Code 2.1.310 refuses the server's protocol version, 2026-07-28. - The Zed MCP config: a Zed session listing the server's tools. Only the format was checked.
- An agent's email-code sign-up end to end: one run from a test inbox to a minted key.
- The campaign flow (event tag, draft, launch, metrics, pause): one run by a non-admin identity. It is read from cloud's OpenAPI at 93083f029, never executed; print no results for it.
- A checkout method beyond card, Apple Pay and Google Pay: the live checkout offering it.
The hanzo skill
skills/hanzo/SKILL.md (name: hanzo, published as public/hanzo.md, installed with
npx skills add https://hanzoskills.com/hanzo.md) onboards an agent: the standard prompt verbatim, Why
Hanzo and Results (the Company lines above), path A for a builder agent (wallet sign-in with no human,
as one TypeScript file run end to end on 2026-10-26; other credentials, free tier, first call, MCP for
Claude Code, Codex, Cursor and Zed, Kai evaluation, a campaign drafted for the owner to launch, rate
limits), path B for an owner of agents (org, Team plan, bounded keys, per-session caps,
paying, people), then where the rest is.
Every number in it comes from the 2026-10-26 measurement, which marked each line VERIFIED (ran it) or READ
(code at a cited commit). Re-measure before changing one; add none from memory. It prints no bank numbers
(GET /v1/billing/wire gives them to a signed-in caller) and no x402: x402 settles priced marketplace tools
through POST /v1/tool/call, and is not a way to pay for chat or decisions.
The root skill.md also carries name: hanzo; a loader keyed on name keeps one of the two. It is the
local-first manifest and sends onboarding to this skill.
Install
One skill, into any agent, with the skills.sh CLI. The first form fetches the page the site publishes and
needs no GitHub access; the second clones this repository and copies skills/<name>/:
npx skills add https://hanzoskills.com/kai.md # asks for agents and scope
npx skills add hanzoai/skills --skill kai -a claude-code -y # Claude Code, this project, no prompts
-g installs for the user instead of the project; --list shows every skill the clone can install.
Verified with skills 1.7.0: the URL form anonymously against the live cloud-host.md and against kai.md
served from a local build; the clone against github main, 224 skills found, kai written to
.claude/skills/kai/SKILL.md, byte for byte the file in skills/kai/.
Claude Code also takes kai as a plugin of its own. .claude-plugin/marketplace.json lists it with
"source": "./skills/kai", "strict": false and "skills": ["./"], so the plugin is that one directory
and there is no second copy of SKILL.md:
claude plugin marketplace add hanzoai/skills
claude plugin install kai@hanzoai-skills
Verified on Claude Code 2.1.284: claude plugin details kai@hanzoai-skills lists one skill, kai, and the
plugin cache holds only its SKILL.md. The hanzo-skills plugin ("source": "./", the whole repository)
does not install there: .claude-plugin/plugin.json gives author as a string where Claude Code requires
an object, and claude plugin validate . fails on it.
github.com/hanzoai/skills is private, so the clone and the plugin need GitHub access to it. Without that (no
git credentials, gh login or SSH key) the clone fails with Authentication failed. The URL form takes any
page the site publishes, https://hanzoskills.com/<name>.md; kai.md is served once the site deploys.
The Architecture (current truth)
Hanzo runs as ONE Go binary: hanzoai/cloud embeds IAM, KMS, o11y, tasks,
notify, pubsub, kafka, console, and ai as clients/* plugins on zip (the
ZAP-native server) behind the cloud.Register registry. Transport is ZAP
only (HIP-0114) — zero gRPC, zero protobuf in Hanzo code (pb exists solely
at the OTel edge via zap2pb). Storage is SQLite-primary per-tenant plus
datastore (ClickHouse); coordination is Lux Quasar + zapdb — never
ZooKeeper/raft/etcd. Deploy modes (HIP-0117): cloud serve (no k8s),
cloud cluster init (k3s + operator CRs), helm install (BYO k8s).
Canonical skill: skills/hanzo-cloud-architecture/SKILL.md.
Full spec: HIPs 0106, 0114, 0116, 0117, 0004.
Structure
skills/
skills/
hanzo-cloud-architecture/ # THE architecture skill (read first)
SKILL.md
kai/ # building with Kai decisions; installs on its own (see Install)
SKILL.md
hanzo-api/ # product skills — how to CALL api.hanzo.ai; INDEX.md lists 121, ai, kms and sandbox are on disk
INDEX.md # every product, grouped into 13 domains
<product>.md # one per x-app: families, operations, real curls
# GENERATED: scripts/generate_hanzo_api_skills.py
# (source: https://api.hanzo.ai/v1/openapi.json)
hanzo/ # 134 Hanzo ecosystem skills (flat markdown)
INDEX.md # Catalog and decision tree
hanzo-k8s.md # K8s infrastructure
hanzo-deploy.md # Deployment guide
hanzo-platform.md # PaaS (Dokploy fork)
hanzo-id.md # Client auth flows — @hanzo/iam SDK (PKCE, one way)
hanzo-iam.md # IAM server — hanzoai/iam (clean rewrite; retired fork = iam-v1)
hanzo-identity.md # On-chain DID (distinct product, not the IAM login)
hanzo-kms.md # Secrets (luxfi/kms MPC)
hanzo-ingress.md # Ingress (Traefik fork)
hanzo-cloud.md # THE unified one-binary cloud (HIP-0106)
hanzo-console.md # LLM observability (Langfuse)
hanzo-chat.md # Chat UI (LibreChat fork)
hanzo-team.md # Collaboration (Huly fork)
hanzo-bot.md # Multi-channel bot skill
hanzo-mcp.md # Model Context Protocol
hanzo-zap.md # ZAP — THE transport (HIP-0114) + DB bridge
hanzo-o11y.md # Observability (embedded o11y subsystem)
... (134 total)
# 220 other skill directories (api, cloud, ml, etc.)
commands/ # Custom commands
scripts/ # Helper scripts
tests/ # Test suite
The fourteen skills that are not ours
academy-guide, algorithmic-art, brand-guidelines, canvas-design,
claude-api, discernment-nudge, frontend-design, internal-comms,
mcp-builder, skill-creator, slack-gif-creator, theme-factory,
webapp-testing and web-artifacts-builder come from
github.com/anthropics/skills under Apache-2.0, merged at upstream
3b3fad96af16a10759d930941b4520ba0c40edae. They sit flat in skills/ like
every other skill, each with the upstream LICENSE.txt beside its
SKILL.md. That LICENSE.txt is load-bearing — the repository's MIT
licence does not cover those directories. Never delete one to tidy up, and
carry it through any move. NOTICE at the root is the attribution and lists
the two frontmatter changes we made; THIRD_PARTY_NOTICES.md is Anthropic's,
verbatim.
Re-syncing means copying the directory again and re-applying exactly two
things: the license: frontmatter line, which upstream leaves unnamed, and
claude-api's description, which upstream ships at 1068 characters against a
1024 cap that makes it unloadable as-is.
Five upstream skills are absent on purpose. docx, pdf, pptx and
xlsx are source-available, not open source: their LICENSE.txt forbids
copying them, keeping them outside Anthropic's services, deriving from them
and distributing them, so merging them here would violate it four ways.
doc-coauthoring ships with no LICENSE.txt and the upstream repository has
no root licence, so nothing grants us the right — that one is a question for
Anthropic rather than a settled no. Do not add any of the five because they
look like a gap.
The site — hanzoskills.com
public/ is the site, byte for byte. It serves off the Hanzo Sites plane —
an S3 prefix plus a host route, no pod, no image, no replicas. Cloudflare is DNS
and CDN for the zone and nothing else: there is no Pages project, no Worker, and
no Cloudflare credential anywhere in the lane.
public/ index.html + 1,244 <name>.html + <name>.md + all.md, llms.txt, favicon.svg, fonts/
scripts/build.py markdown->html generator: parses skills + core HIPs, formats index & categories
scripts/site.py the shared chrome: style, nav, hero, copy-prompt menu, agent bar, Zen fonts
scripts/marks.py mark geometry, from hanzoai/design assets/{providers,logos}
tests/site.mjs browser checks — mark, menu, bar, computed border-radius, Zen fonts
scripts/build.pycompilesskills/(including 134hanzo/*skills) and all 275 HIPs intopublic/: 1,182 pages. It deletes nothing, so the other 62 pages inpublic/are left from earlier builds. The HIPs come fromHIPS_DIR, whose default is a macOS path; anywhere else point it at ahanzoai/hipscheckout at origin/main, or the index, llms.txt and all.md drop every HIP. A name several files share (tool-use,streaming,batches,files-api,reference,experiments,affiliate-programs) is published once, from whichever fileos.walkreaches first, and that order differs between filesystems: a Linux build and a macOS build of the same tree pick different files for those pages. Standards / HIPs are organized across 5 architectural domains explaining all standards:standards-core(Core AI & Models),standards-infra(Cloud & Native Infrastructure),standards-interface(Protocols & Realtime SSE),standards-security(IAM & Cryptography), andstandards-apps(Platform & Applications). Thehanzocategory (led byhanzo-base,hanzo-cloud,hanzo-migrate-backend-to-go,hanzo-coursework-fullstack-go-cloud,hanzo-tutorial-realtime-sse-backend,hanzo-examples-native-cloud,hanzo-stack) is sorted first.- The site enforces native compiled code only (Go, Rust, C++), migrating away from Python/Next.js/Node/Rails/Java.
Developers have a copy of the entire platform: run a local cloud (
hanzo up cloud), extend with/v1/*, build on Hanzo Base (github.com/hanzoai/base) with realtime native Server-Sent Events (SSE), analytics, and insights, and scale to the full Hanzo AI Cloud (api.hanzo.ai, Zen qwen3+ only). Hanzo AI is Techstars '17. - Typography: Canonical Hanzo
ZenandZen Monovariable font families (public/fonts/Zen-Variable.woff2,Zen-Italic-Variable.woff2,ZenMono-Variable.woff2,ZenMono-Italic-Variable.woff2,ZenPixel-Square.woff2) loaded via@font-facewithfont-display: swap. scripts/site.pyis the ONE definition of the chrome and rewrites every page. It is idempotent, and CI fails ifpublic/does not match it.- The home page opens on two boxes, from
INSTALL,PASTE,NEXTandAFTERinscripts/site.py: the install command for the visitor's OS (tabs; every OS without JS) and the line to paste into an agent.site.pywrites the same block intopublic/index.md. Windows is oneINSTALLrow oncehanzo.sh/install.ps1serves a script (404 on 2026-10-12). - Publishing is
.github/workflows/deploy.ymlon push to main, besideci.yml. That is the only workflow directory here: the forge reads the first one that exists, and the org's ownlinux-amd64runners serve both planes. It callshanzoai/ci/.github/actions/site@v1, which isbin/site: enqueue → upload the objects straight to S3 → complete. The bytes never pass through the API. Do not publish by hand, and do not transcribe those three calls here. - GitHub Actions is off for hanzoai/skills:
gh api repos/hanzoai/skills/actions/permissionsanswers{"enabled": false}, and the last runs, CI and deploy foref27aafon 2026-09-09, were cancelled. Until a repo admin turns it back on, a push to main runs neither workflow and publishes nothing. - ONE credential,
KMS_CLIENT_ID/KMS_CLIENT_SECRET(org-level on git.hanzo.ai), which the action trades atkms.hanzo.aifor the deploy key. - Controls are pills (
--r: 999px) and surfaces are--r-soft: 14px, matching hanzo.ai, whose buttons compute to a full pill at 44px tall.
Where the site lives, outside this repo
Two files in hanzo/universe, both on paths that self-heal:
charts/app/values/hanzo/static-sites.yaml hanzoskills-headers + hanzoskills-static
(root s3://hanzo-sites/hanzo/hanzoskills)
and the apex ‖ www route
infra/k8s/ingress/wildcard-certs.yaml *.hanzoskills.com + hanzoskills.com
Response headers are declared THERE, not here: staticFiles reads objects out of
S3 and never a _headers file, so a header this site wants is a middleware or it
does not exist. DNS is apex + www A -> 129.212.164.5, proxied.
The robots.txt in public/ is the one that is served, and that is the point of
the move — the zone used to answer with a Cloudflare-managed file that named no
crawler at all, on a site whose whole purpose is being read by agents.
Content types
The 1,246 markdown files (the 1,244 page twins, index.md and all.md) are served
text/markdown; charset=utf-8; .html, .txt, .xml and .svg carry their own types.
Measured on the live host for index.md, hanzo-base.md, all.md and hip-0004.md.
scripts/build.py renders headings, lists, quotes, code and paragraphs. It has no table
rule: a markdown table on a page arrives as one paragraph of pipes in the HTML, and intact
in the .md twin.
Key Skills by Domain
Infrastructure
hanzo-k8s.md-- Two DOKS clusters: hanzo-k8s (prod, 22 nodes) and lux-k8s (blockchain)hanzo-deploy.md-- Universe repo is source of truth. main=prod, dev=staginghanzo-ingress.md-- Traefik fork, IngressClasshanzo, auto TLShanzo-static.md-- Traefik static plugin, replaces nginx/caddy
Identity & Security
hanzo-id.md-- RFC 6749/OIDC, multi-org (hanzo/lux/zoo/pars), Cloudflare Workerhanzo-kms.md-- KMSSecret CRDs for K8s sync, 9 Vault subsystemshanzo-zt.md-- Zero-trust (OpenZiti fork), dark services, mTLS
AI Services
hanzo-cloud.md-- THE unified one-binary cloud (HIP-0106);aisubsystem = provider mgmthanzo-skill.md-- HIP-0004 unified AI provider interface at api.hanzo.ai, BYO keyshanzo-console.md-- LLM traces, costs, prompts + per-product metering, 402 balance-gatinghanzo-chat.md-- Multi-model chat UI (14 Zen + 100+ third-party)hanzo-mcp.md-- 260+ tools, 13 HIP-0300 unified toolshanzo-bot.md-- 50+ messaging adapters, ACP skill
Data
hanzo-zap.md-- ZAP: THE transport (HIP-0114) + SQL/KV/Datastore/DocumentDB→MCP bridgehanzo-o11y.md-- Infrastructure APM, embedded in cloud; ClickHouse keeper-free, OTLP-over-ZAP
Hard Rules
- ONE binary, ZAP only -- no gRPC, no protobuf in Hanzo code (pb only at the OTel edge via zap2pb)
- KMS for all secrets -- never plaintext in manifests
- GHCR for images --
ghcr.io/hanzoai/*,--platform linux/amd64; never mix withghcr.io/luxfi/* - Kustomize, not Helm (exception:
cloud/helm/cloudfor BYO-k8s installs) - No nginx, no caddy -- Hanzo Ingress only
- CI = Gitea Actions on git.hanzo.ai (own runners); GitHub = OSS mirror; no GH-hosted builders
- IAM for all auth -- RFC 6749 endpoints, implicit flow preferred
- Universe repo is source of truth for K8s manifests; operator reconciles
services.hanzo.aiCRs - SQLite-primary per-tenant; PostgreSQL only for prod multi-instance; never default to PG locally
- Quasar + zapdb for coordination -- no ZooKeeper, no raft, no etcd
- Zen models: qwen3+ only, never reference upstream names
- luxfi packages only, never go-ethereum or ava-labs
- compose.yml not docker-compose.yml
Production Topology
8 Kubernetes clusters operated; visor autoscales fleets across providers.
Post-consolidation, the standalone notify/tasks/o11y/pubsub/... pods are
retired — they run as subsystems inside the cloud binary. The surviving
distinct surfaces:
hanzo-k8s (do-sfo3-hanzo-k8s, LB: 165.232.146.176)
+-- cloud (ONE binary: IAM/KMS/o11y/tasks/notify/pubsub/kafka/console/ai)
| hanzo.id, kms.hanzo.ai, console.hanzo.ai, o11y.hanzo.ai, ...
+-- Gateway (api.hanzo.ai -- HIP-0004 unified AI interface)
+-- Chat (chat.hanzo.ai), Team (hanzo.team), Bot, DNS, ZT, ...
+-- SQLite per-tenant (in-binary) + PostgreSQL for multi-instance
+-- datastore/ClickHouse (telemetry, keeper-free)
+-- Valkey (redis.hanzo.svc), MinIO (minio.hanzo.svc)
lux-k8s (do-sfo3-lux-k8s, LB: 24.144.69.101)
+-- validators
+-- Gateway (api.lux.network)
+-- Markets, Cloud (white-label of the same binary)