Epic: document skill-server 0.4.0 (native manifest, bundled resources, subagent distribution, gallery) + Skills & Agents IA

[Aaronontheweb]

Why

skill-server 0.4.0 (released 2026-07-14), consumed by netclaw 0.25.0 via the Netclaw.SkillClient library, added major capabilities the docs don't cover: native manifest sync (/manifest.json sidecar to the RFC feed), first-class subagents (published/versioned/synced through the registry — our docs still frame them as local-only), resource bundling as archives (deterministic zips with preserved exec bits, extracted into ~/.netclaw/skills/.server-feeds/), and an interactive gallery web UI (zero coverage).

This epic closes that gap and restructures the docs so skills and agents live together.

Information architecture (approved)

Rename the Skills sidebar section to Skills & Agents and move custom-subagents into it — subagents and skills now ship through the same registry, so splitting them across Skills/Guides no longer makes sense.

Redirect (one file moves):

/guides/custom-subagents/  →  /skills/custom-subagents/   (301, appended to the existing public/_redirects — same pattern as the /guides/connecting-slack/ move)

Internal links to the old slug get updated in the same PR that moves the file (issue for "Defining Subagents").

Proposed section

Page	Slug	State	Group
Overview	skills/overview	update	3
Native Manifest & Sync	skills/native-manifest	new	1
Bundling Resources with Skills	skills/bundled-resources	new	1
Defining Subagents	skills/custom-subagents (moved)	move+update	3
Distributing Subagents	skills/subagent-distribution	new	3
Skill Feeds	skills/skill-feeds	update	3
External Skills	skills/external-skills	minor	4
Skill Server	skills/skill-server	update	2
skillserver CLI	skills/skillserver-cli	new	2
Skill Gallery	skills/gallery	new (⛔ screenshots)	2
netclaw skill (CLI ref)	cli/skill	minor	4

Groups reflect dependency order: 1 (foundational concepts) → 2 (server + CLI) → 3 (consumption/sync) → 4 (cleanup). Sub-issues are linked below.

Cross-cutting risks (apply to the CLI/API pages especially)

• Specs disagree with the running server on routes. The CLI-reference and Skill Server API tables MUST be built against the actual 0.4.0 server (Endpoints.cs / a running container), not spec prose. Per CLAUDE.md Step 9, execute every docker/curl example first.
• Gallery page is blocked on new browser screenshots (VHS pipeline can't capture a web UI).
• overview.md system-skills list has an unresolved TODO needing a maintainer answer.

Sub-issues

Group 1 — foundational concepts (start here)

• docs(skills): Native Manifest & Sync Model page (new) #96 — Native Manifest & Sync Model (new)
• docs(skills): Bundling Resources with Skills page (new) #97 — Bundling Resources with Skills (new)

Group 2 — server + CLI surfaces

• docs(skills): skillserver CLI reference page (new) #98 — skillserver CLI reference (new)
• docs(skills): update Skill Server page for 0.4.0 #99 — update Skill Server page for 0.4.0
• docs(skills): Skill Gallery (web UI) page (new) — BLOCKED on screenshots #100 — Skill Gallery web-UI page (new) ⛔ blocked on browser screenshots

Group 3 — consumption / sync

• docs(skills): Distributing Subagents via a skill server (new) #101 — Distributing Subagents via a skill server (new)
• docs(skills): update Skill Feeds page for archive + native-manifest + subagent sync #102 — update Skill Feeds for archive + native-manifest + subagent sync
• docs(skills): move + update Custom Subagents (Guides → Skills & Agents) [carries the IA move] #103 — move + update Custom Subagents (Guides → Skills & Agents) — carries the IA move + redirect
• docs(skills): update Skills Overview for feed-synced subagents + archive distribution #104 — update Skills Overview

Group 4 — cleanup

• docs(cli): update netclaw skill classifications for server feeds (cleanup) #105 — update netclaw skill classifications for server feeds