docs(plugin): teach the decocms-studio skill to boot and drive sandboxes

Merged
PE
9h ago
+24-2

What is this contribution about?

The decocms-studio skill had no mention of decocms sandbox (#8429, #8430), so coding agents with the skill installed didn't know they could boot a sandbox on one of the org's repositories, run commands in it, or message its agent. This adds a short section with the three commands and their contracts, and the skill's description now mentions sandboxes so it triggers on those requests.

  • new --repo <owner/name|id>, an empty sandbox without it, --agent exclusive with --repo.
  • exec: exit code passthrough, no stdin/TTY, single-argument script form, 30s default / 120s cap, 124 on timeout, first call waits for the boot.
  • chat: reply on stdout, tool names on stderr, ends with the turn.
  • Plugin version 1.0.3 → 1.1.0.

How did you verify your code works?

I checked each statement against apps/api/src/cli/commands/sandbox.ts and apps/api/src/tools/sandbox/thread-start.ts as merged on main: flags, the --repo/--agent conflict, timeout default/cap and exit 124, output streams, and the unknown-repo error that lists the linked repositories. The CLI with --repo is published as decocms@4.565.0. No code changed, so no tests were run.

How to Test

  1. npx skills add decocms/studio --skill decocms-studio -g from this branch (or after merge).
  2. Ask a coding agent to "boot a sandbox on / in and run the tests".
  3. It should run decocms sandbox new --org <slug> --repo <owner>/<repo>, then decocms sandbox exec <chat-id> --org <slug> -- ....

Review Checklist

  • PR title is clear and descriptive
  • Changes are tested and working
  • Documentation is updated (if needed)
  • No breaking changes

Summary by cubic

Teaches the decocms-studio skill about sandboxes so coding agents can boot a sandbox on an org repository, run commands in it, or message its agent—previously the skill had no mention of decocms sandbox despite the feature being available in the CLI.

  • Adds a sandbox section covering decocms sandbox new, exec, and chat, including flags, the --repo/--agent conflict, timeout behavior, and output streams.
  • Updates the skill description so it triggers on sandbox requests and bumps the plugin version to 1.1.0.