The Right Way to Write an Agent Skill
At some point in the last year, I noticed I had stopped writing bash scripts. It wasn't an explicit decision I made; it just happened organically as the small automations I used to script became skills instead. The deterministic parts still end up as commands, but now they sit inside a procedure that an agent executes.
A skill is a procedure an agent follows, so I write it as if I were writing code, but in English. The file a reviewer reads is exactly what the agent executes, with nothing compiled in between. I encoded this approach in the writing-skills skill that we published in the Agent Skills Marketplace.
This post covers what good skills look like: the 5 principles I follow, an optional one that has felt magical, good and bad examples for each, and the real skills we open-sourced along the way.
The 5 Principles, Plus an Optional...
Copyright of this story solely belongs to hackernoon.com. To see the full text click HERE
