Bundled Files

A skill can bundle supporting files — scripts, reference docs, templates — alongside its SKILL.md. Keeping these out of the main SKILL.md keeps the skill lean: an agent reads the instructions first and fetches a file only when the task actually needs it.

Files are addressed by relative path within the skill, for example scripts/run.sh or references/api.md.

Adding bundled files

• In the UI: add files in the skill editor under Teams → [Team] → Setup → Skills.
• Over MCP: pass files to wato_save_skill_draft:

wato_save_skill_draft({
  "content": "---\nname: deploy-runbook\ndescription: Use when deploying the service.\n---\n\n# Deploy\n\nRun the steps in `scripts/deploy.sh`. Full checklist in `references/checklist.md`.",
  "files": [
    { "path": "scripts/deploy.sh", "content": "#!/bin/bash\nset -euo pipefail\n..." },
    { "path": "references/checklist.md", "content": "# Pre-deploy checklist\n..." }
  ]
})

Referencing files from SKILL.md

Point to a file by its relative path and tell the agent to fetch it when needed, rather than pasting its contents into SKILL.md:

Run the deploy steps in `scripts/deploy.sh`.
The full checklist is in `references/checklist.md` — read it before step 3.

How agents load them

Bundled files are fetched on demand, not all up front:

1. wato_get_skill returns the SKILL.md and lists the skill's bundled files.
2. wato_get_skill_file fetches one file by its relative path.

wato_get_skill_file({ "id": "deploy-runbook", "path": "references/checklist.md" })

In the agent context package, bundled files appear under skills/<slug>/<path>.