')
def main():
D = site_pages()
title = {p["id"]: p["title"] for p in D["pages"]}
out = []
out.append('
'
+ "".join(row(n, GH + n, d, "top") for n, d in TOP_FILES)
+ "
")
# agents
ag = sorted(f for f in os.listdir(os.path.join(ROOT, "agents"))
if f.endswith(".md") and f != "README.md")
out.append('
' + branch(
"agents/", GHT + "agents", f"{len(ag)} subagents, 4 of them read-only",
[row(a, GH + "agents/" + a, fm_desc(os.path.join(ROOT, "agents", a)))
for a in ag]) + "
")
# skills
sk = sorted(d for d in os.listdir(os.path.join(ROOT, "skills"))
if os.path.isdir(os.path.join(ROOT, "skills", d)))
out.append('
' + branch(
"skills/", GHT + "skills", f"{len(sk)} skills, one per workflow",
[row(d + "/", GH + f"skills/{d}/SKILL.md",
fm_desc(os.path.join(ROOT, "skills", d, "SKILL.md")))
for d in sk]) + "
")
# plugins: each plugin's skills and agents, flattened under one branch
plug_rows, n_plug_tools = [], 0
plug_root = os.path.join(ROOT, "plugins")
for pl in sorted(os.listdir(plug_root)):
pdir = os.path.join(plug_root, pl)
if not os.path.isdir(pdir):
continue
for d in sorted(os.listdir(os.path.join(pdir, "skills"))
if os.path.isdir(os.path.join(pdir, "skills")) else []):
plug_rows.append(row(
f"/{pl}:{d}", GH + f"plugins/{pl}/skills/{d}/SKILL.md",
fm_desc(os.path.join(pdir, "skills", d, "SKILL.md"))))
n_plug_tools += 1
adir = os.path.join(pdir, "agents")
for f in sorted(os.listdir(adir)) if os.path.isdir(adir) else []:
if f.endswith(".md"):
plug_rows.append(row(
f"{pl}:{f[:-3]}", GH + f"plugins/{pl}/agents/{f}",
fm_desc(os.path.join(adir, f))))
n_plug_tools += 1
out.append('
' + branch(
"plugins/", GHT + "plugins",
"the course's tools as a Claude Code plugin, installable in "
"two commands", plug_rows) + "
")
# commands, grouped
cmd_desc = {}
for f in os.listdir(os.path.join(ROOT, "commands")):
if f.endswith(".md") and f != "README.md":
cmd_desc[f[:-3]] = fm_desc(os.path.join(ROOT, "commands", f))
grouped = set(c for g in COMMAND_GROUPS.values() for c in g)
stray = sorted(set(cmd_desc) - grouped)
groups_html = []
for g, names in COMMAND_GROUPS.items():
names = [n for n in names if n in cmd_desc]
groups_html.append(branch(
g + "/", GHT + "commands", f"{len(names)}",
[row("/" + n, GH + f"commands/{n}.md", cmd_desc[n]) for n in names],
open_=False))
if stray:
groups_html.append(branch(
"other/", GHT + "commands", f"{len(stray)}",
[row("/" + n, GH + f"commands/{n}.md", cmd_desc[n]) for n in stray],
open_=False))
out.append('
'
f'commands/'
f'# {len(cmd_desc)} slash commands, thin by design'
'
'
+ "".join(groups_html) + "
")
# scripts
py = sorted(f for f in os.listdir(os.path.join(ROOT, "scripts"))
if f.endswith(".py"))
out.append('
' + branch(
"scripts/", GHT + "scripts", "Dependency-free Python",
[row(f, GH + "scripts/" + f, docstring(os.path.join(ROOT, "scripts", f)))
for f in py]) + "
")
# vault template
out.append('
' + branch(
"vault-template/", GHT + "vault-template",
"Clone this folder, open it in Obsidian, run /init",
[row(n, GHT + "vault-template/" + n.rstrip("/") if n.endswith("/")
else GH + "vault-template/" + n, d) for n, d in VAULT]) + "
")
# the SBH-Brain project, listed after the course and the handbooks
guide_secs = []
n_guide = 0
for sec, ids in D["order"].items():
if sec.startswith("track-") or sec.startswith("course-"):
continue
meta = D["sections"][sec]
n_guide += len(ids)
guide_secs.append(branch(
sec + "/", "index.html#" + ids[0],
f"{meta['title']} · {len(ids)} pages",
[row(i.split("/")[1] + ".md", "index.html#" + i, title[i])
for i in ids], open_=False))
guide_block = ('
")
# the course
course_secs, n_course = [], 0
for sec, ids in D["order"].items():
if not sec.startswith("course-"):
continue
meta = D["sections"][sec]
n_course += len(ids)
course_secs.append(branch(
sec + "/", "index.html#" + ids[0],
f"{meta['title']} · {len(ids)} pages",
[row(i.split("/")[1] + ".md", "index.html#" + i, title[i])
for i in ids], open_=False))
out.append('
")
# the tracks
track_secs, n_track = [], 0
for sec, ids in D["order"].items():
if not sec.startswith("track-"):
continue
meta = D["sections"][sec]
n_track += len(ids)
track_secs.append(branch(
sec + "/", "index.html#" + ids[0],
f"{meta['title']} · {len(ids)} pages",
[row(i.split("/")[1] + ".md", "index.html#" + i, title[i])
for i in ids], open_=False))
out.append('
'
f'docs/track-*/# '
f'Five handbooks, {n_track} pages, each ends in a build'
'
'
+ "".join(track_secs) + "
")
out.append(guide_block)
# resources
res = sorted(f for f in os.listdir(os.path.join(ROOT, "resources"))
if f.endswith(".md") and f != "README.md")
nlinks = sum(io.open(os.path.join(ROOT, "resources", f), encoding="utf-8")
.read().count("](http") for f in res)
out.append('
' + branch(
"resources/", "resources.html",
f"{nlinks} vetted links, checked September to November 2026",
[row(f, "resources.html", RESOURCES_DESC.get(f, "")) for f in res])
+ "