# Wix compares AI agent performance using skills, standard documentation, and AI-optimized documentation

DevFeed: [Wix compares AI agent performance using skills, standard documentation, and AI-optimized documentation](<https://devfeed.tech/articles/we-ran-250-ai-agent-evals-to-find-out-if-skills-beat-docs-the-answer-is-more-complicated-than-we-expected-22644.md>)

Original publisher: [Read original article](<https://www.wix.engineering/post/we-ran-250-ai-agent-evals-to-find-out-if-skills-beat-docs-the-answer-is-more-complicated-than-we-ex>)

Author: Wix Engineering

Published: 2026-05-06T11:16:26Z

Content type: article

Language: en

Sources: [Wix Engineering](<https://devfeed.tech/sources/wix-engineering.md>)

Topics: [AI Agent](<https://devfeed.tech/topics/ai-agent.md>), [Documentation](<https://devfeed.tech/topics/documentation.md>), [Developer experience](<https://devfeed.tech/topics/developer-experience.md>), [Command-line interface](<https://devfeed.tech/topics/cli.md>)

Tags: [agents](<https://devfeed.tech/tags/agents.md>), [ai-agent](<https://devfeed.tech/tags/ai-agent.md>), [developer-experience](<https://devfeed.tech/tags/developer-experience.md>), [docs](<https://devfeed.tech/tags/docs.md>), [documentation](<https://devfeed.tech/tags/documentation.md>), [evals](<https://devfeed.tech/tags/evals.md>)

## AI overview

Wix describes 250 controlled evaluations comparing AI agents using standard documentation, AI-optimized documentation, and purpose-built skills. The article reports that stale skills can become a liability and questions whether manually maintained skills consistently outperform documentation.

## Source excerpt

The industry has a new obsession: AI skills. The logic seems bulletproof: if you want an AI agent to use your platform, you shouldn't just give it raw documentation. You should give it a "skill", a curated, condensed, and optimized guide. This will allow the agent to perform tasks on your platform better than if they have to trawl through your docs. Skills are intuitive and trendy, but do they really provide agents with an edge over just using the docs and, if so, in what cases? At Wix, we...