Testing skills

Skills are scripts and markdown files. Test them the way you’d test any script.

Run the script directly

./run.sh "test input"

If it prints the right output, it works. If it doesn’t, fix it.

Read your SKILL.md as if you were the agent. Ask yourself:

The best test is using the skill with an actual agent:

skills add ./my-skill
# Then ask the agent a question that should trigger the skill

Watch whether the agent:

Problem	Fix
Agent doesn’t find the skill	Check the description — is it specific enough?
Agent calls it with wrong args	Add clearer examples to SKILL.md
Script errors silently	Make sure errors go to stderr with non-zero exit
Slow execution	Agent may timeout — add a note about expected duration

skills lint ./my-skill

Checks that: