Theo on Writing Skill Descriptions as Triggers

Theo argues that a skill description should help a model decide when to load the skill, rather than contain the entire procedure.

TBTheo BrowneVortrag · Ping Labs
Kanal
Theo - t3․gg
Veröffentlicht
11. Aug. 2026
Video
0:31
Lesezeit
1 Min.
Folien
1
Original
Englisch
Auf YouTube öffnen
Beim Scrollen schrumpft das Video in die rechte untere Ecke und läuft weiter. Untertitel folgen Ihrer Lesesprache.
LesespracheIn 2 Sprachen verfügbar
Diesen Artikel gibt es noch nicht auf Deutsch, daher wird das Original (Englisch) angezeigt.
ZUSAMMENFASSUNG

In 30 Sekunden

Theo Browne suggests treating an AI agent skill’s description primarily as a trigger. He says descriptions may be included even when a skill is not used, so detailed procedures belong in the skill itself.

  1. 1Think about triggersTheo recommends treating the skill description as a way to signal when the model should load it.
  2. 2Context costHe says descriptions are inserted even when the skill is not used; that behavior depends on the agent system.
  3. 3Keep details in the skillAn overly detailed description can effectively contain the whole skill before the model chooses to load it.

Das Wichtigste

  1. A skill description can tell a model when the skill is relevant.
  2. Theo argues that descriptions should avoid embedding the full procedure.
  3. How descriptions are provided to a model depends on the particular agent system.
VOLLTEXT

Den bearbeiteten Text nach Kapiteln lesen

Nur das Transkript
01

Descriptions as routing cues

Theo explains why he favors trigger-oriented descriptions for skills. His advice is motivated by how descriptions are supplied to a model in the workflow he discusses.

Think of the description of a skill as trigger keywords, rather than a complete explanation of what it does. The important job is to tell the model when to pull that skill in.

In the setup I am discussing, the description is inserted even when the skill is not being used. I have seen descriptions that contain everything needed to perform the task, so the model can get the details without ever loading the skill itself. How and when descriptions enter context varies by agent system.

A skill description example
FOLIE 1 / 1A skill description exampleA SKILL.md file highlights a description that identifies requests to monitor or babysit a pull request.

For that reason, I would avoid turning the description into an elaborate explanation of every operation. Use the terms and situations that help the model recognize when the skill is relevant, and keep the detailed procedure in the skill.

Mehr aus diesem Kanal

5 Folien38:47EN
Theo - t3․gg· 28. Okt. 2026Theo’s Long-Running Agent Experiments: Verification, Compute and CostTheo Browne · Ping LabsA skateboard game and two compiler projects show how repeated checks and flexible compute can sustain agent work—and how expensive those loops can become.Coding-AgentenAgent EngineeringAI cost & performance+2
5 Folien36:07EN
Theo - t3․gg· 27. Okt. 2026Theo on Token Costs, Coding Agents, and the Price of AI CapabilityTheo Browne · Ping LabsA viral estimate of Lauren's AI spending prompts a closer look at cache pricing, benchmarks, and the changing work of coding agents.AI cost & performanceCoding-AgentenInference+1
5 Folien30:37EN
Theo - t3․gg· 26. Okt. 2026Theo’s Three Skills for Reviewing and Shipping with Coding AgentsTheo Browne · Ping LabsHow sol-loop, full-send and full-stop encode review, verification and different levels of merge authority.Agent skillsCoding-AgentenCode review & verification+2
2 Folien0:43EN
Theo - t3․gg· 23. Okt. 2026Theo Distinguishes Security Vulnerabilities from Active AttacksTheo Browne · Ping LabsA short explanation of why disclosed software flaws and reported attacks are different kinds of security news.CybersecuritySoftware engineering
6 Folien29:22EN
Theo - t3․gg· 22. Okt. 2026Theo on Security Vulnerabilities, Stolen API Keys and AITheo Browne · Ping LabsA look at the gap between vulnerability disclosure and patching, and a speculative account of why stolen inference keys may be valuable.CybersecurityAI securitySoftware engineering+1
4 Folien31:13EN
Theo - t3․gg· 20. Okt. 2026Theo on Why Smarter Models Help More Than DevelopersTheo Browne · Ping LabsFrom game modifications to compiler experiments, Theo revisits his assumptions about who benefits from more capable AI.Coding-AgentenDeveloper productivityHuman-AI Collaboration+1