Skip to main content
Microsoft SkillOpt: Agent skills transfer between Codex and Claude, illustrated with interconnected neural networks.

Editorial illustration for Microsoft's SkillOpt Shows Agent Skills Transfer Between Codex and Claude

SkillOpt Transfers Agent Skills Between Codex, Claude

4 min read

A team from Microsoft, Shanghai Jiao Tong University, Tongji University, and Fudan University has published a method called SkillOpt that treats agent instructions as a single tunable document rather than a fixed prompt. The target model itself never gets retrained. Instead, an optimizer model reads scored rollouts and proposes bounded edits, additions, deletions, replacements, to a natural-language skill file.

A held-out split decides whether each edit sticks: it only survives if the score strictly improves. The end product is one exported file, best_skill.md, meant to travel.

The interesting question isn't whether SkillOpt beats a no-skill baseline in-domain. It's what happens when that trained skill file gets moved somewhere else entirely, a smaller model, a different harness, without any further optimization. The paper's transfer tables track exactly this: baseline score, direct in-domain score, and transferred score, then ask how much of the direct gain survives the jump.

Cross-model results within the GPT-5.4 family already show that retention is uneven, ranging from near-total on SpreadsheetBench to weak on GPT-5.4-nano. But the harder test, and the one the researchers treat as their strongest evidence, is what happens when the skill file moves not just across model sizes but across agent harnesses entirely.

A skill optimized inside Codex lifted Claude Code from 22.1 to 81.8. That slightly exceeds the 80.4 Claude Code reached by training its own skill from scratch.

Why this matters

The 10% retention number on Codex-to-Claude transfer is the real headline here, not the fact that transfer happens at all. Anyone building agent tooling has assumed skill documents were roughly portable across harnesses. SkillOpt's results suggest that assumption only holds for the boring parts: checklist behavior, formatting rules, verification steps.

The reasoning-heavy instructions, the stuff we'd actually want to reuse, seem to bind tightly to whatever model and environment produced them. That's a useful warning for teams treating prompt or skill libraries as portable assets across model swaps. If you're maintaining a Claude-tuned skill file and moving to Codex, or vice versa, expect to redo the reasoning scaffolding even if the procedural boilerplate survives.

For researchers, the single-file best_skill.md format and the frozen-model, held-out-selection setup are worth studying as a clean way to separate what's learned from what's memorized to a specific harness. For founders selling "portable agent skills" as a feature, this paper is a good reason to ask exactly which 10% they mean.

Common Questions Answered

What is SkillOpt and how does it optimize agent instructions differently from traditional methods?

SkillOpt is a method developed by Microsoft and partner universities that treats agent instructions as a single tunable document rather than a fixed prompt, without retraining the target model itself. Instead, an optimizer model reads scored rollouts and proposes bounded edits, additions, deletions, and replacements to a natural-language skill file, with a held-out split determining whether each edit is retained based on performance scores.

How much did SkillOpt improve Claude Code's performance when transferring skills optimized in Codex?

A skill optimized inside Codex lifted Claude Code's performance from 22.1 to 81.8, which slightly exceeds the 80.4 score that Claude Code achieved by training its own skill from scratch. This demonstrates significant cross-model skill transfer capability between different AI systems.

What is the 10% retention rate and why does it matter for agent skill transfer?

The 10% retention rate refers to how much of the optimized skills from Codex successfully transfer to Claude when moving between different models. This low retention rate reveals that while basic portable elements like checklist behavior and formatting rules transfer well, reasoning-heavy instructions bind tightly to specific models and environments, making true skill reusability more limited than previously assumed.

Which institutions collaborated with Microsoft on the SkillOpt research?

Microsoft partnered with Shanghai Jiao Tong University, Tongji University, and Fudan University to develop and publish the SkillOpt method. This multi-institutional collaboration brought together expertise from leading research organizations in developing the skill optimization technique.

LIVE03:20Microsoft's SkillOpt Shows Agent Skills Transfer Between Codex and Claude