This is probably the most useful explanation of how to create a skill that I've seen. I have definitely fallen into giving step by step instructions trap. I am definitely going to take some of this advice.
link
8 Tips for Writing Agent Skills
Philipp Schmid
8 Tips for Writing Agent Skills
8 Tips for Writing Agent Skills. Know What a Skill Is, Nail the Description, Write Instructions, Keep It Lean, Set the Right Level of Freedom, Don't Skip Negative Cases, Test It Before You Ship It, Know When to Retire a Skill.