Use markdown with clear headings, prioritized top-of-file rules, and short sections to make product design instructions easy for humans and AI systems to read.
When a Claude skill fails, check whether it triggers, verify correct file naming and directory structure, and confirm the core SKILL.md content is in place.