Microsoft’s SkillOpt Shows Optimized Agent Skill Artifacts Transfer Across Model Scales and Between Codex and Claude Code Harnesses

Disclosure: Some links in this article are affiliate links. AI Maestro may earn a commission if you make a purchase, at no…

By Vane August 6, 2026 4 min read
Microsoft’s SkillOpt Shows Optimized Agent Skill Artifacts Transfer Across Model Scales and Between Codex and Claude Code Harnesses

SkillOpt is a text-space optimizer developed by researchers from Microsoft, Shanghai Jiao Tong University, Tongji University, and Fudan University.

The tool trains a single natural-language skill document while the target model stays frozen. An optimizer model reads scored rollouts and proposes bounded add, delete, or replace edits. A held-out selection split accepts an edit only when the score strictly improves. The exported artifact is one file, best_skill.md.

Transfer tables report three columns. Baseline is the target’s no-skill score. Direct is SkillOpt trained in-domain on that exact target. Transferred applies a skill trained elsewhere, with no further optimization.

The useful comparison is not transferred versus direct. It is how much of the in-domain gain survives the move.

Cross-model transfer within family shows mixed retention

Skills were trained on GPT-5.4 and deployed on smaller variants.

SpreadsheetBenchGPT-5.4-mini36.147.545.5+9.482%
SpreadsheetBenchGPT-5.4-nano23.542.526.5+3.016%
LiveMathGPT-5.4-mini14.732.819.2+4.525%
LiveMathGPT-5.4-nano23.227.228.8+5.6140%

Two rows deserve attention. SpreadsheetBench on GPT-5.4-mini keeps 82% of the in-domain gain. That is close to free reuse. The LiveMath row on GPT-5.4-nano is stranger: the transferred skill scores 28.8 against an in-domain SkillOpt result of 27.2. The paper reads this as evidence that some learned procedures are target-model agnostic.

The GPT-5.4-nano SpreadsheetBench row is the weak one at 16%. Retention is not uniform, and the paper does not claim it is. Its stated bound is narrower: no row falls below the target’s no-skill baseline.

Note the scope. All four rows stay inside one GPT family. Cross-family transfer, such as GPT to Qwen, is not tested.

Cross-harness transfer delivers the strongest result

This is the section that matters most for deployment. All rows use GPT-5.5.

BenchmarkSource → TargetBaselineDirectTransferredGainShare of in-domain gain
SpreadsheetBenchCodex → Claude Code22.180.481.8+59.7102%
SpreadsheetBenchClaude Code → Codex27.585.071.1+43.676%
LiveMathClaude Code → Codex35.278.448.0+12.830%
LiveMathCodex → Claude Code40.856.542.4+1.610%

The first row is the headline. 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.

The two harnesses expose different tool and file APIs and different command surfaces. A skill that survives that shift is not encoding command recipes. The research paper attributes SpreadsheetBench’s portability to workbook-level procedures: structure-first inspection, formula-aware verification, and static-value materialization. Those hold regardless of which CLI runs the Python.

LiveMath tells the opposite story. Codex → Claude Code retains only 10% of the in-domain gain. The asymmetry is worth sitting with. Procedural skills — how to inspect, verify, and format — appear to be the portable class. Reasoning-heavy skills appear more tied to their training environment.

Cross-benchmark transfer is real but small

Source → TargetModelBaselineTransferredGain
OlympiadBenchOmni-MATHGPT-5.456.660.3+3.7
OlympiadBench → Omni-MATHGPT-5.4-mini34.836.6+1.8
OlympiadBench → Omni-MATHGPT-5.4-nano38.840.1+1.3

There is no Direct column here. No in-domain SkillOpt run on Omni-MATH is reported, so the comparison is against no-skill only. Gains are positive across all three model scales but small. The research paper’s reading is that the skill retained reusable mathematical procedure after both the test instances and the answer-format conventions changed.

The artifact moves because of a shared contract

The mechanism is stated plainly in the research paper. All three execution modes: direct chat, Codex, Claude Code – consume the same best_skill.md file format. That shared contract is what makes the cross-harness experiment possible in the first place.

The Codex harness renders the current skill to a per-task SKILL.md alongside task files, then reads back a compact execution trace. The Claude Code harness mirrors the same workspace contract through the claude CLI. Neither harness gets a bespoke skill format.

The artifact’s shape supports portability too. Final skills run 379 to 1,995 tokens across the six benchmarks, with a median near 920. They are assembled from 1 to 4 accepted edits. The paper’s Figure 4 samples one learned rule per benchmark, and all are procedural rather than instance-specific. The SpreadsheetBench rule, verbatim: inspect workbook structure and formulas, then write evaluated static values across the full requested target range instead of relying on Excel recalculation.

Cost is paid once, offline, and measured

Training cost is paid once, offline, and measured. The research paper reports 0.6M to 46.4M training tokens per absolute test point, depending on benchmark. SpreadsheetBench sits at 0.6M per point; DocVQA at 46.4M. The optimizer model runs only during training and adds zero inference-time calls at deployment.

If a skill trained in one harness holds up in another, that one-time cost spreads across environments. The Codex → Claude Code SpreadsheetBench result is the existence proof. It also implies you can optimize where tooling is cheapest and deploy where the product lives.

The audit angle is separate and underrated. The deployed artifact is a text file a domain practitioner can read in minutes. Every change to it is traceable: each step records an edit_apply_report.json with per-edit accept and skip status. Portability plus inspectability is a different operational posture than shipping fine-tuned weights.

What it means for builders

Developers do not need to retrain models for every new environment. A skill file created for Codex works in Claude Code. This allows teams to build capabilities in the most efficient tooling and ship them to the actual product environment. The result is a single text file that is readable by humans and traceable by code.

Evidence covers one GPT family and two benchmarks per axis, so portability is demonstrated, not yet generalized.

A Codex-trained SpreadsheetBench skill scored 81.8 inside Claude Code, above that harness’s own 80.4 in-domain result.

All 4 cross-model, 4 cross-harness, and 3 cross-benchmark transfer rows land above the target’s no-skill baseline.

Scroll to Top