[Feature] Document full skillset lifecycle in ornn-agent-manual-cli (and chrono-ai-service-manual)

[chronoai-shining]

Summary

Core skillsets (#969 + follow-on web + search + member viewer + detail work) are shipped and merged to develop. The authoritative agent-facing manuals (skills/ornn-agent-manual-cli/SKILL.md and the unified chrono-ai-service-manual) have no coverage of skillsets yet.

Agents using the NyxID proxy / direct HTTP still only see the skill lifecycle. We must add parallel sections for:

• Skillset search (/skillset-search)
• Create skillset + publish new version (with required instructions master prompt)
• Get detail + versions
• Permissions / visibility
• One-call closure (/skillsets/:idOrName/closure) including the top-level instructions
• Member validation rules, kinds (generic vs consensus-supported)
• How to use a resolved skillset (the instructions tell the agent the orchestration)

Why this matters

Ornn's primary customer is the AI agent. The manuals + the MCP skill_search surface are how agents discover the contract. Skillsets are the "curated bundle + master prompt" abstraction that directly serves agent composition / consensus use cases.

Scope for v1

• Add §-level sections in the CLI manual (mirroring the structure and style of the existing skill sections).
• Update the HTTP manual only if it is not fully deprecated (note says prefer the unified one).
• Bump the manual's version: in frontmatter.
• Possibly add a small example skillset or note in the manual.
• Follow-up PR for any MCP tool additions if the ornn MCP server is in this repo.

Acceptance

• An agent reading the updated manual can fully searchSkillsets, createSkillset, publishSkillset, getSkillsetClosure, set permissions, and understand the instructions field.
• No drift from CONVENTIONS.md §2.6 and the live routes.
• Changeset included.
• Links back to this issue.

Related

• [Feature] Skillsets — typed, versioned skill bundles (revive #916 with kinds) #969 (closed, the platform feature)
• Recent: [Feature] Skillset browse search + detail member-package viewer + master-prompt relocation #1080, [Feature] Restructure skillset detail: master-prompt top card, graph above a slimmer viewer, vertical skills selector #1082, Restructure skillset detail: master-prompt top card, graph above a slimmer viewer, vertical skills selector #1083 (search + detail UI)
• Open related: [Bug] Skillset member validation runs as SYSTEM_ACTOR — curators can embed and leak private skills they can't read #1019 (security: member validation actor), [Misc] Shrink master-prompt font on the skillset detail card #1084 (font polish), [Bug] SDK types, update payload, and search filters have drifted from the real API contract (TS + Python) #1013 (SDK drift)