Skill Scripts

Skills can execute external code/programs in two ways: one-off commands, and self-contained scripts (in scripts/ within the skill folder).

To use a self-contained script, let the SKILL.md know of available scripts and reference their relative paths:

## Available scripts
- **`scripts/validate.sh`** — Validates configuration files
- **`scripts/process.py`** — Processes input data

## Workflow
1. Run the validation script:
   ```bash
   bash scripts/validate.sh "$INPUT_FILE"

Process the results:

python3 scripts/process.py --input results.json


For one-off commands you just specify the command in the SKILL.md to use, e.g.:

go run golang.org/x/tools/cmd/goimports@v0.28.0 .


Agents operate in non-interactive shells — they cannot respond to TTY prompts, password dialogs, or confirmation menus. A script that blocks on interactive input will hang indefinitely.

Related: Agent Skills, Skill Anatomy