WOML skill
A skill that teaches an agent to write and repair WOML files: readable markup for durable workflows, backends and AI agents.
- 174 ★ on the repository
- Last commit
Extended access
Why this level
- Workflows call APIs, databases and local tools and the agent gets access to secrets to configure them.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/womlDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Workflows call APIs, databases and local tools and the agent gets access to secrets to configure them.
This is third-party code. Review the repository files before installing.
What it does
WOML is a language and runtime for workflows, backends and AI agents: structure is written as readable HTML-like markup, logic in JavaScript, and execution is handled by a durable runtime with retries, state, waits and recovery. The `woml` skill gives an agent the language syntax, runtime bindings, control-flow patterns, services, secrets and validation procedure so it creates real `.woml` files without inventing syntax. The agent identifies the trigger, input, steps, external systems and expected result, writes the file, validates it with `woml check` and runs `woml run`. Human approvals, branching, loops, parallel work, calls to other workflows and rollback on partial failure are supported. The source lives in Git and goes through pull requests and CI like ordinary code.
Who it is for. Developers of automations and backends who want to describe processes as readable markup and have an agent write the files.
Good fit when
- An order processing flow from a webhook with parallel inventory and risk checks is needed.
- An automation needs human approval with a Telegram notification and a long wait for the answer.
- A `.woml` file fails `woml check` and the agent must find and fix the error.
- A preview environment deployment must roll back and clean up after partial success.
Not a fit when
- You need a visual builder with no text files: WOML is defined as markup in code.
- The project is already built on another orchestration system and migration is not planned.
- You need a platform proven over years: the language and runtime are relatively new.
Example request
Use the WOML skill to build an order-processing workflow that starts from a webhook, checks inventory and risk concurrently and routes the result.Limitations
The skill teaches working with WOML and does not replace the runtime itself: running requires `woml-cli` installed through npm. Workflows can call APIs, databases and local tools, so give the agent only needed secrets and review the allowed services. The repository license is Apache 2.0 but GitHub metadata does not detect it. Installing the skill in Claude Code downloads a release archive and unpacks it into `.claude/skills/woml`, and for Codex the `skills/woml` folder is copied.
How to disable. Delete the `.claude/skills/woml` folder (for Codex `.agents/skills/woml`) and the CLI with `npm uninstall --global woml-cli`. Stop active workflows with runtime commands.
FAQ
How do I install the WOML skill in Claude Code?
Run `mkdir -p .claude/skills/woml` and then `curl -fsSL https://github.com/dali-benothmen/woml/releases/latest/download/woml-skill.tar.gz | tar -xz -C .claude/skills/woml`. The skill appears in the current project.
How do I install the skill for Codex?
For Codex and clients with the Agent Skills convention copy the folder: `cp -R skills/woml .agents/skills/woml`. The source folder lives in the repository.
How do I install WOML itself?
Run `npm install --global woml-cli`. `woml init my-project` starts a project, `woml run order-router.woml` runs a workflow and `woml check` validates a file.
What can the WOML skill do?
It creates, explains, validates and repairs `.woml` files: triggers, steps, embedded JavaScript, context references, control flow, approvals, lifecycle hooks, services, secrets and CLI operations.
Where is workflow state stored?
The runtime keeps durable state: attempts, decisions, waits and execution history are saved and survive process restarts. Runs can be inspected, cancelled and recovered.
Discussion
No questions or reviews yet.
Related
SkillsOpen Dynamic Workflow turns repeatable agent tasks into validated scripts for Codex, Gemini, Cursor and other agent CLIs.
Skills for coding agents that build and verify workspaces on the Lemma platform, with their agents and apps
A Codex plugin and MCP bridge to an app that records your computer work and turns it into a graph of steps for an agent
A language and runtime for skills an agent writes and a human approves: execution through allowlisted connectors and signatures
Workflow manager CLI: scripts, secrets and automation of many projects behind one interface, plus an MCP server for agents.
Turns one run of a task into a program an agent calls as a single tool, checking the record before and after the save
README in short
The language describes triggers, steps, branches and policies as readable markup, logic is written in JavaScript or TypeScript and the runtime executes with retries and history.