Skip to content
  1. Wiki
  2. Basics
  3. SKILL.md

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

An unofficial beginner's guide to pstack, not its official docs. pstack is made by poteto; the official repo is the source of truth for commands and behavior. The original guide source is on GitHub.

Hosted by airali. Adapted from Xiaoxiaodong's MIT-licensed guide.