Files
zeekay 747dafba10 Register WebMCP tools on every page, and name each page's twin from site.py
Every page now loads /webmcp.js, scripts/webmcp.ts with its types
stripped (npm run webmcp). Where the browser has document.modelContext
it registers two read-only tools: search_skills over the published
skills index, and get_skill, which returns a skill's markdown checked
against the index digest. The markdown alternate link moves from
build.py to site.py, so CI holds every page to it.

The API catalog gains the site itself (llms.txt and the skills index)
and hanzo.ai/agents; the live discovery check now fetches every
catalog link. tests/site.mjs drives the tools through a recording
modelContext, and checks a browser without one loads clean.
2026-10-26 20:57:05 -07:00

405 lines
20 KiB
HTML

<!doctype html>
<html lang="en"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>template</title>
<meta name="color-scheme" content="dark">
<style>
/* 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%}
}
</style>
<link rel="icon" href="/favicon.svg">
<link rel="canonical" href="https://hanzoskills.com/template">
<link rel="alternate" type="text/markdown" href="/template.md">
<script type="module" src="/webmcp.js"></script>
</head>
<!-- Reading this with a machine? Every page here is also plain markdown.
This one: https://hanzoskills.com/template.md
Index: https://hanzoskills.com/llms.txt
Corpus: https://hanzoskills.com/all.md
Append .md to any path for the markdown twin. -->
<body>
<nav><div class="in">
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
<a class="up" href="/">All skills</a>
</div></nav>
<div class="wrap">
<h1>template</h1><p class="lede">Brief description of what this alert means and why it exists.</p><h1>Alert: [AlertName]</h1>
<blockquote><p><strong>Status</strong>: [Draft | Active | Archived] <strong>Last Updated</strong>: YYYY-MM-DD <strong>Owner</strong>: [Team/Person] <strong>Severity</strong>: [Critical | Warning | Info]</p></blockquote>
<hr>
<h2>Overview</h2>
<p>Brief description of what this alert means and why it exists.</p>
<p><strong>What is being measured</strong>: Describe the metric or condition</p>
<p><strong>Why it matters</strong>: Explain the business or technical impact</p>
<hr>
<h2>Symptoms</h2>
<p>What the oncall engineer will observe:</p>
<ul><li>System behavior</li><li>User-facing symptoms</li><li>Related metrics</li></ul>
<hr>
<h2>Impact</h2>
<h3>User Impact</h3>
<ul><li>[ ] Service unavailable</li><li>[ ] Performance degraded</li><li>[ ] Feature disabled</li><li>[ ] No user impact</li></ul>
<h3>Business Impact</h3>
<ul><li>Revenue impact: [None | Low | Medium | High]</li><li>Customer impact: [Number of affected users]</li><li>SLA impact: [Yes/No]</li></ul>
<hr>
<h2>Severity</h2>
<p><strong>Current Severity</strong>: [Critical | Warning | Info]</p>
<h3>Escalation Criteria</h3>
<p>Escalate to <strong>Critical</strong> if:</p>
<ul><li>Condition persists &gt; [duration]</li><li>Metric exceeds [threshold]</li><li>User impact confirmed</li></ul>
<p>Escalate to <strong>Manager</strong> if:</p>
<ul><li>No progress after [duration]</li><li>Customer escalation received</li><li>Multiple related incidents</li></ul>
<hr>
<h2>Diagnosis</h2>
<h3>1. Verify the Alert</h3>
<p>Check if alert is accurate:</p>
<pre><code class="lang-bash"># Query Prometheus to verify metric
curl &#x27;http://prometheus:9090/api/v1/query?query=[METRIC_NAME]&#x27;
# Check Grafana dashboard
# URL: [Dashboard URL]</code></pre>
<p><strong>Expected</strong>: [What should you see?] <strong>Actual</strong>: [What are you seeing?]</p>
<h3>2. Check Related Systems</h3>
<pre><code class="lang-bash"># Check service health
kubectl get pods -n [namespace]
kubectl logs -f [pod-name] --tail=100
# Check dependencies
curl -I https://[dependency]/health</code></pre>
<h3>3. Review Recent Changes</h3>
<pre><code class="lang-bash"># Check recent deployments
kubectl rollout history deployment/[name]
# Check git commits
git log --since=&quot;1 hour ago&quot; --oneline
# Check recent alerts
# Alertmanager URL: [URL]</code></pre>
<h3>4. Identify Root Cause</h3>
<p>Common causes:</p>
<ol><li><strong>[Cause 1]</strong>: How to identify, how to confirm</li><li><strong>[Cause 2]</strong>: How to identify, how to confirm</li><li><strong>[Cause 3]</strong>: How to identify, how to confirm</li></ol>
<hr>
<h2>Remediation</h2>
<h3>Immediate Actions (&lt; 5 minutes)</h3>
<p><strong>Objective</strong>: Stop the bleeding, restore service</p>
<ol><li><strong>Action 1</strong>:</li></ol>
<p> ``<code>bash # Command with explanation kubectl scale deployment/[name] --replicas=[N] </code>`` <strong>Expected outcome</strong>: [What should happen] <strong>Verification</strong>: [How to verify it worked]</p>
<ol><li><strong>Action 2</strong>:</li></ol>
<p> ``<code>bash # Command </code>``</p>
<ol><li><strong>If above don&#x27;t work</strong>: Escalate to [team/person]</li></ol>
<h3>Short-term Fix (&lt; 1 hour)</h3>
<p><strong>Objective</strong>: Stable workaround while investigating root cause</p>
<ol><li><strong>Action 1</strong>:</li></ol>
<ul><li>Step-by-step instructions</li><li>Expected outcomes</li><li>Rollback procedure if needed</li></ul>
<ol><li><strong>Action 2</strong>:</li></ol>
<ul><li>Instructions</li></ul>
<h3>Long-term Fix</h3>
<p><strong>Objective</strong>: Permanent resolution</p>
<ol><li>Create ticket: [Ticket system link template]</li><li>Investigate root cause</li><li>Implement permanent fix</li><li>Update monitoring/alerts if needed</li></ol>
<hr>
<h2>Rollback</h2>
<p>If remediation makes things worse:</p>
<pre><code class="lang-bash"># Rollback deployment
kubectl rollout undo deployment/[name]
# Restore from backup
./restore_backup.sh [backup-id]
# Disable feature flag
curl -X POST https://[feature-flags]/disable/[flag]</code></pre>
<hr>
<h2>Communication</h2>
<h3>Who to Notify</h3>
<p>| Stakeholder | When | How | |-------------|------|-----| | Team Lead | Immediately | Slack #[channel] | | Manager | If not resolved in 30min | Phone/Slack | | Customers | If impact confirmed | Status page | | Exec Team | If revenue impact | Email + Slack |</p>
<h3>Communication Templates</h3>
<p><strong>Initial notification</strong> (within 5 minutes):</p>
<pre><code>[INCIDENT] [Service] - [Brief description]
Impact: [User-facing impact]
Started: [Time]
Status: Investigating
Next update: [Time]
Incident lead: [Name]
Slack channel: #incident-[ID]</code></pre>
<p><strong>Status update</strong> (every 30 minutes):</p>
<pre><code>[UPDATE] [Service] - [Brief description]
Actions taken:
- [Action 1]
- [Action 2]
Current status: [Status]
Next update: [Time]</code></pre>
<p><strong>Resolution</strong>:</p>
<pre><code>[RESOLVED] [Service] - [Brief description]
Resolution: [What fixed it]
Root cause: [Brief description]
Duration: [Total time]
Postmortem: [Link] (to be completed within 48h)</code></pre>
<hr>
<h2>Prevention</h2>
<h3>Monitoring Improvements</h3>
<ul><li>[ ] Add monitoring for [metric]</li><li>[ ] Adjust alert threshold to [value]</li><li>[ ] Create dashboard for [view]</li></ul>
<h3>Process Improvements</h3>
<ul><li>[ ] Add deployment check for [condition]</li><li>[ ] Update documentation</li><li>[ ] Add automated test</li></ul>
<h3>Code/Infrastructure Changes</h3>
<ul><li>[ ] Increase resource limits</li><li>[ ] Implement circuit breaker</li><li>[ ] Add caching layer</li></ul>
<hr>
<h2>Validation</h2>
<h3>Post-Remediation Checks</h3>
<p>Verify service is healthy:</p>
<pre><code class="lang-bash"># Check 1: Service responding
curl https://[service]/health
# Check 2: Metrics recovered
# [Dashboard URL]
# Check 3: Error rate normal
# [Query URL]
# Check 4: Latency acceptable
# [Dashboard URL]</code></pre>
<p>All checks passing? ✓ Incident resolved</p>
<hr>
<h2>Related Information</h2>
<h3>Dashboards</h3>
<ul><li>[Dashboard name]: [URL]</li><li>[Dashboard name]: [URL]</li></ul>
<h3>Related Alerts</h3>
<ul><li><code>[AlertName]</code>: [Brief description]</li><li><code>[AlertName]</code>: [Brief description]</li></ul>
<h3>Documentation</h3>
<ul><li>Architecture docs: [URL]</li><li>API docs: [URL]</li><li>Infrastructure docs: [URL]</li></ul>
<h3>Previous Incidents</h3>
<ul><li>[INC-123]: [Date] - [Brief description]</li><li>[INC-456]: [Date] - [Brief description]</li></ul>
<h3>Team Contacts</h3>
<ul><li>Oncall: Check PagerDuty schedule</li><li>Team Slack: #[channel]</li><li>Team email: [email]</li></ul>
<hr>
<h2>Appendix</h2>
<h3>Useful Commands</h3>
<pre><code class="lang-bash"># View logs
kubectl logs -f [pod] --namespace=[ns] --tail=100
# Check resource usage
kubectl top pods -n [namespace]
# Describe pod
kubectl describe pod [pod] -n [namespace]
# Execute command in pod
kubectl exec -it [pod] -n [namespace] -- bash
# Port forward for debugging
kubectl port-forward [pod] 8080:8080 -n [namespace]</code></pre>
<h3>Metrics Queries</h3>
<pre><code class="lang-promql"># Request rate
sum(rate(http_requests_total[5m])) by (service)
# Error rate
sum(rate(http_requests_total{status=~&quot;5..&quot;}[5m])) by (service)
/
sum(rate(http_requests_total[5m])) by (service)
# Latency p95
histogram_quantile(0.95,
sum(rate(http_request_duration_seconds_bucket[5m])) by (le, service)
)</code></pre>
<hr>
<h2>Change Log</h2>
<p>| Date | Author | Change | |------|--------|--------| | YYYY-MM-DD | [Name] | Initial version | | YYYY-MM-DD | [Name] | Updated remediation steps |</p>
<hr>
<h2>Feedback</h2>
<p>Found an issue with this runbook? Incident didn&#x27;t match the runbook?</p>
<ul><li>Create issue: [Link to issue tracker]</li><li>Slack: #[channel]</li><li>Update directly: [Link to this file in git]</li></ul>
<footer>
<div class="fmap">
<div><b>Build</b>
<a href="https://hanzo.app">hanzo.app</a> app builder
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
<div><b>Run</b>
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
<div><b>Account</b>
<a href="https://hanzo.id">hanzo.id</a> sign in
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
<div><b>Company</b>
<a href="https://hanzo.ai">hanzo.ai</a> canonical
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
</div>
<div class="fend"><a href="/template.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>