docs(skills): Native Manifest + Bundled Resources concept pages (#96, #97) - #106
Merged
Conversation
…#96, #97) Group 1 of the skill-server 0.4.0 epic (#95) — the two foundational concept pages the rest depend on. Written from the skill-server 0.4.0 source (Endpoints.cs, docs/specs/native-manifest.md, docs/specs/skills.md) and the netclaw 0.25.0 consumption side. - skills/native-manifest.md: the versioned HATEOAS /manifest.json sidecar vs the Cloudflare RFC feed, the skills/subagents collection trees, API version negotiation, and what netclaw pulls from it (subagents + archives), fail-soft / prune-after-confirm. Documents the real /api/v1/ content routes (the spec shorthand drops the prefix). - skills/bundled-resources.md: skill-md vs archive artifact shapes, deterministic archives with preserved exec bits, the automatic backfill, and how netclaw downloads/verifies/extracts (zip-slip hardening) into ~/.netclaw/skills/.server-feeds/, plus skill_read_resource and shell access. - Sidebar: both under Skills (the section rename to "Skills & Agents" lands with the custom-subagents move, #103). Forward-links to not-yet-written pages (skillserver-cli, subagent-distribution) point at existing pages for now; the later epic PRs repoint them. Closes #96, #97.
This was referenced Jul 22, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Group 1 of the skill-server 0.4.0 epic (#95) — the two foundational concept pages everything else depends on.
skills/native-manifest.md(docs(skills): Native Manifest & Sync Model page (new) #96) — the versioned/manifest.jsonHATEOAS sidecar vs the Cloudflare RFC feed, the skills/subagents collection trees, API version negotiation, and what netclaw pulls from it.skills/bundled-resources.md(docs(skills): Bundling Resources with Skills page (new) #97) —skill-mdvsarchiveshapes, deterministic archives with preserved exec bits, automatic backfill, and netclaw's download/verify/extract (zip-slip hardening) into~/.netclaw/skills/.server-feeds/.Written from the skill-server 0.4.0 source (
Endpoints.cs, the specs) and the netclaw 0.25.0 consumption side. Notably documents the real/api/v1/content routes — the scoping report and spec shorthand both dropped the prefix; I verified againstEndpoints.cs.Sidebar: both under Skills for now; the rename to Skills & Agents lands with the custom-subagents move (#103). Forward-links to the not-yet-written CLI and subagent-distribution pages point at existing pages; later epic PRs repoint them.
Closes #96, #97. Build compiles, all internal links resolve; pagefind's binary-fetch is the known environmental failure.