World's Fair 2026
Building Great Agent Skills: The Missing Manual
Overview
This talk addresses the growing problem of "skill hell" in AI development, where developers struggle to effectively use and integrate available skills. The core thesis is that a lack of clear criteria for what constitutes a "great skill" hinders progress. The presentation offers a structured checklist and practical techniques to help developers build, evaluate, and improve AI skills, moving beyond the current state of confusion and inefficiency.
Who should watch
- AI Engineers
- Product Managers
- Developers building with AI agents
- Anyone struggling to integrate or build effective AI skills
- Those looking to improve the reliability and performance of AI agent workflows
Key takeaways
- Skills can be either user-invoked or model-invoked, each with trade-offs regarding context load on the agent versus cognitive load on the user. Model-invoked skills increase agent context load, while user-invoked skills increase user cognitive load.
- A skill's internal structure can be broken down into "steps" (the procedure) and "reference" (supporting information), aiding in organization and maintainability.
- To minimize the main skill file size, reference material relevant to specific branches of a skill should be hidden behind context pointers, stored in separate files.
- Steering agent behavior effectively can be achieved using "leading words" – concise terms that pack significant meaning and are repeated by the agent in its reasoning, influencing its actions.
- To ensure agents perform sufficient "legwork" on a given step, complex processes can be split into separate skills, hiding future steps and focusing the agent on the immediate task.
- Pruning involves eliminating duplication, removing "sediment" (irrelevant or poorly structured contributions), and identifying and removing "no-ops" (actions that appear to do something but don't affect agent behavior).
- A new skill, *writing great skills*, is available in the speaker's repository to help users apply these concepts immediately.
- The ultimate goal is to help developers escape "skill hell" by providing a framework for building robust, understandable, and effective AI skills.
Notable quotes
*Skill hell is where you have all of these skills available, freely available, that you can download, contribute to, you can figure out on your own, but you don't really know how the pieces all work together.*
*The thing that we're missing is we don't know what makes a skill great.*
*The idea of leading words... is that there are certain words that pack in a bunch of meaning into a very small space.*
Unofficial community note. Prefer the recording for nuance.