Skip to content
FlintFlintby Torch
← LevelsBuilder · B6

Scripts as musicians

Build-along · ~12 min at your own keyboard

Serious skills carry a scripts/ folder: deterministic code for the mechanical parts, with the SKILL.md as conductor deciding when each runs. One course's scrape-leads skill pulled 1,000 dentists in 87 seconds because Python did the fetching and the model only did the judging.

The long version: Skills with scripts ↗

Mac: Mac: use python3 to run scripts.

Windows: Windows: use python in PowerShell (or py). Paths use backslashes; in SKILL.md prefer forward slashes.

Do this

0/4

Checkpoints

  • ▸You should now see a script file in the skill's scripts/ folder.
  • ▸You should now see SKILL.md call the script by path.
  • ▸You should now see the skill run end to end with the script doing the mechanical step.
The three ways this goes wrong
  • The script works alone but fails inside the skill. — Check the path in SKILL.md is relative to the skill folder, then run the command by hand.
  • Python or Node is not installed. — Install it, open a new terminal, and confirm with python --version or node --version.
  • Claude still does the step by reasoning. — Say in SKILL.md: 'always run this script; do not do this step yourself.'

Share what happened

Paste the script's one-line job description, the SKILL.md line that calls it, and the speed difference you noticed.

Strip API keys, passwords, and tokens before you paste. Swap them for [KEY].

🔒 Don't paste confidential, personal-health, or payment info.