🐙
Freeai agentsopen sourceskills

SkillOpt, from Microsoft, is a framework for improving AI agent performance by treating skill documents as trainable text artifacts rather than fine-tuning the underlying model. It runs a loop of rollouts, reflection, bounded edits, and validation to evolve a skill's natural-language instructions, exporting reusable skill files that transfer across different models and execution environments. This 'text-space optimization' approach demonstrated gains ranging from 9-50% across 6 benchmarks and 7 target models, making it useful for developers and researchers who want to systematically improve agent behavior without retraining.

What is SkillOpt?

SkillOpt is a research framework from Microsoft for improving agent behavior by editing text instead of model weights. The unit it optimizes is a skill document, meaning the natural language file that tells an agent how to approach a class of task. SkillOpt runs a loop: execute rollouts of the agent on the task, reflect on what went wrong, make bounded edits to the skill document, and validate that the edited version actually performs better before keeping it. The bounded part matters, because unconstrained rewriting tends to drift away from the original intent. The output is a reusable skill file, which is portable in a way that fine tuned weights are not. Because it is just text, the same optimized skill can be carried across different models and execution environments. The project reports improvements across several benchmarks and target models, and the code and documentation are published openly.

Who is SkillOpt for?

This is for people who are already writing skill or instruction documents for agents and have hit the point where hand tuning them feels like guesswork. If you maintain a library of skills used across a team, SkillOpt offers a measurable loop in place of opinion: change the text, rerun, keep what validates. It also suits researchers comparing prompt level optimization against fine tuning, since it isolates the text as the variable. It is not a consumer tool. You need a task you can evaluate automatically, otherwise the validation step has nothing to check against, and you need enough rollouts for the comparison to mean something. If you have one skill file and no evaluation harness, hand editing is still cheaper.

How does SkillOpt compare?

Find Skills solves the discovery problem rather than the quality problem, helping an agent locate the right skill for a job from a collection. SkillOpt assumes you already know which skill applies and asks whether its wording is any good. Taste Skill is a single opinionated skill document that pushes output away from generic writing, so it is something you install and use, whereas SkillOpt is the machinery you would point at a skill like that to improve it. Claude Mem addresses a different gap again, persisting memory across sessions so an agent stops starting cold. The three are complementary: one finds skills, one is a skill, one remembers, and SkillOpt refines. Only SkillOpt requires you to bring an evaluation set.

Compare with: Find Skills, Taste Skill, Claude Mem

SkillOpt pricing

The catalog records SkillOpt as free. It is an open source project published by Microsoft on GitHub, so there is no license to buy and no account to open. The cost is compute. Optimization works by running the agent repeatedly, reflecting, and validating, and every one of those rollouts is a model call you pay for at your provider. A serious optimization run can therefore cost far more in tokens than the skill document it produces suggests. Start with a small task and a short loop to calibrate the spend.

Notes

No notes have been added for this tool yet.

SkillOpt FAQ

How is this different from fine tuning?
Fine tuning changes model weights and produces an artifact tied to one model. SkillOpt leaves the model untouched and edits the natural language skill document instead. The result is a text file, so it can be read, reviewed in a pull request, and reused with a different model or runtime without retraining anything.
What do I need to run SkillOpt?
A task the agent can attempt repeatedly and a way to score the attempts automatically. The loop depends on running rollouts and validating that an edit improved things, so without a measurable outcome there is nothing to optimize against. You also need model access, since every rollout is an inference call.
Does the optimized skill work with any agent?
The project positions skill files as transferable across models and execution environments, because the output is plain instruction text rather than weights. In practice you should revalidate on the target model. An instruction tuned against one model can be less effective on another, even though nothing stops it loading.
Browse all Open Source