Conversation
- add bundled `skill/create` and `skill/optimize` command definitions across core, schema, and adapter configs - add the shared skill authoring component and generated OpenCode templates for the new workflows - document the new skill workflows in the README and web docs, including command showcase examples
- simplify skill command docs and generated output around generic validation steps - reorganize the command showcase into workflow and guidelines groups - tighten skill optimize wording to focus on targeted improvements
There was a problem hiding this comment.
★★★★☆
The command templates, shared component, config surfaces, schema, test coverage, and generated output are all consistent and correct. One sync gap to address:
packages/web/src/content/docs/docs/reference/commands/index.mdx still groups /skill/create, /skill/optimize, and /learn under Core, but CommandShowcase.astro now separates them into a Guidelines group while the remaining former-Core commands live under Workflow. Per the AGENTS.md requirement to keep user-facing docs and showcase surfaces in sync when commands are added or renamed, the docs reference page should reflect the same grouping taxonomy as the showcase.
There was a problem hiding this comment.
★★★★☆
The command templates, shared component, config surfaces, schema, test coverage, generated output, and showcase are all consistent and correct. One remaining sync gap from the prior review:
The Groups list in the docs reference page now correctly separates Workflow and Guidelines, matching the showcase taxonomy, but the detailed section heading ## Workflow Commands still groups /learn, /skill/create, and /skill/optimize under a single "Workflow Commands" heading instead of splitting into separate ## Workflow Commands and ## Guidelines sections to match. This is a continuation of the same surface-sync issue the prior review flagged — the summary list was fixed but the section structure beneath it wasn't updated to match.
Ticket
SKIPPED
Description
Adds dedicated skill authoring commands so users can create and refine Agent Skills through the bundled command surface, with matching configuration and documentation across the workspace.
Checklist
Skill authoring commands
/skill/createand/skill/optimizeas bundled commands for focused skill creation and optimization workflowsBundled configuration
Docs and product surfaces
Validation