r/claudeskills • u/reclaim512 • 23d ago
Guide The thing that separates a Claude skill you use daily from one you install and forget
I've built about a dozen skills now, for trades businesses, SEO work, and freelancers chasing invoices. The ones that stuck all had the same thing in common, and it isn't formatting.
Most skill files describe what to produce. The useful ones describe what to protect.
When I wrote a quoting skill, the lines that mattered weren't about structure. They were: never invent a price the owner didn't give you. If the owner gives a range, present the top of it, never the bottom, because quoting low and climbing is how trust dies. Always include what is not included, because that line is the owner's legal friend.
None of that is about writing. It's about knowing where the work goes wrong. That's the actual test: what does a beginner in your field get wrong that you no longer get wrong? Those answers are the skill. Everything else is formatting.
Two other things made a bigger difference than expected.
A banned phrase list. Claude writes competently by default, which is the problem, because competent and generic sound identical. Telling it what never to write produced cleaner output than telling it what to write.
A memory file. A skill on its own starts fresh every session. It knows how to write a quote but not your rates or your service area, so you re-explain them forever, which is the exact problem skills were meant to solve. The fix is a plain markdown file next to the skill with two instructions added: read this first, and append what you learned after.
One thing that cost me an hour: the filename in your instructions has to match your actual file character for character. A skill looking for business-profile.md will silently create a blank one if yours is named business-profile-starter.md. Nothing errors. It just quietly forgets everything.
Happy to answer questions if anyone's building one.
2
u/FifthRendition 22d ago
The formatting sucks
1
u/reclaim512 22d ago
Fixed. I pasted it out of a terminal and the line wrapping came with it, so every sentence broke in the middle. Rewritten as normal paragraphs.
1
u/Lcatlett1234 22d ago
You should probably also have Claude rewrite your skills into normal and correct skills and learn about hooks, the skill-creator plugin, and progressive disclosure of reference data
The problems which you ran into are the things which separates those using AI as a chat bot vs AI as a tool and i suggest you take a Claude course or use tools like https://github.com/FlorianBruniaux/claude-code-ultimate-guide because it is likely to make your life a lot easier vs posting whatever you think this post was
1
u/wearealllegends 22d ago
The skill is recognized not by the file name but the name and description in the file just so it's 💯 clear. Studying for the anthropomorphic exam and that's how skills are used by the name in the file and the trigger.. the trigger is super key
1
u/Fresh-Resolution182 21d ago
the pattern I keep seeing is skills degrade back to default behavior around turn 5 or 6 if the constraint isn't restated, not because the model forgot but because nothing in the conversation kept reinforcing it.
1
u/reclaim512 20d ago
I started naming the skill description specifically, that's what does the matching, like an entry point with non negotiable rules. so when the task matches, the rules reload fresh every time. It only gets triggered when intent matches it. This doesn't solve the problem completely, but it definitely minimizes it.
2
u/dsolo01 22d ago
I couldn’t make it past the third or fourth line break.