← Back to Skills Marketplace
326
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install skill-to-agent-converter
Description
Convert OpenClaw skills into properly configured agents with correct workspace setup, binding, and orchestration. Solves common agent creation failures (thre...
Usage Guidance
This package is an instruction-only converter that walks you through creating agent workspaces, registering them in OpenClaw's agents.list, and spawning them. Before using it: 1) Note that the SKILL.md and examples reference a script (skill_to_agent.js) that is not included — confirm where that script comes from and inspect it before running. 2) Understand this process modifies system-wide OpenClaw configuration (gateway config.patch and restart) and creates persistent agents; back up your OpenClaw config first. 3) Audit any skill files you copy into agent workspaces — converted agents run with tools like sessions_spawn, read/write, and web_search which can be abused if the skill content is malicious. 4) Limit tool permissions for newly created agents and test conversions in an isolated environment (VM/container) before applying to production. 5) If you need higher assurance, ask the author for the missing script(s) or a signed release and review those files before running the automated steps.
Capability Analysis
Type: OpenClaw Skill
Name: skill-to-agent-converter
Version: 1.0.0
The skill bundle provides instructions and scripts for an AI agent to perform high-privilege system operations, including modifying the OpenClaw core configuration via the `gateway` tool (`config.patch`) and executing shell commands. While these actions are aligned with the stated purpose of converting skills to agents, the inclusion of scripts in `references/war-room-example.md` and `references/troubleshooting.md` that utilize `eval()`, `execSync`, and broad filesystem commands (`rm -rf`, `chmod`) creates a significant risk. These capabilities could be leveraged for unintended system modification or privilege escalation if the agent is prompted to process a malicious skill.
Capability Assessment
Purpose & Capability
The name and description align with the instructions: the SKILL.md describes converting skills into agent workspaces, registering them, and spawning sessions. However, the runtime docs repeatedly reference a script (scripts/skill_to_agent.js and a skill_to_agent.js module) and automation examples that are not present in the package — an inconsistency that needs clarification (either the converter expects external tooling or files are missing).
Instruction Scope
The instructions tell operators/agents to create directories under ~/.openclaw/agents, copy skill files into agent workspaces, write identity/memory/config files, call gateway({ action: 'config.patch' }) to modify system agent configuration, and spawn sessions via sessions_spawn. These actions are exactly what a converter must do, but they also modify system-wide configuration and give created agents runtime/tool access (sessions_spawn, read, write, web_search, etc.). The guidance to 'always set cwd' and to restart the gateway are operationally necessary but increase risk if applied to untrusted skill content.
Install Mechanism
This is an instruction-only skill with no install spec (low disk risk). That said, the documentation and examples expect a local script (skill_to_agent.js) to exist. The absence of that script in the package is inconsistent: either the tool is external or the package is incomplete. No downloadable URLs or third-party installs are present.
Credentials
The registry metadata declares no required env vars or credentials, which is proportional. The docs reference optional env vars (OPENCLAW_AGENTS_DIR, SKILL_TO_AGENT_DEBUG, DEFAULT_AGENT_RUNTIME) and show examples granting tools like sessions_spawn, web_search, read, write. Those tools are powerful; granting them to generated agents is sometimes necessary but significantly increases capability and blast radius and should be limited to trusted agents.
Persistence & Privilege
The skill's workflow requires registering agents in the system-wide agents.list (via gateway config.patch) and restarting the gateway. That creates persistent, autonomous agents with configured tool access and memory directories. While coherent with the converter's purpose, modifying global configuration and enabling new autonomous actors is high privilege — combining this with copying arbitrary skill contents into long-lived workspaces raises the chance of persistent abuse if sources are untrusted. The skill itself is not always:true, but its recommended actions create persistent agents.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install skill-to-agent-converter - After installation, invoke the skill by name or use
/skill-to-agent-converter - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of skill-to-agent, enabling OpenClaw skills to be converted into fully-configured agents.
- Automates workspace setup, agent configuration, and registration to avoid common failures (thread binding errors, workspace isolation, session spawning issues).
- Provides detailed workflow, troubleshooting steps, and quick commands for converting and spawning agents.
- Ensures agents are properly registered and can access required identity and tool files.
- Includes reference documentation and best practices for robust agent creation and management.
Metadata
Frequently Asked Questions
What is Skill to Agent Converter: Convert a Skill into an OpenClaw Agent?
Convert OpenClaw skills into properly configured agents with correct workspace setup, binding, and orchestration. Solves common agent creation failures (thre... It is an AI Agent Skill for Claude Code / OpenClaw, with 326 downloads so far.
How do I install Skill to Agent Converter: Convert a Skill into an OpenClaw Agent?
Run "/install skill-to-agent-converter" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Skill to Agent Converter: Convert a Skill into an OpenClaw Agent free?
Yes, Skill to Agent Converter: Convert a Skill into an OpenClaw Agent is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Skill to Agent Converter: Convert a Skill into an OpenClaw Agent support?
Skill to Agent Converter: Convert a Skill into an OpenClaw Agent is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Skill to Agent Converter: Convert a Skill into an OpenClaw Agent?
It is built and maintained by DraftHead (@drafthead); the current version is v1.0.0.
More Skills