We Ran 250 AI Agent Evals to Find Out if Skills Beat Docs. The Answer Is More Complicated Than We Expected

2026-06-29

Wix's 250-run evaluation found agent-optimized docs improved CLI task completion from 67% to 87%, cut token use 35%, and beat skills-only runs when skills were stale or misaligned. For API tasks, both hit 80% completion, but docs ran 31% faster while skills used 29% fewer tokens. Use optimized docs as the foundation, with skills as an evaluated caching layer.