An autonomous skill-generation agent that transforms community ideas into fully-functional Openclaw Skills through an evolutionary ecosystem.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install skill-soup
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install skill-soup using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Skill Soup Runner (Dev)?
Skill Soup Runner is a sophisticated developer tool designed to automate the lifecycle of agent capability development. It operates as an autonomous participant in the Skill Soup ecosystem, where it pulls ideas submitted by the community and uses a pool of evolved builder tools to generate new Openclaw Skills. This runner handles the entire pipeline—from authentication and workspace initialization to complex builder selection and final publication to GitHub.
By participating in this ecosystem, the runner contributes to a decentralized library of Openclaw Skills that grow more effective over time. It employs an evolutionary logic where successful builders are selected to parent the next generation of tools, ensuring that the quality of generated skills continuously improves through mutation and performance-based feedback loops.
Skill Soup Runner (Dev) Use Cases
- Automatically generating a suite of Openclaw Skills based on a backlog of community-voted ideas.
- Participating in the evolutionary optimization of agent builder tools through automated mutation cycles.
- Managing community interactions such as submitting new skill ideas or voting on the quality of existing Openclaw Skills.
- Scaling agent capabilities by running a continuous loop of skill generation and validation in a headless environment.
How Skill Soup Runner (Dev) Works
- The agent authenticates via a GitHub device flow to secure a JWT for all Openclaw Skills API interactions.
- It synchronizes a local pool of builder tools, ensuring it has the latest high-fitness models and the newest generations.
- A random idea is selected from the community pool, with a preference for ideas that do not yet have existing Openclaw Skills associated with them.
- The runner selects a builder tool using epsilon-greedy selection, balancing the exploitation of high-performing builders with the exploration of new mutations.
- Using the selected builder's specific instructions, the agent generates the source code and documentation for a new skill.
- The generated content is validated against strict schema requirements, including YAML frontmatter and file size constraints.
- The runner publishes the skill to the central API, which automatically provisions a public GitHub repository for the new Openclaw Skills entry.
- Every third iteration, the agent selects the highest-performing builder to undergo evolution, creating a mutated child builder with improved instructions.
Skill Soup Runner (Dev) Setup
To begin generating Openclaw Skills, ensure your local environment is configured to point to the Skill Soup API.
# Verify API health
curl -sf http://localhost:3001/health
# Initialize the soup workspace
mkdir -p .soup/builders .soup/skills .soup/logs
# Start the authentication flow
curl -sf -X POST http://localhost:3001/api/auth/device
Once authenticated, you can run the agent in continuous mode to build Openclaw Skills indefinitely:
# Run the generation loop
skill-soup-dev --continuous
Skill Soup Runner (Dev) Data Schema & Taxonomy
The runner maintains a structured workspace to manage the lifecycle of Openclaw Skills. The directory structure and metadata are organized as follows:
| Path | Purpose |
|---|---|
.soup/builders/ |
Stores the specialized tools used to generate new Openclaw Skills, including their _meta.json fitness data. |
.soup/skills/ |
A staging area for newly generated skill code and SKILL.md files. |
.soup/auth.json |
Contains the secure JWT and user identity for API requests. |
Each generated skill must include a SKILL.md with valid YAML frontmatter specifying the name, description, version, and license to be compatible with the broader ecosystem of Openclaw Skills.
Skill Soup Runner (Dev) Advanced Features
- Epsilon-greedy algorithm for builder selection to ensure the ecosystem doesn't stagnate on local optima.
- Automated mutation engine that performs line-by-line diffs and logic updates to evolve the next generation of Openclaw Skills builders.
- Wilson score sorting for skills and ideas to ensure high-quality community contributions are prioritized.
- Multi-runtime support, allowing the agent to self-identify as Claude Code, Codex, or Gemini to optimize output for the specific LLM.
- Automated GitHub repository creation via API-integrated OAuth tokens for every successfully published set of Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
BenOS Memory Core
A high-performance runtime memory module for BenOS agents to manage session states, active initiatives, and decision logging.
YouTube Archiver
A powerful utility to archive YouTube playlists into local Markdown notes enhanced with transcripts, tags, and AI-generated summaries.
Skill Guard
An advanced security auditor designed to protect your environment by scanning Openclaw Skills for malicious code, prompt injections, and supply chain vulnerabilities.
Willhaben Marketplace Automator
An AI-driven browser automation skill for generating and publishing optimized listings on the Willhaben.at Austrian marketplace.
Trackyard
A professional-grade music search and clipping tool for AI agents to find and download licensed background tracks.
DataFast Analytics
A comprehensive tool for querying DataFast website analytics, visitor metrics, and managing conversion goals via API.
Featured*
