Update HiveMind one-pager for 1.0.8 (labels and tags, Skills table)

[claude]

Requested by Matt Linville · Slack thread

Description

Before: The HiveMind one-pager described the dashboard as of a release before 1.0.8. Session labels and tags — the flagship of 1.0.8 — were absent from the page entirely, so a reader had no idea sessions could be labeled, tagged, or filtered. The skills bullet promised only that you can "see which skills and slash commands your team invokes and how widely they're used," which undersells the redesigned Skills page.

After: The dashboard capability list gains an Organize and filter sessions bullet covering key-value labels and tags, the automatically derived hivemind.* labels, the three ways to tag a session (hivemind tag, the Labels card in the session insights sidebar, and the hivemind-tag skill), and a link out to the labels deep dive on the HiveMind docs site. The skills bullet now describes the sortable, paginated table with category badges and multi-select filters, plus previewing, copying, and downloading a skill definition. The See sessions across agents bullet picks up one sentence noting that a session started as a subprocess is linked to its parent, so fan-out reads as a tree.

How: The page is a present-tense one-pager, not a changelog, so there is no "What's new in 1.0.8" section — every change lands in the existing bullet list, at that list's altitude, in its existing voice. Detail that belongs to the HiveMind docs site (the two-step label picker, the ?tag= URL parameter, which labels are editable) is left there and linked rather than restated. Improved Codex session coverage in 1.0.8 is real but has no natural home at this altitude, so it is deliberately not mentioned. Three lines changed; no new files, no nav change, no screenshots added.

Testing

• Local link check succeeds without errors (mint broken-links — success no broken links found). Note that this sandbox has no general web egress, so this run validated internal links and image paths only; the external hivemind.wandb.tools links were not fetched.
• Local build (mint dev) — not run here.
• PR tests succeed.

What a human needs to adjust

• Recapture images/hivemind/hivemind-skills.png. It predates the 1.0.8 Skills redesign and no longer matches the bullet next to it. The new capture should show the sortable, paginated skills table with its category badges and the multi-select category filter visible, ideally with the definition preview (copy / download) reachable in frame. Done: replaced in ddffffb, then recompressed by the image bot in 2424d60.
• Decide whether to add a labels screenshot. The page's screenshot strip has no image for labels or tags. Two candidates: the Sessions page with the two-step label picker (key, then value) open next to the tag filter, and the Labels card in the session insights sidebar with an editable user-set tag. If either is added, it belongs in the existing <Frame> strip — my suggestion is directly after hivemind-recent-sessions.png for the Sessions picker and directly after hivemind-session-insights.png for the sidebar card. I could not produce screenshots in this environment. Decided: no new <Frame> was added. hivemind-recent-sessions.png was refreshed in ddffffb (1298x639 to 961x434) and hivemind-session-insights.png is untouched, so the sidebar-card candidate was not taken. Whether the refreshed Sessions capture shows the label picker cannot be verified from this sandbox, which cannot view image content.
• Verify the deep-dive link. https://hivemind.wandb.tools/docs/labels could not be verified live from this sandbox (no web egress beyond github.com and the npm registry). Please confirm the URL resolves and that the link text "Labels and tags" matches the page's actual title.
• Localized copies are intentionally untouched. fr/hivemind.mdx, ja/hivemind.mdx, and ko/hivemind.mdx still carry the old English-derived text and were left for the translation pipeline, per AGENTS.md.
• Wording I was unsure about:
  • "Six hivemind.* labels are derived from every session automatically" — the count is stated as a fact; confirm six is right and stays right, or soften to "a set of hivemind.* labels" if it is likely to change.
  • "session insights sidebar" — used because that is what the existing screenshot file is named. Confirm it matches the UI's own wording for that panel.
  • "Sessions page" is capitalized as a UI page name, matching how the docset treats UI labels. Confirm HiveMind names it that way.
  • The Organize and filter sessions bullet runs six sentences — longer than any other in the list. If it reads heavy, the three tagging sentences could be trimmed to just the link.

Style sources used

The real style-guide skill from coreweave/docs-skills was obtained for this PR, and passes 2 through 8 were applied as a check on the lines this PR changes, not as a whole-page restyle. Checkpoint 1 (passes 1 and 2) is built for whole-document work, so from it only the list-level rules that apply to a bullet inside an existing list were used. Everything else on the page is untouched.

Three fixes resulted:

• key/value becomes key-value (pass 6, slashes and compound modifiers). The rest of the docset writes "key-value" throughout, which is also rule 1 of the hierarchy, match nearby content.
• A 34-word sentence becomes three sentences, each stating the goal before the instruction (pass 3, sentences under 26 words and one idea per sentence; passes 2 and 8, state the goal before the instruction). This also matches the neighboring Track spend and usage bullet, which already reads "To report your own token usage and cost from the command line, run hivemind usage."
• UI elements are bolded: **Sessions** and **Labels**. This is the owner's call from review 5116720273, applied in 13b9107; it supersedes the earlier decision to leave them plain to match the neighboring bullets, since pass 6 (bold for UI elements) outranks rule 1 here.

Checked and deliberately left as written:

• Passive voice in "Six hivemind.* labels are derived from every session automatically" and "A session that an agent starts as a subprocess is linked to its parent." Naming an actor would assert which component derives or links, a technical claim this PR shouldn't invent. The guide allows passive to de-emphasize an actor the reader doesn't act on.
• "fan-out" is a term of art here and appears on none of the pass 4 jargon lists.
• "session insights sidebar" is not directional language, and the AGENTS.md "project sidebar" rule covers W&B's own in-project navigation, not a third-party product's panel.

No em dashes, en dashes, semicolons, ellipses, or Latin abbreviations appear in the changed lines. mint broken-links still reports success no broken links found after the edits.

🤖 Generated with Claude Code

https://claude.ai/code/session_016gdhpykrjmEUqbLmx8mKbQ

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
wandb	🟢 Ready	View Preview	Sep 4, 2026, 4:01 PM

---

Page	Change
Hivemind	Changed · +3 −2

No preview available (2)

File	Change
images/hivemind/hivemind-recent-sessions.png	Changed · +0 −0
images/hivemind/hivemind-skills.png	Changed · +0 −0

_{Updated 2026-09-04 18:49:37 UTC for deployment · 2424d60.}

[github-actions]

Readability impact

Word-weighted Flesch-Kincaid grade change across 1 changed page: +0.0 (unchanged).

Lower Flesch-Kincaid grade and higher reading ease both mean easier to read. This check is informational and never blocks a PR.

Human readability

Page	FK grade before	FK grade after	FK Δ	Reading ease Δ	Direction
hivemind.mdx	9.8	9.8	+0.0	-0.1	unchanged

AI agent comprehension

Rated 0-3 (higher is easier for an agent to parse and act on).

Page	Before	After	Δ
hivemind.mdx	2	2	+0

_{Curated-docs baseline median FK grade by type: conceptual 10.5, procedural 8.8, reference 9.4.}

From workflow run 33907830368

[github-actions]

🔗 Link Checker Results

✅ All links are valid!

No broken links were detected.

Preview: https://wb-21fd5541-hivemind-1-0-8-one-pager.mintlify.site

[wandb-docs-pr-writer]

Images automagically compressed by Calibre's image-actions ✨

Compression reduced images by 72.5%, saving 139.3 KB.

Filename	Before	After	Improvement	Visual comparison
images/hivemind/hivemind-skills.png	110.6 KB	27.3 KB	75.3%	View diff
images/hivemind/hivemind-recent-sessions.png	81.4 KB	25.5 KB	68.7%	View diff