Version Every Change
Bump the version for every release, by its effect on users, with a changelog entry. No bump means no update.
Where you'll practice this
One Promptles scenario teaches this principle directly.
Release the Fix and the Rename
Two weeks ago Dana merged a fix so the lint hook stops skipping files with spaces in their names, yet teammates still see the old behavior after restarting Claude Code and updating the marketplace. Since then a second PR renamed the `notes` skill to `release-notes` and dropped…
Other principles in Output Format
Close the Design Loop
Send the built screen back into the design tool so designers review the real thing.
Describe the Destination
Describe where the data lands and the exact shape it needs there.
Make the Output Findable
Say where the result should live and how to title it so you and Claude can find it later.
Scope Your Commits
One logical change per commit, with a note saying what changed and why.
Show an Example
Show one real input and the exact output you want. One example settles what a description leaves open.
Show Examples in the Skill Body
Put two or three real examples in the skill. Examples carry further than rules.