← Back to Skills Marketplace
trypto1019

Free Worker Dispatch

by ArcSelf · GitHub ↗ · v1.1.0
darwinlinux ⚠ suspicious
906
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install arc-free-worker-dispatch
Description
Route tasks to free AI models via OpenRouter to save money. Use when the agent needs to delegate content writing, research, code generation, or other tasks t...
README (SKILL.md)

Free Worker Dispatch

Delegate tasks to free AI models via OpenRouter. Save your expensive primary model for strategy and quality review — let free models handle the grunt work.

Why This Exists

Running everything through Claude Opus or GPT-4 costs real money. Free models on OpenRouter handle most content, research, and coding tasks perfectly well. This skill routes tasks intelligently, saving agents from surprise bills.

Available Free Models

Model Best For Context
stepfun/step-3.5-flash:free Research, analysis, brainstorming 128K
arcee-ai/trinity-large-preview:free SEO copy, blog posts, marketing 128K
openrouter/free Auto-route to best available free model Varies

Commands

Dispatch a task to a free model

python3 {baseDir}/scripts/dispatch.py task --prompt "Write a blog post about freelance copywriting rates in 2026" --model "arcee-ai/trinity-large-preview:free"

Dispatch with auto-model selection

python3 {baseDir}/scripts/dispatch.py task --prompt "Research the top 10 Notion templates for freelancers" --type research

List available free models

python3 {baseDir}/scripts/dispatch.py models

Check model status (is it up?)

python3 {baseDir}/scripts/dispatch.py status --model "stepfun/step-3.5-flash:free"

Dispatch with output to file

python3 {baseDir}/scripts/dispatch.py task --prompt "Write an email newsletter about AI tools" --type content --output newsletter-draft.md

Batch dispatch (multiple tasks)

python3 {baseDir}/scripts/dispatch.py batch --file tasks.json

The tasks.json format:

[
  {"prompt": "Write a product description", "type": "content"},
  {"prompt": "Research competitor pricing", "type": "research"},
  {"prompt": "Generate a Python script for...", "type": "code"}
]

Task Types

The --type flag auto-selects the best free model:

Type Model Why
research stepfun/step-3.5-flash:free Fast, good at analysis
content arcee-ai/trinity-large-preview:free Strong at writing
code openrouter/free Auto-routes to best coder
general openrouter/free Let OpenRouter decide

Output

Results are printed to stdout by default. Use --output \x3Cfile> to save to a file. Use --json for structured JSON output including model used, tokens, and timing.

Tips

  • Always review worker output before publishing — free models hallucinate
  • Use --type for best model matching instead of specifying models directly
  • Batch dispatch is faster for multiple independent tasks
  • If a model is down, the script falls back to openrouter/free
Usage Guidance
This skill appears coherent and limited in scope, but before installing: (1) Understand that your OPENROUTER_API_KEY will be sent to openrouter.ai (this is necessary for the tool to function) — only provide a key you trust to share with that service. (2) Review the model list and MODEL_MAP in the script vs the README if you rely on specific models (there are minor mismatches). (3) The script will write output files but refuses sensitive paths; still double-check any output file names you provide. (4) Because free models can hallucinate, always review model output before publishing. (5) If you are concerned about key leakage, create/limit a dedicated OpenRouter key and rotate it if needed.
Capability Analysis
Type: OpenClaw Skill Name: arc-free-worker-dispatch Version: 1.1.0 The `scripts/dispatch.py` file contains a Local File Read (LFR) vulnerability. The `cmd_batch` function, when invoked with the `--file` argument, reads the content of the specified file without any path validation. This allows an attacker to read arbitrary local files (provided they are valid JSON) and have their content processed as tasks, potentially leading to information disclosure via stdout or a user-specified output file. While the script includes robust path validation for *output* files, it lacks similar checks for *input* files, making it a significant vulnerability rather than intentional malice.
Capability Assessment
Purpose & Capability
The name/description (route tasks to free models via OpenRouter) matches the actual requirements (python3 and OPENROUTER_API_KEY) and the script calls openrouter.ai. No unrelated cloud credentials or unrelated binaries are requested.
Instruction Scope
Runtime instructions tell the agent to run the included Python script and use the OPENROUTER_API_KEY. The script only reads provided prompts/tasks and optional output paths; it does not enumerate or exfiltrate other system files. Minor doc/code mismatches: SKILL.md and the script differ slightly in the model table and the SKILL.md suggests general auto-routing while the script's MODEL_MAP differs for some types. The script prints an error suggesting 'credentials.txt' as an alternative place to set the key, but there is no code that reads credentials.txt.
Install Mechanism
No install spec is provided (instruction-only with a single Python script). That is low-risk: nothing is downloaded or written to disk during installation beyond what the user runs.
Credentials
Only OPENROUTER_API_KEY (and python3) are required, which is proportional for a tool that calls OpenRouter. The script does not request other secrets or config paths and includes checks to prevent writing to common sensitive paths (e.g., .ssh, .aws, .env).
Persistence & Privilege
The skill is not always-enabled and is user-invocable. It does not modify other skills or system configuration. It can be invoked autonomously only per platform default, which is expected for skills.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install arc-free-worker-dispatch
  3. After installation, invoke the skill by name or use /arc-free-worker-dispatch
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
- Added new batch dispatch functionality via the scripts/dispatch.py batch command, enabling processing of multiple tasks from a file. - Provided sample tasks.json format and usage instructions in documentation. - Updated help and tips to mention improved batch dispatch support.
v1.0.1
arc-free-worker-dispatch 1.0.1 - Updated scripts/dispatch.py (details not shown here). - No changes to functionality or documentation.
v1.0.0
- Initial release of free-worker-dispatch skill. - Enables routing tasks to free AI models via OpenRouter to reduce API costs. - Supports dispatching content writing, research, code generation, and more to selected or auto-selected free models. - Includes commands for task dispatch, model listing, model status checking, batch processing, and flexible output options. - Auto-selects best free model based on task type, with fallback if a model is unavailable. - Helps avoid unexpected API bills by offloading most tasks from expensive models to free alternatives.
Metadata
Slug arc-free-worker-dispatch
Version 1.1.0
License
All-time Installs 0
Active Installs 0
Total Versions 3
Frequently Asked Questions

What is Free Worker Dispatch?

Route tasks to free AI models via OpenRouter to save money. Use when the agent needs to delegate content writing, research, code generation, or other tasks t... It is an AI Agent Skill for Claude Code / OpenClaw, with 906 downloads so far.

How do I install Free Worker Dispatch?

Run "/install arc-free-worker-dispatch" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Free Worker Dispatch free?

Yes, Free Worker Dispatch is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Free Worker Dispatch support?

Free Worker Dispatch is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin, linux).

Who created Free Worker Dispatch?

It is built and maintained by ArcSelf (@trypto1019); the current version is v1.1.0.

💬 Comments