skills

Reading a skill is the cheap part. The work it drives is where the tokens and the time go - every search, file read, retry and wrong turn the agent takes along the way. A good skill makes that work predictable: fewer wrong turns, and the same result tomorrow as today.

This article walks through how I plan and write skills, with a release-notes skill as the running example, and how to test them with tools like skillgrade.

A deterministic workflow with AI agents is orchestrated by having efficient system prompts and skills to help you combat context rot and agentic drift, and prevent user steering and general frustration.

The goal of this article is to teach any user (not only developers) how to build those efficiently and to give insights into how to maintain them in the future.