Agent skill

Migrate Osworld Agent

by xlang-ai in xlang-ai/OSWorld-V2

Migrate an agent from upstream OSWorld into this OSWorld-V2 repository, add matching evaluation entrypoints, and verify the integration.

Apache-2.0Auto-check passedProductivity & Automation

Install Migrate Osworld Agent

skills CLI
$ npx skills add xlang-ai/OSWorld-V2 --skill migrate-osworld-agent -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install xlang-ai/OSWorld-V2 migrate-osworld-agent --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/xlang-ai/OSWorld-V2.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.codex/skills/migrate-osworld-agent .claude/skills/migrate-osworld-agent && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
migrate-osworld-agent
GitHub stars
359
Used in
1 other repo
Token cost
~546 tokens
SKILL.md length
274 words
Files
1
Skills in repo
4
Repo updated
First seen
Licence
Apache-2.0

At a glance

Migrate an agent from upstream OSWorld into this OSWorld-V2 repository, add matching evaluation entrypoints, and verify the integration.

  • Works in 7 steps: Read the upstream agent. → Read local patterns before editing → Copy the agent into mm_agents/ with a… → …
  • Productivity & Automation work in your project
  • SKILL.md covers Workflow and Verify
  • Calls uv

What it does

Migrate Osworld Agent is an agent skill from xlang-ai/OSWorld-V2. Migrate an agent from upstream OSWorld into this OSWorld-V2 repository, add matching evaluation entrypoints, and verify the integration.

Its SKILL.md is about 550 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Productivity & Automation. It works with Python. The repository describes itself as: OSWorld 2.0: Benchmarking Computer Use Agents on Long-Horizon Real-World Tasks. The licence is Apache-2.0.

When your agent uses it

  • Productivity & Automation work in your project

Example prompts

  • “/migrate-osworld-agent”

Requirements

  • Python 3

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Read the upstream agent.
  2. Read local patterns before editing
  3. Copy the agent into mm_agents/ with a clear, non-conflicting name.
  4. Adapt only the repo-facing interfaces
  5. Add a matching multi-env Python runner under scripts/python/run_multienv_.py.
  6. Add a small shell entrypoint under scripts/bash/.
  7. Keep unrelated agents, scripts, results, and local dirty files out of the change.

What it can do on your machine

Read from SKILL.md and the folder at commit acdd349. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • uv

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Migrate Osworld Agent loads about 546 tokens when it runs. Until then it costs about 40 tokens; SKILL.md has 274 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~40
When it runs · the whole SKILL.md, loaded when a task matches
~546

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from xlang-ai/OSWorld-V2 at commit acdd349, republished under its Apache-2.0 licence (© xlang-ai). 274 words, ~546 tokens.

