6.3 Common Mistakes to Avoid
Common Mistakes to Avoid
Learn from others' failures, not your own
Top Four Skill Mistakes
Instructions Too Vague
Write something nice produces inconsistent results. Be specific about tone, length, format, and audience.
No Error Handling
What happens when data is missing? When an API fails? Plan for failure modes.
Too Much in One Skill
If your SKILL.md exceeds 500 lines, split it. Focused Skills are reliable Skills.
Skipping Trigger Testing
If the Skill does not activate correctly, nothing else matters. Test triggers first.
Positioning: Results vs. Features
Good: Focus on Results
ProjectHub skill enables teams to set up complete project spaces instead of 30 minutes of manual setup.
Bad: Focus on Features
ProjectHub skill is a folder containing YAML frontmatter and Markdown instructions.
The One-Skill-One-Job Rule
The principle of one skill, one job applies at every level. Even advanced patterns should maintain clear boundaries and a single responsibility.
Recovery Checklist
Avoidance Strategy
Most mistakes come from rushing the planning phase. Spend 30 minutes planning before writing any instructions, and you will avoid 80 percent of common pitfalls.
Úskalí, která potkají i zkušené tvůrce Skills.
There are no comments for now.