explaingit

microsoft/skillopt

Analysis updated 2026-07-17 · repo last pushed 2026-07-02

10,554PythonAudience · developerComplexity · 3/5ActiveSetup · moderate

TLDR

Trains a compact plain-text 'skill document' that makes an existing AI agent perform tasks better, without fine-tuning or changing the underlying model.

Mindmap

mindmap
  root((skillopt))
    What it does
      Optimizes skill text
      Not model weights
      Scores and edits
    Tech Stack
      Python
      OpenAI
      Claude
      Codex
    Use Cases
      Improve support agents
      Boost benchmark accuracy
      Overnight skill tuning
    Outputs
      best_skill.md
      Web dashboard

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Produce a refined instruction file that boosts a customer-support agent's accuracy without retraining the model.

USE CASE 2

Run SkillOpt-Sleep overnight to consolidate lessons from past sessions into an improved skill document.

USE CASE 3

Optimize a skill document on one model and transfer it to a different backend without retraining.

USE CASE 4

Track training progress across epochs using the built-in web dashboard.

What is it built with?

PythonOpenAIClaudeCodex

How does it compare?

microsoft/skilloptlucidrains/denoising-diffusion-pytorchostris/ai-toolkit
Stars10,55410,55510,545
LanguagePythonPythonPython
Last pushed2026-07-02
MaintenanceActive
Setup difficultymoderatehardhard
Complexity3/54/54/5
Audiencedeveloperresearchervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Requires running the agent through tasks with scoring plus access to a backend model like OpenAI, Claude, or Codex.

License is not stated in the available content.

In plain English

SkillOpt lets you automatically improve how well an AI agent performs tasks, without changing the underlying AI model itself. Instead of rewriting code or fine-tuning a model, it trains a plain-text "skill document", essentially a set of instructions or context that guides the agent. The end result is a compact file (called best_skill.md) that you attach to your existing AI tool to make it noticeably better at its job. The approach borrows the discipline of traditional machine learning training. You run the agent through tasks, score how it did, and a separate "optimizer" model reviews those results and proposes small edits to the skill document, adding, deleting, or replacing lines. An edit only gets accepted if it actually improves the score on a held-out validation set. You repeat this over multiple rounds (called epochs), with a "learning rate" controlling how much the skill text can change per step. The key idea is that the skill document becomes the thing being optimized, not the model's internal weights. This would appeal to teams building AI-powered products who want better performance from models they can't or don't want to modify. For example, if you're using GPT or Claude in a customer-support agent, SkillOpt can produce a refined instruction file that boosts accuracy by 20+ percentage points across various benchmarks. A newer feature called SkillOpt-Sleep can even run overnight, reviewing past sessions and consolidating lessons learned into improved skills. What's notable is the deployable artifact: a small text file, typically 300 to 2,000 tokens, that works with the unchanged target model. The project reports best-or-tied results across 52 combinations of models, benchmarks, and execution environments, and claims that optimized skills transfer between different models and tools without needing retraining. It supports multiple backends including OpenAI, Claude, Codex, and others, and includes a web-based dashboard for monitoring the training process.

Copy-paste prompts

Prompt 1
Walk me through running SkillOpt on my customer-support agent to produce a best_skill.md file.
Prompt 2
Explain how SkillOpt's optimizer model decides which edits to accept into the skill document.
Prompt 3
Help me set up SkillOpt-Sleep to run overnight and consolidate lessons from my agent's past sessions.
Prompt 4
Show me how to attach an optimized skill document to a Claude-based agent without changing the model.
Prompt 5
Compare the learning rate and epoch settings I should use for SkillOpt to avoid overfitting the skill text.

Frequently asked questions

What is skillopt?

Trains a compact plain-text 'skill document' that makes an existing AI agent perform tasks better, without fine-tuning or changing the underlying model.

What language is skillopt written in?

Mainly Python. The stack also includes Python, OpenAI, Claude.

Is skillopt actively maintained?

Active — commit in last 30 days (last push 2026-07-02).

What license does skillopt use?

License is not stated in the available content.

How hard is skillopt to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is skillopt for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.