Download SKILL.mdSave it as .claude/skills/migrate-osworld-agent/SKILL.md (or your agent's skills folder).
name
migrate-osworld-agent
description
Migrate an agent from upstream OSWorld into this OSWorld-V2 repository, add matching evaluation entrypoints, and verify the integration.

Migrate OSWorld Agent

Use this when adding an upstream OSWorld agent to this repo.

Workflow

  1. Read the upstream agent.
  2. Read local patterns before editing:
    • use scripts/python/run_multienv_claude.py as the main runner reference
    • use scripts/bash/run_multienv_claude.sh as the shell entrypoint reference
    • if a similar local agent exists, use it only for interface shape
    • if none exists, derive the interface from the runner and DesktopEnv
  3. Copy the agent into mm_agents/ with a clear, non-conflicting name.
  4. Adapt only the repo-facing interfaces:
    • predict() return shape
    • action dict fields consumed by DesktopEnv.step()
    • ASK_USER turns and follow-up user responses
    • done/fail markers
    • task current date
    • platform, screen, provider, and password settings
  5. Add a matching multi-env Python runner under scripts/python/run_multienv_<agent>.py.
    • start from the closest retained runner structure
    • keep task loading, env recreation, checkpoint args, logs, and cleanup behavior
    • remove provider/model checks that only apply to the source runner
  6. Add a small shell entrypoint under scripts/bash/.
    • use uv run
  7. Keep unrelated agents, scripts, results, and local dirty files out of the change.

Verify

Run fast checks first.

  • Compile the new Python files.
  • Check shell syntax.
  • Check staged diff for whitespace.
  • Run local fake tests for:
    • action parsing
    • ASK_USER
    • user response returning to the agent
    • checkpoint argument parsing if touched

Then run one small real smoke test.

  • Use the intended provider.
  • Use a tiny step limit.
  • Prefer public IP for cloud providers when the local machine cannot reach private IPs.
  • Confirm the model call happens.
  • Confirm at least one environment action executes.
  • Confirm result files and trajectory are written.
  • Confirm cloud resources are cleaned up.

Before opening a PR, stage only the migration files and re-run the fast checks.

© xlang-ai, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .codex/skills/migrate-osworld-agent of xlang-ai/OSWorld-V2.

Open the folder on GitHubat commit acdd349

Used in 1 other repository

We found 3 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in xlang-ai/OSWorld-V2, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Migrate Osworld Agent next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Migrate Osworld Agent compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Migrate Osworld Agent this skillxlang-ai/OSWorld-V23591 repos~546Automated safety check: PassApache-2.0
Process Inboxtelegramdesktop/tdesktop33k1 repos~5.4kAutomated safety check: PassGPL-3.0
Process InboxTDesktop-x64/tdesktop3k—~4.3kAutomated safety check: PassGPL-3.0
Telegrambubbuild/bub1.7k—~2.2kAutomated safety check: PassApache-2.0
Browser Use Terminalbrowser-use/terminal650—~2.1kAutomated safety check: PassMIT
Robocorp Automationrobocorp/robocorp653—~3.3kAutomated safety check: PassApache-2.0

Similar skills

  • Process Inbox

    telegramdesktop/tdesktop

    Process the local ignored ai-tdesktop inbox into durable, independently testable Telegram Desktop task records while task execution worktrees remain active.

    33k GitHub starsUsed in 1 repo~5.4k tokens
    Productivity & AutomationAuto-check passed
  • Process Inbox

    TDesktop-x64/tdesktop

    Process the local ignored ai-tdesktop inbox into durable, independently testable Telegram Desktop task records while task execution worktrees remain active.

    3k GitHub stars~4.3k tokensUpdated 19 days ago
    Productivity & AutomationAuto-check passed
  • Telegram

    bubbuild/bub

    Telegram Bot skill for sending and editing Telegram messages via Bot API.

    1.7k GitHub stars~2.2k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Browser Use Terminal

    browser-use/terminal

    Direct browser control via the Browser Use Terminal CLI. An agent skill from browser-use/terminal.

    650 GitHub stars~2.1k tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed
  • Robocorp Automation

    robocorp/robocorp

    Bootstrap from an empty folder or build, debug, locally run, and validate Python automations built with Robocorp or Sema4.ai tooling, robocorp.tasks, rcc, robocorp-browser, and RPA Framework.

    653 GitHub stars~3.3k tokensUpdated 2 days ago
    Productivity & AutomationAuto-check passed
  • Cron Ops

    czl9707/build-your-own-openclaw

    Create, list, and delete scheduled cron jobs. An agent skill from czl9707/build-your-own-openclaw.

    1.9k GitHub stars~593 tokensUpdated 3 mo ago
    Productivity & AutomationAuto-check passed

More from xlang-ai/OSWorld-V2

  • Setup Osworld

    xlang-ai/OSWorld-V2

    Provision and verify an OSWorld-V2 checkout after clone. An agent skill from xlang-ai/OSWorld-V2.

    359 GitHub starsUsed in 1 repo~2.6k tokens
    Auto-check: notes
  • Analyze Traj

    xlang-ai/OSWorld-V2

    Analyze OSWorld-V2 agent trajectory logs and task results to produce actionable insights.

    359 GitHub starsUsed in 1 repo~298 tokens
    Auto-check passed
  • Analyze Task

    xlang-ai/OSWorld-V2

    Check OSWorld tasks. An agent skill from xlang-ai/OSWorld-V2.

    359 GitHub starsUsed in 1 repo~223 tokens
    Auto-check passed

Works with

Questions about Migrate Osworld Agent

What does Migrate Osworld Agent do?

Migrate an agent from upstream OSWorld into this OSWorld-V2 repository, add matching evaluation entrypoints, and verify the integration. Migrate Osworld Agent is an agent skill from xlang-ai/OSWorld-V2. Migrate an agent from upstream OSWorld into this OSWorld-V2 repository, add matching evaluation entrypoints, and verify the integration.

When should I use Migrate Osworld Agent?

Migrate Osworld Agent fits situations like: productivity & Automation work in your project.

How do I install Migrate Osworld Agent in Claude Code?

Run `npx skills add xlang-ai/OSWorld-V2 --skill migrate-osworld-agent -a claude-code`. Or copy the skill folder (.codex/skills/migrate-osworld-agent in xlang-ai/OSWorld-V2) into .claude/skills/migrate-osworld-agent in your project. Claude Code loads it when a task matches its description.

How do I install Migrate Osworld Agent in Codex?

Run `npx skills add xlang-ai/OSWorld-V2 --skill migrate-osworld-agent -a codex`. Or copy the skill folder (.codex/skills/migrate-osworld-agent in xlang-ai/OSWorld-V2) into .agents/skills/migrate-osworld-agent in your project. Codex loads it when a task matches its description.

Can I use Migrate Osworld Agent in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add xlang-ai/OSWorld-V2 --skill migrate-osworld-agent -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/migrate-osworld-agent, .gemini/skills/migrate-osworld-agent, .github/skills/migrate-osworld-agent and .opencode/skills/migrate-osworld-agent in your project.

What does Migrate Osworld Agent need to run?

Going by SKILL.md and its folder, Migrate Osworld Agent needs the command-line tools its instructions call (uv). Our summary lists: Python 3.

Does Migrate Osworld Agent access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Migrate Osworld Agent safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Migrate Osworld Agent use?

Migrate Osworld Agent is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Migrate Osworld Agent use?

About 546 tokens (SKILL.md is roughly 2.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Migrate Osworld Agent?

Skills that share tags, products or a category with Migrate Osworld Agent: Process Inbox (telegramdesktop/tdesktop, 33k stars), Process Inbox (TDesktop-x64/tdesktop, 3k stars), Telegram (bubbuild/bub, 1.7k stars) and Browser Use Terminal (browser-use/terminal, 650 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Migrate Osworld Agent?

xlang-ai (a GitHub organization) maintains it in xlang-ai/OSWorld-V2, which has 359 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on October 1, 2026.

Source: xlang-ai/OSWorld-V2 on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.