2 Commits

• Add gotchas section to best practices guide

  Add a new "Gotchas sections" subsection to "Patterns for effective
  instructions" in the best practices guide. Covers what a gotcha is
  (environment-specific facts that defy reasonable assumptions), how to
  structure them (problem/correction pairs), and why they belong directly
  in `SKILL.md` rather than a separate reference file.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-03-15 17:32:38 -05:00
  4be62ebad0
• Add best practices guide for skill creators

  Covers grounding skills in real expertise (extracting from tasks,
  synthesizing from project artifacts), iterating with execution feedback,
  managing context budget, calibrating instruction specificity, and
  reusable instruction patterns (templates, checklists, validation loops,
  plan-validate-execute, script bundling).
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-03-10 14:19:12 -05:00
  db92534bfb