AI Coding Tip 035 - Split Every Skill Description Into Three Sentences
A skill nobody finds in time is a skill you don't have.
TL;DR: Split every skill description into three sentences: when to read it, when to use it, and what it does.
Common Mistake ❌
You write a skill description as one long paragraph.
It explains everything the skill does.
You list every feature, every parameter, every edge case it handles.
That's the same way a function keeps growing, until nobody remembers its original job.
An agent scans a hundred skill descriptions to pick one.
It can't tell in a glance whether yours applies.
So it skips your skill for one with a sharper trigger.
Or it opens the whole file just to check.
That's the exact context cost progressive disclosure was invented to avoid.
You are suffering the problem you were supposed to solve.
Problems Addressed 😔
- Too many skills, or overly long descriptions, degrade agent performance,...
Copyright of this story solely belongs to hackernoon.com. To see the full text click HERE
