Home/Guides/Why did every AI tool start shipping “s…
Guide · 6 min read

Why did every AI tool start shipping “skills” at the same time?

Because the prompt was never the reusable unit — and everybody discovered that in the same quarter.

Quick answer

Because a prompt cannot be versioned, reviewed, or handed to someone else, and every team that got past a demo needed all three. A skill is the smallest package that survives leaving your head: a folder with a name, a description of when to use it, the procedure itself, and the files it needs. The convergence is not a trend — it is what…

For about two years the unit of AI work was the prompt. You wrote a good one, it worked, you pasted it into a note, and three weeks later you could not find it — or you found it and could not remember which of the four versions was the one that worked.

Then, over a few months, almost every serious agent product started shipping the same thing under the same word: skills. Folders. With names. Versioned like code.

That kind of convergence is rarely fashion. It usually means several teams walked into the same wall.

The wall is not capability. It is transfer.

A prompt that works is a private result. It lives in one person's context, in one conversation, on one afternoon. It cannot be reviewed by a colleague, tested against a change, rolled back when it regresses, or handed to the new analyst who joined on Monday.

Every organisation that got past a successful demo hit the same three questions, in this order:

None of those are model problems. All of them are packaging problems. A skill is the smallest package that answers all three.

What is actually in one

Strip away the branding and the shape is boringly consistent across products:

Notice what is not in that list. No model name. No temperature. No vendor. A skill describes the work, not the machine — which is exactly why it outlives the machine.

The property that decides whether it was worth writing

There is one test, and it is not “does it work.” It is: can it move?

Move to another person. Move to another agent. Move to another vendor when the one you picked doubles its price or gets acquired. If your procedure is expressed as settings inside somebody's product, it moves nowhere, and every month you spend refining it deepens a hole you dug for yourself. If it is expressed as text you own, it is portable by construction.

This is the quiet reason the convergence happened. Vendors did not adopt skills to be generous. They adopted skills because customers who had been burned once refused to buy the unportable version again.

Where teams get it wrong

Writing the procedure they wish they had, not the one they run. The value is in the exceptions — the client type that needs a second signature, the reconciliation that always breaks on the last day of the quarter. Those are the parts nobody documents, and the parts that decide whether the output can be trusted.

Writing one enormous skill. If it covers four unrelated jobs, an agent cannot tell when to use it, and neither can a new hire. Skills should be about the size of a thing one person does in one sitting.

Treating the description as a label. It is a routing decision. “Handles invoices” tells nothing. “Use when an incoming invoice must be matched to a purchase order before payment approval, including partial deliveries” tells everything.

The strategic version

If skills are the unit, then the asset your organisation is building is not a model subscription. It is a library of written procedures that any capable system can execute — this year's, and the one that replaces it.

Which reframes the budget question. The spend that compounds is the one that produces text you own. Everything else is rent.

Frequently asked questions

Is a skill just a long prompt?
No, and the difference is structural rather than stylistic. A prompt is an instruction issued inside one conversation. A skill is a named, versioned artefact that sits outside every conversation, is selected on the basis of its description, and can carry files with it. The practical test is whether a second person can run it without asking you anything.
Do we need a specific tool to write skills?
No. A skill is a folder of Markdown and supporting files. You can write the first one in a text editor this afternoon. Tooling matters for distribution and versioning, not for authoring — and choosing tooling before you have written three skills is a good way to buy a solution to a problem you have not met yet.
How many skills should an organisation have?
Far fewer than people expect at the start. Most teams get real leverage from between five and twenty, covering the work that is done often, done by more than one person, and expensive when done inconsistently. A library of two hundred usually means nobody pruned, and an agent that cannot choose between two hundred descriptions will choose badly.

Related skill

AI Harnesses

Detecting Harness Lockin

Identifies and quantifies the compounding switching cost of an AI coding agent harness commitment before it becomes inv…

Turn this guide into a skill your agent can run

Stop re-explaining the same workflow. Loreto packages it as a Claude Code skill from any source.