Skills for AI Agents

Chapter 3. Designing and Building Skills

A Note for Early Release Readers

With Early Release ebooks, you get books in their earliest form—the author’s raw and unedited content as they write—so you can take advantage of these technologies long before the official release of these titles.

This will be the 3rd chapter of the final book. Please note that the GitHub repo will be made active later on.

If you’d like to be actively involved in reviewing and commenting on this draft, please reach out to the editor at [e-mail].

The skill format is deceptively simple, you may be able to write a skill in one afternoon and build something that works on your laptop in a single sitting. However, you’ll end up adding infinite bullets to that same file, watching it grow into a runbook nobody, neither you nor the agent, reads and acts on it anymore. The simplicity of the form does not protect you from the discipline of writing good skills.

Given that you understand the format of a skill, how do you actually create one that is worth using? In this chapter, you’ll see what turns a folder with markdown files into something reliably useful that properly makes use of the strengths of both human and agent such that both can contribute to the automation of tasks while keeping standards of quality and accuracy.

First,we need a way of looking at where skills actually fit inside the work a person does day to day, because without that framing this checklist becomes a shopping list.

The 85% ...