generate-openenv-env

Generate OpenEnv reinforcement learning environments from a use-case description.

2.5k|432|Updated Oct 1, 2025
One-click install
npx skills add https://github.com/meta-pytorch/OpenEnv --skill generate-openenv-env
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: generate-openenv-env
Source: https://github.com/meta-pytorch/OpenEnv/tree/main/.claude/skills/generate-openenv-env
Command: npx skills add https://github.com/meta-pytorch/OpenEnv --skill generate-openenv-env

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

Building a new OpenEnv environment requires researching a target library's API, choosing the right architecture, scaffolding files, and validating the result. This Skill automates that end-to-end workflow so a use case like "wrap the textarena library" becomes a complete, validated environment under envs/.

Core Features & Use Cases

  • Guided Environment Generation: Researches the target library, mines existing OpenEnv examples as templates, asks focused design questions, and scaffolds models, client, server, and openenv.yaml files.
  • Architecture Selection: Chooses between typed step/reset environments (EnvClient), MCP tool environments, or specialized client flows based on the use case.
  • Built-in Validation: Runs openenv build, openenv validate, import checks, and smoke tests before handoff, reporting assumptions and remaining risks.
  • Use Case: Ask it to "generate an env for the library textarena" and receive a production-ready envs/textarena_env/ with typed models, FastAPI server, Dockerfile, and passing validation.

Quick Start

Ask the agent to generate an OpenEnv environment for a specific library or API, for example by saying "generate an env for the library textarena".

Frequently Asked Questions about generate-openenv-env

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new OpenEnv environment for an external library?

Invoke the skill with a use case like "generate an env for the library textarena". It researches the target library's API, picks matching example environments as templates, scaffolds the envs/<name>_env/ directory, and implements models, client, server, and openenv.yaml.

What files does an OpenEnv environment scaffold include?

The scaffold includes models.py, client.py, openenv.yaml, pyproject.toml, and a server/ directory with app.py, the environment implementation, and a Dockerfile. The openenv init CLI generates these with placeholders replaced, or they can be created manually from the template.

When should I use an MCP tool environment instead of a typed step/reset environment?

Use an MCP tool environment with MCPEnvironment and MCPToolClient when the use case centers on tool-calling interfaces rather than classic RL step/reset loops. The default typed EnvClient archetype fits most gym-style wrappers; specialized clients are only for cases standard clients cannot express.

How do I validate a generated OpenEnv environment before deployment?

Run openenv build and openenv validate --verbose from the environment directory, plus an import check with PYTHONPATH=src:envs. If no tests exist, start the uvicorn server and check the /health endpoint or run openenv validate --url against it.

Can this skill be used for model training or evaluation workflows?

No. The skill explicitly excludes training and evaluation tasks and only covers environment design and implementation. Its guardrails prevent routing into model training workflows and focus solely on building validated environment scaffolds.