SKILL.md
SKILL.md is the body of a skill: its name and when to use it first, then the steps and rules.
An analogy
Like a medicine leaflet. The AI reads the "what it's for" line at the top to decide. If it's a match, it reads on.
In pstack
The opening lines are called frontmatter. For example, /pstack:poteto-mode has disable-model-invocation: true. That means the AI never turns it on by itself: you have to type /pstack:poteto-mode yourself.
To change how pstack works, you edit these files. The author suggests using the "write a skill" playbook, then the Eval playbook to test whether the change helped. Don't patch skills in the middle of a task.
Common misconceptions
- "I can just dash off a SKILL.md": text for an AI has a higher bar. One useless sentence becomes something every future AI will do. The "write a skill" playbook checks the format and links for you.
Try it: Full guide step 8: Once you're comfortable
Related: Agent Skill, Playbooks