Agent Skills

Why it's ranked here

This is the reference corpus for a skill format that other agent runtimes have since adopted, and it is unusual in shipping the real implementations behind a production document pipeline rather than toy samples. Any bundle installs with one command, each skill declares its dependencies, and the document skills are dense with specific, checkable failure modes instead of generic advice. Two caveats are visible in the repository itself: several skills are source-available rather than open source, and the format specification lives elsewhere.

What's good

The document skills read as failure catalogues, and that is where the value sits. The spreadsheet instructions name the exact modern Excel functions that need a special prefix, warn that spill-style functions can produce silently truncated results with zero reported errors, and note that a clean recalculation only proves formulas evaluate, not that they are correct. The word-processing skill treats documents from outside parties as untrusted, telling you to delete symlinks from unpacked archives, and its commenting helper parses XML defensively and escapes text by default. This is operator knowledge, written down.

Tradeoffs

Licensing is not uniform: the word-processing, PDF and spreadsheet skills declare themselves proprietary while the readme describes many others as Apache 2.0, so the collection cannot be adopted wholesale. The readme also says these are demonstrations and real behaviour may differ. The bundled evaluation harness pins an older model by default, executes only the first tool call in a response so parallel calls are dropped, and grades answers by exact string match, workable for IDs and numbers and little else. One art skill instructs the model to praise its own output, a self-description rather than a quality control.

How to use it well

Install one bundle rather than the whole tree; the marketplace manifest lists which skills each carries. When writing your own, spend the effort on the description, since that is what fires the skill. Copy the document skills' pattern: enumerate the specific ways a task fails and the exact command that verifies the output. Skip the deliberately empty template and start from the skill that teaches skill authoring; its paired runs with and without the new skill are the part worth copying, since a skill that changes nothing is not earning its context. Treat bundled scripts as black boxes driven through their help flag.

Observed

License

Mixed: the word-processing, PDF and spreadsheet skills declare a proprietary license in their frontmatter, while the readme states many other skills are Apache 2.0

Interfaces

Installable as a Claude Code marketplace with three plugin bundles covering document skills, example skills and the Claude API skill

Specification

The in-repo spec file is a one-line pointer to agentskills.io; the specification text itself is not in the repository

Skill format

Only two frontmatter fields are required, name and description

Template

The bundled template contains only a name and description plus a single heading