Skip to content

docs(user-guide): add skill bundles and workspace scripts guide - #494

Open
plumjohan wants to merge 1 commit into
codemie-ai:mainfrom
plumjohan:docs/EPMCDME-15558-skill-bundles-workspace
Open

plumjohan wants to merge 1 commit into
codemie-ai:mainfrom
plumjohan:docs/EPMCDME-15558-skill-bundles-workspace

Conversation

@plumjohan

@plumjohan plumjohan commented Oct 16, 2026 •

Copy link
Copy Markdown
Contributor

Title: docs(user-guide): add skill bundles and workspace scripts guide

Summary

Documents EPMCDME-15558: scripts and supporting files shipped in a skill bundle are now available in the agent workspace, so assistants can run them with the Execute workspace script tool.

Changes

New page

  • docs/user-guide/skills/skill-bundles.md (Skill Bundles and Workspace Scripts):
    • requirements for files to appear in the workspace;
    • the skills/<skill-folder>/ layout;
    • running a bundled script, with an example;
    • editing files in the workspace;
    • snapshot behaviour and its limitations;
    • the three limits and their dynamic config keys;
    • the upload warning and the notices to the assistant;
    • name conflicts, older skills, workflows and reserved paths;
    • export, clone and marketplace.
  • Four screenshots: bundle upload warning, Agent workspace dialog, chat running a script, and the assistant tool setting.

Updated pages

  • create-skill.md: the "Skill Format" box no longer says scripts and attachments are unsupported, and it links to the new page.
  • index.md, skills-in-chat.md, skills-in-workflow.md: links to the new page.
  • sidebars.ts: new page added to the Skills category.

FAQ

  • how-do-i-run-scripts-shipped-with-a-skill.md
  • what-are-the-limits-for-skill-files-in-the-workspace.md

Notes for reviewers

  • Not an Enterprise feature, so no Enterprise marking.
  • The limits (100 files, 10 MB per file, 50 MB total) are dynamic config keys, not environment variables.
  • The feature needs the workspace script bridge switched on (features:workspaceScriptBridge) and the Code Executor in sandbox-jobs mode.
  • create-skill.md still describes only .md import. A follow-up could document the Import File or Bundle flow there.

Validation

  • npm run check
  • npm run build (no broken links)

Document EPMCDME-15558: skill companion files available in the agent
workspace, limits, upload warning, and running bundled scripts. Update
Skills pages, sidebar, and add FAQ entries.

Generated with AI

Co-Authored-By: codemie-ai <codemie.ai@gmail.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant