Claude Code Skills: Separating AI Engineering from Prompt Vibes

- Anthropic reveals that effective Skills are folders of scripts and resources, not just markdown prompts.
- Independent benchmarks show that generic instructions to write clean code often increase code length rather than reducing it.
- Only 7 out of 40 viral prompt codes measurably changed AI reasoning; most only altered the tone or formatting.
- Rejection-logic prompts (e.g., challenging premises) outperform additive instructions in improving output quality.
For months, the AI developer community has been flooded with repositories of agent skills—reusable instruction files designed to make LLMs write cleaner code, debug faster, and consume fewer tokens. Many of these collections boast tens of thousands of GitHub stars, yet they rarely provide a single empirical data point to prove they actually work. The industry has largely relied on a feeling of improvement, a phenomenon that researchers are now identifying as the placebo effect of prompting.
Recent findings suggest a stark divide between what developers think is improving their AI's performance and what is actually happening under the hood. When subjected to rigorous blind A/B testing, the majority of viral prompt codes fail to shift the underlying reasoning of the model, instead merely changing the aesthetic of the response.
The Placebo Effect in AI Prompting
The danger of relying on intuitive prompting is that a confident-sounding instruction often looks identical to a working instruction until it is measured. In a recent benchmark involving 496 runs on Anthropic's Claude Opus, a researcher tested an anti-over-engineering skill against both a baseline and a placebo prompt. The results were revealing: while the specific skill successfully reduced source lines of code (LOC) by 23.8% without losing accuracy, the placebo prompt—which simply told the model to write clean, minimal, and professional code—actually increased the amount of code produced in 7 out of 12 tasks.
This suggests that LLMs are highly suggestible. When given a generic exhortation to be professional or clean, the model often pads its response to match the perceived vibe of a professional developer, adding tokens without adding value. This creates a feedback loop where developers believe the AI is being more thorough, while in reality, it is simply becoming more verbose.
Beyond the Prompt: Anthropic's Internal Playbook
To combat the inefficiency of simple prompting, Anthropic has shared insights into how its own engineers utilize Skills within Claude Code. The primary takeaway is a fundamental shift in definition: a Skill is not a markdown file or a long prompt, but a folder containing scripts, resources, and instructions. By providing the agent with a working kit—including reference documents, templates, and hooks—the model has a concrete framework to follow rather than a vague set of instructions to interpret.
According to the company, internal teams run hundreds of these Skills, which are categorized into nine distinct types to cover the entire software workflow. These range from library and API reference Skills, which prevent common mistakes with specific SDKs, to product verification Skills that can execute full signup and checkout flows in headless browsers to ensure the code actually works in a live environment.
Cognitive Shift vs. Structural Formatting
Not all prompts are created equal, and the difference lies in whether a prompt is additive or restrictive. A study of 40 widely circulated Claude prompt codes found that only seven actually changed the model's reasoning. The remaining 33 were structural; they made the AI sound more confident or less hedgy, but the underlying logic remained unchanged.
The prompts that successfully shifted reasoning shared a common trait: they utilized rejection-logic. Instead of telling the AI to be more expert or thorough (additive), they told the AI what framings to refuse. For example, the /skeptic prompt, which instructs the model to challenge the premise of a question before answering, showed a 5.5x improvement over the baseline in catching incorrect premises. While a standard prompt might provide a detailed plan for a flawed idea, the rejection-logic prompt identifies why the idea should not be pursued in the first place.
The Hierarchy of Effective AI Skills
For entrepreneurs and technical leads, the goal is to move away from prompt engineering and toward AI systems engineering. The evidence suggests that the most value is derived from verification and constraint-based instructions. Verification skills, which check if the output actually functions, are noted as having the biggest quality impact and are often worth significant engineering effort to implement.
The distinction matters because what teams usually lack is not another paragraph of prompting but a one-time consolidation of practices they have already validated.
By treating AI skills as a repository of validated company practices—scripts, data fetching tools, and fixed procedures—businesses can ensure that their AI agents are operating on factual internal standards rather than the statistical probabilities of a general-purpose model.
Measuring Success in Agentic Workflows
To avoid the placebo trap, the industry must adopt more rigorous testing standards. The methodology used in recent benchmarks provides a blueprint: a three-way comparison involving the baseline (no instruction), a placebo (vibe-based instruction), and the actual skill. This must be measured against hidden hold-out tests that the agent never sees, ensuring that the results are not a product of the model simply memorizing the test cases.
Developers can find more detailed discussions on these benchmarks and the failure rates of various skills on platforms like Dev.to, where the gap between perceived and actual performance is documented through raw run logs.
Strategic Implications for Global Enterprises
For companies in the USA and UK, the shift from prompt-based AI to resource-based Skills represents a move toward more predictable and auditable AI behavior. In the US market, where speed of deployment is often prioritized, the temptation to use viral prompt codes is high. However, the risk of AI-generated bloat—where codebases grow in size without growing in functionality—can lead to significant technical debt.
From a regulatory and operational perspective, the use of structured Skills (folders of scripts and validated docs) is far easier to govern than a collection of opaque prompts. When an AI agent relies on a specific internal SDK reference file, the output is traceable to a source of truth. This is critical for firms operating under strict compliance frameworks in the financial or healthcare sectors of the UK and USA, where the ability to explain why an AI took a specific action is more important than the speed of the output.
Enterprises should stop investing in prompt libraries and start investing in the curation of their internal technical knowledge. The competitive advantage will not come from knowing the secret code to unlock a model's reasoning, but from providing the model with the precise, validated resources it needs to execute a task without hallucination or over-engineering.
FAQ
What is the difference between a prompt and a Skill in Claude Code?
A prompt is a block of text instructing the AI, while a Skill is a folder containing instructions, scripts, templates, and reference documents that the agent can use as a toolkit.
Why do some prompts make the AI write more code even when told to be minimal?
This is a placebo effect where the AI mimics the perceived style of a professional developer (who might be thorough) rather than following the actual instruction to be concise.
Which type of prompting is most effective for improving reasoning?
Rejection-logic prompts, which tell the AI to challenge premises or refuse certain framings, are significantly more effective than additive prompts that ask the AI to be more expert or thorough.
How can a company verify if an AI skill is actually working?
By running a three-way blind A/B test comparing the skill against a no-instruction baseline and a placebo prompt, using hidden hold-out tests to measure accuracy and code length.
Scrivila qui: Susanna, l assistente AI di glacom, ti risponde via email con un approfondimento gratuito.
Nessuna consulenza personalizzata (finanziaria, legale o medica): solo informazione e fonti. Email usata solo per rispondere.
oppure scrivile su: WhatsApp · Telegram · SimpleX · Delta Chat · Email










