1.4Bundled Resources (Optional Directories)

Skills can include additional directories alongside SKILL.md:

/scripts/ — Executable Code

my-skill/
├── SKILL.md
└── scripts/
    ├── setup.sh          # Run once on install
    ├── validate.py       # Called by agent via Bash
    └── generate-report.sh

The agent invokes scripts via Bash: bash {baseDir}/scripts/validate.py

/references/ — Documentation the Agent Can Read

my-skill/
├── SKILL.md
└── references/
    ├── api-schema.json       # Loaded into context on demand
    ├── selector-patterns.md  # CSS selector cheat sheet
    └── error-codes.md        # Troubleshooting reference

The agent loads references via Read tool: Read {baseDir}/references/error-codes.md

This is progressive disclosure — SKILL.md is always loaded, but references are loaded only when needed.

/assets/ — Templates and Static Files

my-skill/
├── SKILL.md
└── assets/
    ├── report-template.html  # Referenced by path, not loaded into context
    └── logo.png