mirror of
https://github.com/hanzoai/skills.git
synced 2026-11-19 00:47:36 +00:00
755 lines
36 KiB
Python
755 lines
36 KiB
Python
#!/usr/bin/env python3
|
|
"""Render the shared chrome of public/*.html: style, nav, hero, agent bar.
|
|
|
|
Every page carries one style block and one nav. Both are defined here and
|
|
written into every file, so the chrome has a single definition. Page bodies are
|
|
left untouched. Idempotent: running twice changes nothing, and CI runs it to
|
|
assert public/ matches this file.
|
|
"""
|
|
import glob
|
|
import hashlib
|
|
import html
|
|
import json
|
|
import os
|
|
import posixpath
|
|
import re
|
|
import sys
|
|
|
|
sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
|
|
from marks import MARK # noqa: E402
|
|
|
|
ROOT = os.path.join(os.path.dirname(os.path.dirname(os.path.abspath(__file__))), "public")
|
|
|
|
# The block-H, from @hanzo/logo (MARK_PATHS / MARK_VIEWBOX).
|
|
HANZO = ("0 0 67 67", "".join(
|
|
'<path d="%s"/>' % d for d in (
|
|
"M22.21 67V44.6369H0V67H22.21Z",
|
|
"M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z",
|
|
"M22.21 0H0V22.3184H22.21V0Z",
|
|
"M66.7198 0H44.5098V22.3184H66.7198V0Z",
|
|
"M66.7198 67V44.6369H44.5098V67H66.7198Z",
|
|
)))
|
|
MARK["hanzo"] = HANZO
|
|
|
|
FAVICON = """<svg viewBox="0 0 64 64" xmlns="http://www.w3.org/2000/svg">
|
|
<rect width="64" height="64" rx="8" fill="#000000"/>
|
|
<g transform="translate(8, 8) scale(0.716)">
|
|
%s
|
|
</g>
|
|
</svg>
|
|
""" % "\n".join(' <path d="%s" fill="#ffffff"/>' % d for d in re.findall(r'd="([^"]+)"', HANZO[1]))
|
|
|
|
|
|
def svg(name, cls="mark"):
|
|
vb, body = MARK[name]
|
|
return ('<svg class="%s" viewBox="%s" fill="currentColor" aria-hidden="true">%s</svg>'
|
|
% (cls, vb, body))
|
|
|
|
|
|
# Every target gets its own prompt: the install path and file format differ per
|
|
# tool, so one shared string would be wrong everywhere but one place.
|
|
AGENTS = [
|
|
("claude-code", "Claude Code", "claude", """\
|
|
Set up the Hanzo skills in this Claude Code session.
|
|
|
|
1. Read https://hanzoskills.com/skill.md — the onboarding manifest.
|
|
2. Fetch https://hanzoskills.com/llms.txt for the index of every document.
|
|
3. Install a skill by writing https://hanzoskills.com/<name>.md to
|
|
~/.claude/skills/<name>/SKILL.md — one directory per skill.
|
|
4. Verify with: ls ~/.claude/skills
|
|
|
|
Everything is plain markdown over https and needs no auth."""),
|
|
|
|
("codex", "Codex", "codex", """\
|
|
Set up the Hanzo skills in this Codex session.
|
|
|
|
1. Read https://hanzoskills.com/skill.md — the onboarding manifest.
|
|
2. Fetch https://hanzoskills.com/llms.txt for the index of every document.
|
|
3. Codex reads AGENTS.md. Append the manifest to ./AGENTS.md for this repo,
|
|
and to ~/.codex/AGENTS.md to load it in every project.
|
|
4. Pull single skills from https://hanzoskills.com/<name>.md and append the
|
|
ones you need under a "Hanzo skills" heading.
|
|
|
|
Everything is plain markdown over https and needs no auth."""),
|
|
|
|
("cursor", "Cursor", "cursor", """\
|
|
Set up the Hanzo skills in this Cursor workspace.
|
|
|
|
1. Read https://hanzoskills.com/skill.md — the onboarding manifest.
|
|
2. Write .cursor/rules/hanzo.mdc containing the manifest under this front
|
|
matter:
|
|
---
|
|
description: Hanzo platform skills
|
|
alwaysApply: true
|
|
---
|
|
3. Add one .cursor/rules/<name>.mdc per skill from
|
|
https://hanzoskills.com/<name>.md, with alwaysApply: false so Cursor
|
|
attaches it by description.
|
|
|
|
Everything is plain markdown over https and needs no auth."""),
|
|
|
|
("copilot", "Copilot", "copilot", """\
|
|
Set up the Hanzo skills for GitHub Copilot in this repo.
|
|
|
|
1. Read https://hanzoskills.com/skill.md — the onboarding manifest.
|
|
2. Copilot reads .github/copilot-instructions.md. Write the manifest there.
|
|
3. Add one .github/instructions/<name>.instructions.md per skill from
|
|
https://hanzoskills.com/<name>.md, each with front matter:
|
|
---
|
|
applyTo: "**"
|
|
---
|
|
|
|
Everything is plain markdown over https and needs no auth."""),
|
|
|
|
("gemini-cli", "Gemini CLI", "gemini", """\
|
|
Set up the Hanzo skills in this Gemini CLI session.
|
|
|
|
1. Read https://hanzoskills.com/skill.md — the onboarding manifest.
|
|
2. Gemini CLI reads GEMINI.md. Write the manifest to ./GEMINI.md for this
|
|
repo, or ~/.gemini/GEMINI.md to load it everywhere.
|
|
3. Pull single skills from https://hanzoskills.com/<name>.md and add them as
|
|
@-imports so context stays small.
|
|
|
|
Everything is plain markdown over https and needs no auth."""),
|
|
|
|
("qwen-code", "Qwen Code", "qwen", """\
|
|
Set up the Hanzo skills in this Qwen Code session.
|
|
|
|
1. Read https://hanzoskills.com/skill.md — the onboarding manifest.
|
|
2. Qwen Code reads QWEN.md. Write the manifest to ./QWEN.md for this repo,
|
|
or ~/.qwen/QWEN.md to load it everywhere.
|
|
3. Pull single skills from https://hanzoskills.com/<name>.md as you need
|
|
them rather than loading the whole corpus.
|
|
|
|
Everything is plain markdown over https and needs no auth."""),
|
|
|
|
("anthropic-sdk", "Anthropic SDK", "anthropic", """\
|
|
Wire the Hanzo skills into an Anthropic SDK agent.
|
|
|
|
1. Fetch https://hanzoskills.com/skill.md and put it in the system prompt —
|
|
it is the onboarding manifest.
|
|
2. Fetch https://hanzoskills.com/llms.txt and expose it as a tool result so
|
|
the model can choose a document by name.
|
|
3. Resolve a choice by fetching https://hanzoskills.com/<name>.md on demand.
|
|
Load per request, not all at once.
|
|
|
|
Everything is plain markdown over https and needs no auth."""),
|
|
|
|
("openai-sdk", "OpenAI SDK", "openai", """\
|
|
Wire the Hanzo skills into an OpenAI SDK agent.
|
|
|
|
1. Fetch https://hanzoskills.com/skill.md and pass it as a system/developer
|
|
message — it is the onboarding manifest.
|
|
2. Fetch https://hanzoskills.com/llms.txt and expose a function tool that
|
|
returns it, so the model can pick a document by name.
|
|
3. Have the tool fetch https://hanzoskills.com/<name>.md on demand. Load per
|
|
request, not all at once.
|
|
|
|
Everything is plain markdown over https and needs no auth."""),
|
|
|
|
("openclaw", "OpenClaw", "openclaw", """\
|
|
Set up the Hanzo skills in OpenClaw.
|
|
|
|
1. Read https://hanzoskills.com/skill.md — the onboarding manifest.
|
|
2. OpenClaw reads, in order: <workspace>/skills, <workspace>/.agents/skills,
|
|
then ~/.agents/skills. Write each skill to
|
|
~/.agents/skills/<name>/SKILL.md from https://hanzoskills.com/<name>.md
|
|
3. For a managed global copy instead, install with --global, which uses
|
|
~/.openclaw/skills.
|
|
|
|
Everything is plain markdown over https and needs no auth."""),
|
|
|
|
("hanzo-bot", "Hanzo Bot", "hanzo", """\
|
|
Set up the Hanzo skills in Hanzo Bot.
|
|
|
|
1. Read https://hanzoskills.com/skill.md — the onboarding manifest.
|
|
2. Write each skill to ~/.hanzo/bot/skills/<name>/SKILL.md from
|
|
https://hanzoskills.com/<name>.md
|
|
3. A skills directory in the workspace takes precedence, so put project-only
|
|
skills in <workspace>/skills instead.
|
|
|
|
Everything is plain markdown over https and needs no auth."""),
|
|
|
|
("hanzo-dev", "Hanzo Dev", "hanzo", """\
|
|
Set up the Hanzo skills in Hanzo Dev.
|
|
|
|
1. Read https://hanzoskills.com/skill.md — the onboarding manifest.
|
|
2. Write each skill to ~/.agents/skills/<name>/SKILL.md from
|
|
https://hanzoskills.com/<name>.md
|
|
3. For skills that belong to one repo, use <repo>/.agents/skills/<name>/
|
|
instead — dev walks up to the git root and prefers the repo copy.
|
|
|
|
Everything is plain markdown over https and needs no auth."""),
|
|
]
|
|
|
|
# The dropdown is the short path: the three harnesses people paste into most,
|
|
# then the manifest itself. The bar below carries the full set.
|
|
MENU = ["claude-code", "codex", "cursor"]
|
|
|
|
CSS = """
|
|
/* Committed to one visual world: a dark instrument panel. No light variant —
|
|
the dot field and the hairline rules only read on black, and a naive
|
|
inversion would wash both out. Every colour is painted explicitly so the page
|
|
never borrows a host background. */
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
|
|
|
|
:root{
|
|
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
|
|
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
|
|
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
|
|
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
|
|
--font-zen-pixel-square:'Zen Pixel Square',monospace;
|
|
--mono:var(--font-zen-mono);
|
|
--sans:var(--font-zen-sans);
|
|
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
|
|
--r:999px; --r-soft:14px;
|
|
}
|
|
*{box-sizing:border-box}
|
|
html{-webkit-text-size-adjust:100%}
|
|
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
|
|
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
|
|
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
|
|
|
|
/* The dot field. A halftone made of one repeating radial-gradient, faded out
|
|
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
|
|
/* No overflow clip here: the dot field is inset to the box already, and a clip
|
|
would cut off the copy-prompt menu. */
|
|
.hero{position:relative;border-bottom:1px solid var(--line)}
|
|
.hero::before{content:"";position:absolute;inset:0;
|
|
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
|
|
background-size:7px 7px;
|
|
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
pointer-events:none}
|
|
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
|
|
|
|
nav{border-bottom:1px solid var(--line)}
|
|
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
|
|
justify-content:space-between;align-items:center;gap:1rem}
|
|
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--ink);text-decoration:none;
|
|
display:inline-flex;align-items:center;gap:.6rem}
|
|
.brand i{font-style:normal;color:var(--faint)}
|
|
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
|
|
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--soft);text-decoration:none}
|
|
nav a.up:hover{color:var(--ink)}
|
|
|
|
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
|
|
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
|
|
h1 em{font-style:normal;color:var(--faint)}
|
|
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
|
|
|
|
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
|
|
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
|
|
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
|
|
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
|
|
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
|
|
line-height:1.2;font-weight:400}
|
|
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
|
|
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
|
|
.btn.solid:hover{background:#d8d8d4}
|
|
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
|
|
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
|
|
|
|
/* Copy-prompt selector. Each row copies the prompt for its own target. */
|
|
.copy{position:relative;display:inline-flex}
|
|
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
|
|
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
|
|
padding:.4rem;display:flex;flex-direction:column;
|
|
box-shadow:0 12px 32px rgba(0,0,0,.75)}
|
|
.menu[hidden]{display:none}
|
|
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
|
|
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
|
|
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
|
|
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
|
|
white-space:nowrap}
|
|
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
|
|
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
|
|
.mi:hover .mark{color:var(--ink)}
|
|
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
|
|
letter-spacing:.1em;text-transform:uppercase}
|
|
|
|
/* Works-with bar: one scrolling row, name and mark per agent. */
|
|
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
|
|
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
|
|
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
|
|
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
|
|
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
|
|
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
|
|
display:flex;align-items:center}
|
|
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
|
|
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
|
|
-webkit-overflow-scrolling:touch;
|
|
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
|
|
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
|
|
.bar::-webkit-scrollbar{display:none}
|
|
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
|
|
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
|
|
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
|
|
text-decoration:none;background:var(--ground)}
|
|
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
|
|
.agent .mark{width:.95rem;height:.95rem}
|
|
|
|
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
|
|
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
|
|
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
|
|
p{margin:0 0 1rem;max-width:70ch}
|
|
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
|
|
li{margin:.22rem 0}
|
|
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
|
|
text-decoration-color:var(--line-hi)}
|
|
a:hover{text-decoration-color:var(--ink)}
|
|
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
|
|
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
|
|
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
|
|
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
|
|
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
|
|
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
|
|
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
|
|
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
|
|
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
|
|
display:block;overflow-x:auto}
|
|
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
|
|
|
|
.curl{display:block;background:var(--panel);border:1px solid var(--line);
|
|
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
|
|
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
|
|
white-space:pre;line-height:1.9}
|
|
.curl b{color:var(--ink);font-weight:400}
|
|
.curl i{font-style:normal;color:var(--faint)}
|
|
|
|
/* index */
|
|
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
|
|
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
|
|
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
|
|
#q:focus{outline:none;border-color:var(--soft)}
|
|
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
|
|
text-transform:uppercase;margin:0 0 2rem}
|
|
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
|
|
padding-bottom:.45rem}
|
|
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
|
|
border-radius:var(--r-soft);text-decoration:none}
|
|
.row:hover{background:#0a0a0a}
|
|
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
|
|
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
|
|
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
|
|
color:var(--faint);font-size:.85rem}
|
|
footer a{color:var(--soft)}
|
|
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
|
|
margin:0 0 2rem;font-size:.85rem}
|
|
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
|
|
border-bottom:1px solid var(--line);padding-bottom:.4rem}
|
|
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
|
|
.fmap a:hover{text-decoration:underline}
|
|
.fmap div{color:var(--faint);line-height:1.5}
|
|
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
|
|
|
|
@media (max-width:640px){
|
|
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
|
|
.btns{gap:.5rem}
|
|
.btn{padding:.75rem 1.15rem;font-size:.68rem}
|
|
.copy,.copy .btn{width:100%;justify-content:center}
|
|
.menu{left:0;right:0;min-width:0}
|
|
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
|
|
.strip b{border-right:0;padding-right:0}
|
|
.bar{width:100%}
|
|
}
|
|
"""
|
|
|
|
CHEV = ('<svg class="chev" viewBox="0 0 12 12" fill="none" stroke="currentColor" '
|
|
'stroke-width="1.6" aria-hidden="true"><path d="M2.5 4.5 6 8l3.5-3.5"/></svg>')
|
|
|
|
|
|
def nav(up_href, up_text):
|
|
return ('<nav><div class="in">\n'
|
|
' <a class="brand" href="/">%s HANZO<i>SKILLS</i></a>\n'
|
|
' <a class="up" href="%s">%s</a>\n'
|
|
'</div></nav>' % (svg("hanzo"), up_href, up_text))
|
|
|
|
|
|
def btns():
|
|
rows = []
|
|
for aid, name, mark, _ in AGENTS:
|
|
if aid in MENU:
|
|
rows.append('<button class="mi" role="menuitem" type="button" data-a="%s">'
|
|
'%s Open in %s<u>copy</u></button>' % (aid, svg(mark), html.escape(name)))
|
|
rows.append('<a class="mi" role="menuitem" href="/skill">%s View skill.md</a>' % svg("hanzo"))
|
|
prompts = {aid: p for aid, _, _, p in AGENTS}
|
|
return (
|
|
'<div class="btns">'
|
|
'<div class="copy">'
|
|
'<button class="btn solid" id="copybtn" type="button" aria-haspopup="menu" '
|
|
'aria-expanded="false" aria-controls="copymenu">Copy setup prompt %s</button>'
|
|
'<div class="menu" id="copymenu" role="menu" aria-labelledby="copybtn" hidden>%s</div>'
|
|
'</div>'
|
|
'<a class="btn" href="/hanzo-base">Upgrade to Native Go</a>'
|
|
'<a class="btn" href="/hanzo-migrate-backend-to-go">Migration Guide</a>'
|
|
'<a class="btn" href="/hanzo-coursework-fullstack-go-cloud">Go Coursework</a>'
|
|
'<a class="btn" href="/hanzo-tutorial-realtime-sse-backend">SSE Tutorial</a>'
|
|
'<a class="btn" href="/hanzo-examples-native-cloud">Code Examples</a>'
|
|
'<a class="btn" href="/llms.txt">Index for agents</a>'
|
|
'<a class="btn" href="https://hanzo.codes">Code with an agent</a>'
|
|
'</div>'
|
|
'<script type="application/json" id="prompts">%s</script>'
|
|
% (CHEV, "".join(rows),
|
|
json.dumps(prompts, ensure_ascii=False).replace("</", "<\\/")))
|
|
|
|
|
|
def strip():
|
|
chips = "".join(
|
|
'<span class="agent">%s %s</span>' % (svg(mark), html.escape(name))
|
|
for _, name, mark, _ in AGENTS)
|
|
return ('<div class="strip"><div class="in"><b>Drop into any agent</b>'
|
|
'<div class="bar">%s</div></div></div>' % chips)
|
|
|
|
|
|
COPY_JS = """
|
|
<script id="copyjs">
|
|
(function(){
|
|
var b=document.getElementById('copybtn'),m=document.getElementById('copymenu'),
|
|
P=JSON.parse(document.getElementById('prompts').textContent);
|
|
function open(v){m.hidden=!v;b.setAttribute('aria-expanded',v?'true':'false');}
|
|
b.addEventListener('click',function(e){e.stopPropagation();open(m.hidden);});
|
|
document.addEventListener('click',function(e){if(!m.contains(e.target))open(false);});
|
|
document.addEventListener('keydown',function(e){if(e.key==='Escape')open(false);});
|
|
m.addEventListener('click',function(e){
|
|
var t=e.target.closest('.mi[data-a]');if(!t)return;
|
|
var p=P[t.dataset.a],u=t.querySelector('u');
|
|
navigator.clipboard.writeText(p).then(function(){
|
|
u.textContent='copied';setTimeout(function(){u.textContent='copy';},1400);
|
|
});
|
|
open(false);
|
|
});
|
|
})();
|
|
</script>"""
|
|
|
|
|
|
# The install command per OS, in tab order; the page opens on the visitor's OS.
|
|
# Windows is one row here, once hanzo.sh/install.ps1 serves a script:
|
|
# ("win", "Windows", "irm hanzo.sh/install.ps1 | iex"),
|
|
INSTALL = [
|
|
("mac", "macOS", "curl -fsSL hanzo.sh | sh"),
|
|
("linux", "Linux", "curl -fsSL hanzo.sh | sh"),
|
|
("wsl", "WSL", "curl -fsSL hanzo.sh | sh"),
|
|
]
|
|
PASTE = "Set up Hanzo on this machine: follow https://hanzo.sh/setup.md"
|
|
PASTE_TO = "Claude Code, Codex, Cursor, Antigravity"
|
|
NEXT = ("Then run <code>hanzo</code>. It signs you in through the browser, links this machine "
|
|
"to Hanzo Tabs, asks once which coding agent is your favourite, adds Hanzo's tools to it, "
|
|
"and launches it accelerated.")
|
|
AFTER = ("After that, <code>hanzo</code> launches your favourite, "
|
|
"<code>hanzo dev --claude|--codex|--cursor|--agy</code> switches it, and "
|
|
"<code>hanzo -- -c</code> continues the last conversation.")
|
|
|
|
GET_CSS = """
|
|
.get{display:grid;grid-template-columns:minmax(0,3fr) minmax(0,2fr);gap:1rem;margin:0 0 2.25rem}
|
|
.gbox{background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
|
|
padding:1rem 1.1rem;min-width:0}
|
|
.ghead{display:flex;flex-wrap:wrap;align-items:center;justify-content:space-between;
|
|
gap:.5rem .75rem;margin:0 0 .8rem;min-height:1.9rem}
|
|
.ghead b{font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;text-transform:uppercase;
|
|
font-weight:500;color:var(--soft)}
|
|
.ghead span{font-family:var(--mono);font-size:.68rem;letter-spacing:.04em;color:var(--faint)}
|
|
.tabs{display:inline-flex;gap:.2rem;border:1px solid var(--line);border-radius:var(--r);padding:.18rem}
|
|
.tabs[hidden]{display:none}
|
|
.tab{border:0;background:transparent;color:var(--soft);font-family:var(--mono);font-size:.7rem;
|
|
letter-spacing:.06em;padding:.32rem .8rem;border-radius:var(--r);cursor:pointer}
|
|
.tab:hover{color:var(--ink)}
|
|
.tab[aria-selected="true"]{background:var(--ink);color:#000}
|
|
.tab:focus-visible,.cp:focus-visible{outline:1px solid var(--ink);outline-offset:2px}
|
|
.cmd{display:flex;align-items:center;gap:.75rem;background:var(--ground);border:1px solid var(--line);
|
|
border-radius:10px;padding:.55rem .55rem .55rem .9rem;margin:0 0 .5rem}
|
|
.cmd[hidden]{display:none}
|
|
.cmd code{flex:1 1 auto;min-width:0;background:none;border:0;padding:0;font-size:.84rem;
|
|
color:var(--ink);white-space:pre-wrap;overflow-wrap:anywhere;line-height:1.5}
|
|
.os{flex:0 0 3.4rem;font-family:var(--mono);font-size:.6rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--faint)}
|
|
.get.js .os{display:none}
|
|
.cp{display:none;flex:0 0 auto;border:1px solid var(--line-hi);background:transparent;color:var(--ink);
|
|
font-family:var(--mono);font-size:.62rem;letter-spacing:.12em;text-transform:uppercase;
|
|
padding:.42rem .85rem;border-radius:var(--r);cursor:pointer}
|
|
.get.js .cp{display:inline-flex}
|
|
.cp:hover{background:#141414;border-color:var(--soft)}
|
|
.next{color:var(--soft);font-size:.86rem;line-height:1.6;margin:.7rem 0 0}
|
|
.next code{overflow-wrap:anywhere}
|
|
@media (max-width:860px){.get{grid-template-columns:minmax(0,1fr)}}
|
|
"""
|
|
|
|
GET_JS = """
|
|
<script id="getjs">
|
|
(function(){
|
|
var g=document.querySelector('.get'),L=g.querySelector('.tabs'),
|
|
T=[].slice.call(L.querySelectorAll('.tab'));
|
|
g.classList.add('js');
|
|
function pick(os){T.forEach(function(t){var on=t.dataset.os===os;
|
|
t.setAttribute('aria-selected',on?'true':'false');
|
|
document.getElementById(t.getAttribute('aria-controls')).hidden=!on;});}
|
|
var u=navigator.userAgentData,p=((u&&u.platform)||navigator.platform||'')+' '+navigator.userAgent,
|
|
os=/windows|win32|win64/i.test(p)?'win':/mac|iphone|ipad/i.test(p)?'mac':/linux|x11|cros/i.test(p)?'linux':'';
|
|
if(os==='win'&&!L.querySelector('[data-os="win"]'))os='wsl';
|
|
var f=L.querySelector('[data-os="'+os+'"]')||T[0];
|
|
L.insertBefore(f,L.firstChild);L.hidden=false;pick(f.dataset.os);
|
|
L.addEventListener('click',function(e){var t=e.target.closest('.tab');if(t)pick(t.dataset.os);});
|
|
g.addEventListener('click',function(e){var b=e.target.closest('.cp');if(!b)return;
|
|
navigator.clipboard.writeText(b.previousElementSibling.textContent).then(function(){
|
|
b.textContent='Copied';setTimeout(function(){b.textContent='Copy';},1400);});});
|
|
})();
|
|
</script>"""
|
|
|
|
|
|
def get():
|
|
tabs = "".join(
|
|
'<button class="tab" role="tab" type="button" id="tab-%s" data-os="%s" '
|
|
'aria-controls="os-%s" aria-selected="false">%s</button>' % (o, o, o, html.escape(n))
|
|
for o, n, _ in INSTALL)
|
|
cmds = "".join(
|
|
'<div class="cmd" id="os-%s" role="tabpanel" aria-labelledby="tab-%s">'
|
|
'<span class="os">%s</span><code>%s</code>'
|
|
'<button class="cp" type="button" aria-label="Copy the %s install command">Copy</button></div>'
|
|
% (o, o, html.escape(n), html.escape(c), html.escape(n))
|
|
for o, n, c in INSTALL)
|
|
return (
|
|
'<section class="get" aria-label="Get started"><style>%s</style>'
|
|
'<div class="gbox"><div class="ghead"><b>Install</b>'
|
|
'<div class="tabs" role="tablist" aria-label="Operating system" hidden>%s</div></div>'
|
|
'%s<p class="next">%s</p><p class="next">%s</p></div>'
|
|
'<div class="gbox"><div class="ghead"><b>Or paste into your agent</b><span>%s</span></div>'
|
|
'<div class="cmd"><code>%s</code>'
|
|
'<button class="cp" type="button" aria-label="Copy the setup line for your agent">Copy</button>'
|
|
'</div></div>%s</section>'
|
|
% (GET_CSS, tabs, cmds, NEXT, AFTER, html.escape(PASTE_TO), html.escape(PASTE), GET_JS))
|
|
|
|
|
|
def get_md():
|
|
rows = {}
|
|
for _, n, c in INSTALL:
|
|
rows.setdefault(c, []).append(n)
|
|
width = max(len(c) for c in rows)
|
|
plain = lambda s: re.sub(r"</?code>", "`", s)
|
|
return ("## Install\n\n"
|
|
+ "".join(" %s # %s\n" % (c.ljust(width), ", ".join(ns)) for c, ns in rows.items())
|
|
+ "\n%s %s\n\nOr paste this into your agent (%s):\n\n %s\n\n"
|
|
"The skills, over plain https:\n\n"
|
|
% (plain(NEXT), plain(AFTER), PASTE_TO, PASTE))
|
|
|
|
|
|
BEACON = re.compile(r'\s*<script[^>]*cloudflareinsights\.com[^>]*>\s*</script>', re.S)
|
|
|
|
|
|
def patch(path):
|
|
src = open(path, encoding="utf-8").read()
|
|
# Cloudflare adds its analytics beacon at the edge; it is not ours to ship.
|
|
out = BEACON.sub("", src)
|
|
out = re.sub(r"<style>.*?</style>", lambda _: "<style>%s</style>" % CSS, out, count=1, flags=re.S)
|
|
|
|
up = re.search(r'<a class="up" href="([^"]+)">([^<]+)</a>', out)
|
|
out = re.sub(r"<nav>.*?</nav>", lambda _: nav(up.group(1), up.group(2)), out, count=1, flags=re.S)
|
|
|
|
name = os.path.basename(path)[:-5]
|
|
slug = "" if name == "index" else name
|
|
# Markdown is a twin file, not content negotiation: /<path>.md.
|
|
out = out.replace(
|
|
" Send no Accept: text/html and any path returns markdown. -->",
|
|
" Append .md to any path for the markdown twin. -->")
|
|
# Every page names its twin, and loads the WebMCP tools (scripts/webmcp.ts).
|
|
twin = os.path.exists(path[:-5] + ".md")
|
|
head = ('<link rel="icon" href="/favicon.svg">\n'
|
|
'<link rel="canonical" href="https://hanzoskills.com/%s">\n' % slug
|
|
+ ('<link rel="alternate" type="text/markdown" href="/%s.md">\n' % name if twin else "")
|
|
+ '<script type="module" src="/webmcp.js"></script>\n')
|
|
out = re.sub(r'\s*<link rel="(?:icon|canonical|alternate)"[^>]*>', "", out)
|
|
out = re.sub(r'\s*<script type="module" src="/webmcp\.js"></script>', "", out)
|
|
out = re.sub(r"\s*</head>", lambda _: "\n" + head + "</head>", out, count=1)
|
|
|
|
if os.path.basename(path) == "index.html":
|
|
# Anchored on markup outside each region so a rewritten page re-matches
|
|
# exactly the same span.
|
|
hero_h1_lede = (
|
|
'<h1>The native cloud in a single binary.<br>Go. Rust. C++. '
|
|
'<em>Zero interpreter bloat.</em></h1>'
|
|
'<p class="lede">Agents and bots can create a free account, get an API key, and test '
|
|
'<strong>Enso</strong>, <strong>Kai</strong>, <strong>Zen</strong> models and the API Platform via '
|
|
'<a href="/hanzo">hanzo.md</a> (<code>curl hanzoskills.com/hanzo.md</code>) — or run the open-source '
|
|
'stack locally with <a href="/skill">skill.md</a>.</p>'
|
|
)
|
|
out = re.sub(r'<h1>.*?(?=<div class="btns">)', lambda _: hero_h1_lede + get(), out,
|
|
count=1, flags=re.S)
|
|
out = re.sub(r'<div class="btns">.*?(?=</div></div><div class="strip">)',
|
|
lambda _: btns(), out, count=1, flags=re.S)
|
|
out = re.sub(r'<div class="strip">.*?(?=\n<div class="wrap">)',
|
|
lambda _: strip(), out, count=1, flags=re.S)
|
|
out = re.sub(r'\s*<script id="copyjs">.*?</script>', "", out, flags=re.S)
|
|
out = re.sub(r"\s*</body>", COPY_JS + "</body>", out, count=1)
|
|
|
|
if out != src:
|
|
write(path, out)
|
|
return True
|
|
return False
|
|
|
|
|
|
def write(path, text):
|
|
"""Replace a file's contents, never truncate them in place.
|
|
|
|
`open(path, "w")` empties the file and then fills it, so anything reading it
|
|
in that window gets zero bytes — and this generator rewrites each page after
|
|
writing it, with the publish reading the same directory. hanzoskills.com went
|
|
out with a 0-byte index.html that way: every other object uploaded intact,
|
|
and the one file this pass rewrites twice did not.
|
|
"""
|
|
tmp = path + ".tmp"
|
|
with open(tmp, "w", encoding="utf-8") as f:
|
|
f.write(text)
|
|
f.flush()
|
|
os.fsync(f.fileno())
|
|
os.replace(tmp, path)
|
|
|
|
|
|
def sitemap(files):
|
|
urls = []
|
|
for f in files:
|
|
n = os.path.basename(f)[:-5]
|
|
urls.append("https://hanzoskills.com/" + ("" if n == "index" else n))
|
|
return ('<?xml version="1.0" encoding="UTF-8"?>\n'
|
|
'<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">\n'
|
|
+ "".join("<url><loc>%s</loc></url>\n" % html.escape(u) for u in sorted(urls))
|
|
+ "</urlset>\n")
|
|
|
|
|
|
# Agent Skills Discovery v0.2.0 (github.com/cloudflare/agent-skills-discovery-rfc).
|
|
# The index lists the skills this site serves whole: a skills/**/SKILL.md whose
|
|
# front matter names it <name> (the Agent Skills name rule, a description of at most
|
|
# 1,024 characters), served byte for byte as /<name>.md, and every file it points at
|
|
# by a relative path published beside it. A skill whose references/, scripts/ or
|
|
# templates/ are not published is left out until they are: type skill-md delivers
|
|
# SKILL.md alone. Each entry carries the SHA-256 of the bytes served, and the index
|
|
# is derived here, beside the sitemap, so CI fails when it disagrees with public/.
|
|
SKILLS_SCHEMA = "https://schemas.agentskills.io/discovery/0.2.0/schema.json"
|
|
SKILL_NAME = re.compile(r"^[a-z0-9]+(?:-[a-z0-9]+)*$")
|
|
BLOCK = re.compile(r"^[|>][+-]?$")
|
|
SOURCE = os.path.join(os.path.dirname(ROOT), "skills")
|
|
# A markdown link's target, and a bare path into a skill's own directories.
|
|
LINK = re.compile(r"\]\(([^)\s]+)")
|
|
PATH = re.compile(r"(?<![\w/.:@~-])((?:\.{1,2}/)*(?:references?|scripts|templates|assets|examples|resources|tools|skills)/[\w.@+-]+(?:/[\w.@+-]+)*)")
|
|
|
|
|
|
def front(text):
|
|
"""The top-level scalar fields of a file's YAML front matter, as strings.
|
|
|
|
Plain, single- and double-quoted scalars and `|`/`>` block scalars: the forms
|
|
the skills here use. A key whose value is a list or mapping maps to "". A plain
|
|
scalar YAML refuses (": " inside it, a trailing ":", a leading indicator) raises
|
|
ValueError, as a YAML loader would refuse the file."""
|
|
if not text.startswith("---\n"):
|
|
return {}
|
|
end = text.find("\n---\n", 3)
|
|
if end < 0:
|
|
return {}
|
|
lines = text[4:end].split("\n")
|
|
out, i = {}, 0
|
|
while i < len(lines):
|
|
m = re.match(r"^([A-Za-z0-9_-]+):(?:\s+(.*))?$", lines[i])
|
|
i += 1
|
|
if not m:
|
|
continue
|
|
key, val = m.group(1), (m.group(2) or "").strip()
|
|
body = []
|
|
while i < len(lines) and (lines[i][:1] in (" ", "\t") or lines[i] == ""):
|
|
body.append(lines[i])
|
|
i += 1
|
|
while body and body[-1] == "":
|
|
body.pop()
|
|
if BLOCK.match(val):
|
|
ind = min((len(b) - len(b.lstrip()) for b in body if b.strip()), default=0)
|
|
rows = [b[ind:] for b in body]
|
|
if val[0] == "|":
|
|
val = "\n".join(rows)
|
|
else:
|
|
val = re.sub(r"(?<!\n)\n(?!\n)", " ", "\n".join(rows)).replace("\n\n", "\n")
|
|
elif val[:1] == '"' and val.endswith('"') and len(val) > 1:
|
|
val = json.loads(val)
|
|
elif val[:1] == "'" and val.endswith("'") and len(val) > 1:
|
|
val = val[1:-1].replace("''", "'")
|
|
else:
|
|
if ": " in val or val.endswith(":") or val[:1] in tuple("*&!%@`"):
|
|
raise ValueError("front matter %s: not a plain YAML scalar" % key)
|
|
if body and val:
|
|
val = " ".join([val] + [b.strip() for b in body])
|
|
out[key] = val
|
|
return out
|
|
|
|
|
|
def refs(text):
|
|
"""The relative paths a skill points at, resolved from its own URL, /<name>.md."""
|
|
out = set()
|
|
# A link names a file when it has a directory or an extension; `(URL)` in prose
|
|
# is a placeholder, not a file.
|
|
targets = [m.group(1) for m in LINK.finditer(text) if re.search(r"/|\.\w{1,8}$", m.group(1))]
|
|
targets += [m.group(1) for m in PATH.finditer(text)]
|
|
for target in targets:
|
|
target = target.split("#", 1)[0].split("?", 1)[0]
|
|
if not target or target.startswith("/") or re.match(r"^[a-zA-Z][a-zA-Z0-9+.-]*:", target):
|
|
continue
|
|
out.add(posixpath.normpath("/" + target).lstrip("/"))
|
|
return out
|
|
|
|
|
|
def skills_index(root, source=SOURCE):
|
|
sources = {}
|
|
for path in sorted(glob.glob(os.path.join(source, "**", "SKILL.md"), recursive=True)):
|
|
raw = open(path, "rb").read()
|
|
try:
|
|
name = front(raw.decode("utf-8")).get("name")
|
|
except ValueError:
|
|
continue
|
|
sources.setdefault(name, set()).add(raw)
|
|
skills = []
|
|
for name in sorted(n for n in sources if isinstance(n, str)):
|
|
served = os.path.join(root, name + ".md")
|
|
if not SKILL_NAME.match(name) or len(name) > 64 or not os.path.isfile(served):
|
|
continue
|
|
raw = open(served, "rb").read()
|
|
if raw not in sources[name]:
|
|
continue
|
|
text = raw.decode("utf-8")
|
|
desc = " ".join(front(text).get("description", "").split())
|
|
if not desc or len(desc) > 1024:
|
|
continue
|
|
if any(not os.path.isfile(os.path.join(root, r)) for r in refs(text)):
|
|
continue
|
|
skills.append({
|
|
"name": name,
|
|
"type": "skill-md",
|
|
"description": desc,
|
|
"url": "/%s.md" % name,
|
|
"digest": "sha256:" + hashlib.sha256(raw).hexdigest(),
|
|
})
|
|
return json.dumps({"$schema": SKILLS_SCHEMA, "skills": skills}, ensure_ascii=False, indent=1) + "\n"
|
|
|
|
|
|
def main():
|
|
write(os.path.join(ROOT, "favicon.svg"), FAVICON)
|
|
files = sorted(glob.glob(os.path.join(ROOT, "*.html")))
|
|
write(os.path.join(ROOT, "sitemap.xml"), sitemap(files))
|
|
changed = sum(patch(f) for f in files)
|
|
md = os.path.join(ROOT, "index.md")
|
|
src = open(md, encoding="utf-8").read()
|
|
out = re.sub(r"(?:## Install\n.*?)?(?= curl hanzoskills\.com/llms\.txt)",
|
|
lambda _: get_md(), src, count=1, flags=re.S)
|
|
if out != src:
|
|
write(md, out)
|
|
index = os.path.join(ROOT, ".well-known", "agent-skills", "index.json")
|
|
os.makedirs(os.path.dirname(index), exist_ok=True)
|
|
write(index, skills_index(ROOT))
|
|
print("%d/%d pages rewritten" % (changed, len(files)))
|
|
|
|
|
|
if __name__ == "__main__":
|
|
main()
|