AI summary
Anthropic recently updated its guide for writing skills in Claude 5.5 models, introducing new best practices that improve performance and save tokens. The video covers 10 new rules for skill authoring, ranging from structural patterns like progressive disclosure and content lists to operational strategies like degrees of freedom, testing, feedback loops, and hooks.
- Keep main SKILL.md files under 500 lines and link reference files directly to optimize token usage and context windows.
- Include a table of contents at the top of any reference file longer than 100 lines so Claude can jump directly to the needed section.
- Match degrees of freedom to task risk by using high freedom for creative brainstorming, medium freedom for templates, and low freedom for strict scripts.
- Implement clear checklists, workflows, and feedback loops (run, fix, repeat) to prevent Claude from skipping critical steps in multi-step tasks.
- Use pre-tool hooks for high-stakes rules that must never be broken, ensuring automated validation runs before sensitive commands execute.