How Should Agent Capabilities Be Structured: Skills vs Documentation?

Wix's 250-eval study reveals nuanced tradeoffs between skills-based and documentation-based approaches. Skills-based design provides explicit capability boundaries and clearer agent behavior, while documentation-based approaches offer flexibility and context. The optimal choice depends on task complexity, agent reliability requirements, and domain specificity.