Skip to content

Commit 1c6d61b

Browse files
authored
Merge pull request #137 from EthicalML/fix/blog-principles-numbers
fix(blog): label the principles list items so the numbering survives the list styling
2 parents ec877dc + 23ecdf4 commit 1c6d61b

1 file changed

Lines changed: 6 additions & 6 deletions

File tree

  • src/content/blog/2026-08-29-how-to-write-an-agent-skill

src/content/blog/2026-08-29-how-to-write-an-agent-skill/index.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -16,12 +16,12 @@ This post covers what good skills look like: the 5 principles I follow, an optio
1616

1717
## The 5 Principles, Plus an Optional One
1818

19-
1. The description is a router, so it says when to use the skill in the words a user would type.
20-
2. The body is steps, and anything that isn't a step gets deleted.
21-
3. Scripts carry the fixed sequences, and the agent carries the judgement calls.
22-
4. `SKILL.md` holds only what every run needs.
23-
5. Verification is a step of the procedure, for the output and for the skill itself.
24-
6. Optionally, a human feedback loop, where the skill ends by reporting its own friction upstream.
19+
- Principle 1: The description is a router, so it says when to use the skill in the words a user would type.
20+
- Principle 2: The body is steps, and anything that isn't a step gets deleted.
21+
- Principle 3: Scripts carry the fixed sequences, and the agent carries the judgement calls.
22+
- Principle 4: `SKILL.md` holds only what every run needs.
23+
- Principle 5: Verification is a step of the procedure, for the output and for the skill itself.
24+
- Principle 6 (optional): A human feedback loop, where the skill ends by reporting its own friction upstream.
2525

2626
The rest of the post goes through each one with a bad and a good example.
2727

0 commit comments

Comments
 (0)