Agent skill

Freetoken Bots

by limin112 in limin112/min-skill

Discover, verify, and maintain zero-priced OpenRouter models for Pi child-agent workflows used by Muse, Grokbot, or Dot.

No licenceAuto-check passedAI & LLM Engineering

Install Freetoken Bots

skills CLI
$ npx skills add limin112/min-skill --skill freetoken-bots -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install limin112/min-skill freetoken-bots --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/limin112/min-skill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/FreeToken-Bots .claude/skills/freetoken-bots && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
freetoken-bots
GitHub stars
412
Token cost
~1.3k tokens
SKILL.md length
648 words
Files
7 (incl. scripts)
Skills in repo
4
Repo updated
First seen
Licence
None found

At a glance

Discover, verify, and maintain zero-priced OpenRouter models for Pi child-agent workflows used by Muse, Grokbot, or Dot.

  • Works in 7 steps: Check command -v pi, pi --version,… → Scan. Resolve model parameter counts… → Probe a plain chat completion and a… → …
  • Free-model discovery
  • SKILL.md covers Principles, Usage, Pi integration workflow and Scheduling (required, not…, plus 1 more section
  • Runs Python scripts from its folder; calls python3; needs OPENROUTER_API_KEY

What it does

Freetoken Bots is an agent skill from limin112/min-skill. Discover, verify, and maintain zero-priced OpenRouter models for Pi child-agent workflows used by Muse, Grokbot, or Dot. Use for free-model discovery, quota-safe Pi fallback, model recommendations, and daily health checks.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including scripts (for example `README.md`, `scripts/radar.py` and `tests/test_radar.py`).

It sits in AI & LLM Engineering, covering Model routing and gateways. It works with OpenRouter.

When your agent uses it

  • Free-model discovery
  • Quota-safe Pi fallback
  • Model recommendations
  • Daily health checks

Example prompts

  • “/freetoken-bots”

Requirements

  • Python 3
  • A credential in OPENROUTER_API_KEY

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Check command -v pi, pi --version, ~/.pi/agent/settings.json, ~/.pi/agent/models.json, and pi --list-models without disclosing keys.
  2. Scan. Resolve model parameter counts from trustworthy model/provider documentation. Only move independently verified ≥100B entries into…
  3. Probe a plain chat completion and a separate real tools call; distinguish 429 temporary rate limit from hard daily-quota exhaustion.
  4. Check OpenRouter model ID, provider compatibility and context/max-token fields. Generate a candidate diff; do not overwrite Ling custom…
  5. Require explicit approval of diff before applying. Back up original files, write atomically, run python3 -m json.tool, pi --list-models…
  6. For Muse/Grokbot/Dot use a controlled shell child-agent invocation. Confirm host supports executing a local Pi command, shared workspace…
  7. Ask user which model to use before major tasks; use automatic fallback only after user opts in. Never replay side-effectful actions after…

What it can do on your machine

Read from SKILL.md and the folder at commit 2f3075f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • OPENROUTER_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Freetoken Bots loads about 1.3k tokens when it runs. Until then it costs about 59 tokens; SKILL.md has 648 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~59
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 648 words (~1,280 tokens).

“Pi is the execution layer; Muse, Grokbot and Dot may invoke it only if they can run shell commands or access a separately deployed Pi service. Do not claim to replace those products' native models.”

— opening of SKILL.md by limin112
name
freetoken-bots
version
0.1.2

Read the full SKILL.md on GitHub

Files

SKILL.md and 6 other files (scripts) in skills/FreeToken-Bots of limin112/min-skill.

  • SKILL.md
  • .gitignore
  • README.md
  • scripts/__pycache__/radar.cpython-313.pyc
  • scripts/radar.py
  • tests/__pycache__/test_radar.cpython-313.pyc
  • tests/test_radar.py

Open the folder on GitHubat commit 2f3075f

Compare with similar skills

Freetoken Bots next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Freetoken Bots compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Freetoken Bots this skilllimin112/min-skill412—~1.3kAutomated safety check: PassNone
Add Modelget-convex/convex-evals130—~1.5kAutomated safety check: NotesApache-2.0
To Imgrtadewald/skills185—~673Automated safety check: NotesNone
Openrouterdavidondrej/skills4.1k—~1.3kAutomated safety check: PassMIT
Openrouter Text2musicQinghongLin/data2story-skill156—~618Automated safety check: PassMIT
Openrouter Text2musicQinghongLin/data2story-skill156—~407Automated safety check: PassMIT

Similar skills

  • Add Model

    get-convex/convex-evals

    Add a new model to the convex-evals coding leaderboard, and optionally the decision benchmark, through a PR, then dispatch its baseline runs.

    130 GitHub stars~1.5k tokensUpdated today
    AI & LLM EngineeringAuto-check: notes
  • To Img

    rtadewald/skills

    Gera imagens em paralelo via OpenRouter a partir de um pedido simples ou de um batch com prompts e filenames definidos.

    185 GitHub stars~673 tokensUpdated 10 days ago
    AI & LLM EngineeringAuto-check: notes
  • Openrouter

    davidondrej/skills

    Design, build, debug, and optimize OpenRouter API integrations.

    4.1k GitHub stars~1.3k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • Openrouter Text2music

    QinghongLin/data2story-skill

    Generate atmospheric sound-design / SFX (NOT speech, NOT the front-of-blog BGM) via OpenRouter using Google Lyria 3 Pro.

    156 GitHub stars~618 tokensUpdated 3 mo ago
    AI & LLM EngineeringAuto-check passed
  • Openrouter Text2music

    QinghongLin/data2story-skill

    Generate music (NOT speech) via OpenRouter using Google Lyria 3 Pro.

    156 GitHub stars~407 tokensUpdated 3 mo ago
    AI & LLM EngineeringAuto-check passed
  • Fabrica Personagens

    corosolto/client

    Fábrica de personagens e skins do CS BRASIL, da ficha ao personagem no jogo com avatar e arte de resultado.

    257 GitHub stars~1.6k tokensUpdated today
    AI & LLM EngineeringAuto-check: notes

More from limin112/min-skill

  • Explain Video

    limin112/min-skill

    Build a narrated explainer video from a concept — discussion → structure → HTML slide deck → narration script → TTS voice → subtitles → background music → Playwright screen recording → ffmpeg…

    412 GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Handwriting Stand Up

    limin112/min-skill

    Turn a screen recording of handwriting (or a photo of handwritten text) into a single-file HTML "continuation" — the recording plays, the ink lifts off the page as solid 3D letters, a short animated…

    412 GitHub stars~2.5k tokensUpdated today
    Auto-check passed
  • Wechat Publish Template

    limin112/min-skill

    把 Markdown 文章转成"个人技术风"公众号 HTML(橙黑赛博朋克风格)。用户提供 .md 文件路径,或贴一段 Markdown,并说"转成公众号"/"做成公众号排版"/"套公众号模板"时触发。产物是单一 HTML 文件,全 inline style,可直接在浏览器打开后全选复制粘贴到微信公众号编辑器。不要在用户只是问"如何写公众号"或"公众号选题"这类非排版问题时触发。

    412 GitHub stars~1k tokensUpdated today
    Auto-check passed

Works with

Questions about Freetoken Bots

What does Freetoken Bots do?

Discover, verify, and maintain zero-priced OpenRouter models for Pi child-agent workflows used by Muse, Grokbot, or Dot. Freetoken Bots is an agent skill from limin112/min-skill. Discover, verify, and maintain zero-priced OpenRouter models for Pi child-agent workflows used by Muse, Grokbot, or Dot.

When should I use Freetoken Bots?

Freetoken Bots fits situations like: free-model discovery; quota-safe Pi fallback; model recommendations; daily health checks.

How do I install Freetoken Bots in Claude Code?

Run `npx skills add limin112/min-skill --skill freetoken-bots -a claude-code`. Or copy the skill folder (skills/FreeToken-Bots in limin112/min-skill) into .claude/skills/freetoken-bots in your project. Claude Code loads it when a task matches its description.

How do I install Freetoken Bots in Codex?

Run `npx skills add limin112/min-skill --skill freetoken-bots -a codex`. Or copy the skill folder (skills/FreeToken-Bots in limin112/min-skill) into .agents/skills/freetoken-bots in your project. Codex loads it when a task matches its description.

Can I use Freetoken Bots in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add limin112/min-skill --skill freetoken-bots -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/freetoken-bots, .gemini/skills/freetoken-bots, .github/skills/freetoken-bots and .opencode/skills/freetoken-bots in your project.

What does Freetoken Bots need to run?

Going by SKILL.md and its folder, Freetoken Bots needs Python for the scripts in its folder, the command-line tools its instructions call (python3) and credentials named OPENROUTER_API_KEY. Our summary lists: Python 3; A credential in OPENROUTER_API_KEY.

Does Freetoken Bots access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Freetoken Bots safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Freetoken Bots use?

No licence was found for Freetoken Bots or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Freetoken Bots use?

About 1.3k tokens (SKILL.md is roughly 5.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Freetoken Bots?

Skills that share tags, products or a category with Freetoken Bots: Add Model (get-convex/convex-evals, 130 stars), To Img (rtadewald/skills, 185 stars), Openrouter (davidondrej/skills, 4.1k stars) and Openrouter Text2music (QinghongLin/data2story-skill, 156 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Freetoken Bots?

limin112 (a GitHub user) maintains it in limin112/min-skill, which has 412 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on October 8, 2026.

Source: limin112/min-skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.