SkillRevise: Improving LLM-Authored Agent Skills via Trace-Conditioned Skill Revision
SkillRevise is an execution-grounded framework that iteratively refines imperfect initial agent skills by diagnosing defects from execution traces, retrieving repair principles, and empirically selecting optimal versions, thereby significantly improving agent success rates and cross-model transferability compared to one-shot generation methods.
Original paper licensed under CC BY 4.0 (http://creativecommons.org/licenses/by/4.0/). This is an AI-generated explanation of the paper below. It is not written or endorsed by the authors. For technical accuracy, refer to the original paper. Read full disclaimer
The Big Picture: Teaching a Robot to "Learn from its Mistakes"
Imagine you hire a very smart but inexperienced intern (the AI Agent) to do a complex job, like organizing a massive warehouse or debugging a computer program.
Usually, you give the intern a manual (called a "Skill").
- The Problem: If the manual is written by a human expert, it's expensive and might not match how the intern actually thinks. If you ask the intern to write their own manual in one go, they might write something that looks perfect on paper but falls apart when they try to do the work.
- The Old Way: Previous methods tried to fix the manual by letting the intern practice a lot and slowly "evolve" the instructions. But this takes forever and doesn't work well if you start with a bad manual (the "cold start" problem).
SKILLREVISE is a new system that acts like a strict but helpful coach. Instead of waiting for the intern to learn over months, it takes a rough draft of a manual, has the intern try it, watches exactly where they fail, and then edits the manual immediately based on that specific failure.
How It Works: The "Coach's Loop"
The paper describes a four-step cycle that happens over and over again (usually three times) to perfect the manual:
1. The Trial Run (Execution)
The intern tries to do the task using the current version of the manual.
- Analogy: The intern tries to build a bookshelf. They follow the instructions, but the shelf wobbles and falls over.
2. The Autopsy (Diagnosis)
The system doesn't just say "You failed." It acts like a detective. It looks at the evidence (the wobbly shelf) and asks:
- What went wrong? (Did we use the wrong screws?)
- What went right? (The wood was cut perfectly, so don't change that part.)
- Analogy: The coach says, "You didn't measure the wood wrong, but you skipped the step of checking if the floor was level. Also, keep the part about sanding the wood; that was good."
3. The Library of Wisdom (Principle Memory)
The system checks a "library" of general repair rules. It doesn't look for the answer to this specific bookshelf; it looks for a rule about how to fix wobbly shelves in general.
- Analogy: The coach pulls a card from a deck that says: "Rule #4: Always check the foundation before building the frame."
4. The Rewrite (Revision)
The system combines the detective's report and the general rule to rewrite the manual. Crucially, it adds "Anchors."
- What are Anchors? These are specific checkpoints. Instead of saying "Build it carefully," the new manual says, "Pause here, check the floor level, and if it's uneven, stop."
- Analogy: The new manual now has a red sticky note: "STOP AND CHECK FLOOR LEVEL BEFORE NAILING."
5. The Final Decision (Utility Gate)
The intern tries the new manual.
- If the new manual works better, the system keeps it.
- If the new manual makes things worse, the system throws it away and goes back to the previous version.
- Analogy: The coach tries the new instructions. If the shelf is still wobbly, they say, "Okay, that new idea was bad. Let's go back to the old instructions and try a different fix next time."
Why Is This Special?
The paper highlights three main reasons why this approach is better than what we've had before:
- It Starts Small (Cold-Start Friendly): You don't need a library of 1,000 perfect manuals to start. You just need one imperfect manual, and SKILLREVISE can fix it quickly.
- It's Not Just "More Practice": Old methods let the AI practice thousands of times to learn. SKILLREVISE is like a targeted surgery. It finds the specific defect in the instructions and fixes it, rather than hoping the AI figures it out by accident.
- It Learns General Rules, Not Just Tricks: The system is careful not to teach the AI to cheat for this specific test. It teaches the AI how to handle types of problems.
- Bad Skill: "If the test asks for a red button, press the red button." (This only works for that one test).
- Good Skill (SKILLREVISE): "Always verify the color of the button against the diagram before pressing." (This works for any test).
The Results: Does It Work?
The authors tested this on three different "exam rooms" (benchmarks) with different AI models (like GPT-5.5, Qwen, and DeepSeek).
- The Score: Without any help, the AI got about 36% of the tasks right. With a one-shot manual (written once and never fixed), it got about 39% right.
- The SKILLREVISE Score: After just three rounds of this "Coach's Loop," the AI got 61% of the tasks right.
- The Takeaway: The system turned a mediocre manual into a highly effective one very quickly. It also showed that these improved manuals could be used by different AI models, not just the one that wrote them, proving the skills were truly general knowledge, not just specific tricks.
In Summary
SKILLREVISE is a framework that treats AI "skills" not as static instructions, but as living documents. It uses a cycle of Try Diagnose Retrieve General Rules Rewrite Test to turn a bad set of instructions into a great one, ensuring the AI doesn't just memorize answers but learns how to actually do the work correctly.
Drowning in papers in your field?
Get daily digests of the most novel papers matching your research keywords — with technical summaries, in your language.