# Agent skill

An agent skill is a packaged set of instructions, usually a SKILL.md file, that an AI coding agent loads to carry out a specific kind of task. Nicholas Hopper writes skills as the operating procedures of his systems and tests them like code.

- **Published:** November 17, 2026
- **Updated:** November 17, 2026

## A skill as the only client

On Vibecode City, Nicholas Hopper deleted the project's command-line tool and replaced it with one installable skill. A player's coding agent reads the skill and performs login, parcel claim, build, validation and signed publish itself, using ordinary shell tools.

Hopper then made the end-to-end test execute the skill's literal shell recipes. In his words, the test "is now the acceptance test for the prose". If the instructions drift from what the server accepts, the test fails.

He also folded the skill into a single file, served as plain markdown, so that a player can read exactly what they are installing. The test asserts that the installed directory contains only that file.

## One procedure for two harnesses

At APX Stream, Hopper wrote skills for Claude Code and Codex covering service scaffolding, QA campaigns, bug registry upkeep and delivery to the main branch. Where both harnesses need the same procedure, one copy is canonical and the other is a short pointer to it, so there is one procedure to maintain.

## Related skills

- [Agent Skills](https://nicholashopper.com/skills/agent-skills.md)
- [Claude Code](https://nicholashopper.com/skills/claude-code.md)
- Codex

## Related projects

- [Vibecode City](https://nicholashopper.com/projects/vibecode-city.md)

---

Canonical page: https://nicholashopper.com/notes/agent-skill  
Last updated: 2026-11-17  
Index of all pages: https://nicholashopper.com/llms.txt
