Docs · Claude skill

Write scripts with Claude

The BotWith.me scripting skill teaches Claude the whole .bot language: every command the engine has, the events, bags, JSON, the paint overlay — and how to verify a script against this site's live checker before handing it to you. Install it once and you can ask Claude for a finished bot in plain English: “write me a power-miner with a HUD”.

Download the skill  ·  bot-scripting.skill One small file. Works with Claude on the web, the desktop app, and Claude Code.

What the skill gives Claude

The whole language

Every command with its exact arguments — Claude looks names up instead of guessing, so no more invIsfull typos — plus the grammar: events, states, bags, JSON, the paint overlay.

Proven patterns

Mining loops, HUD overlays, tracker tables, settings that survive restarts, reacting to game messages — the shapes that work, baked in.

Checked before you get it

The skill tells Claude to verify every script against this site's checker and fix what it reports — you receive scripts that already pass with zero errors and zero warnings.

Install — Claude on the web or the desktop app

Same three steps on claude.ai and in the Claude desktop app. You need a plan that supports skills.

Step 1

Open Settings → Capabilities

Click your initials (bottom-left on the web, the menu in the app) → Settings → Capabilities.

M Capabilities
Step 2

Skills → Upload skill

Scroll to the Skills section and choose Upload skill, then pick the bot-scripting.skill file you downloaded.

Skills Upload skill
Step 3

Switch it on

The bot-scripting card appears in your skills list — make sure its toggle is on. That's it; every new chat can use it.

bot-scripting

Install — Claude Code (the terminal)

A .skill file is a zip. Unpack it into your personal skills folder so every project can use it:

Windows (PowerShell)
Expand-Archive bot-scripting.skill "$env:USERPROFILE\.claude\skills\" -Force
macOS / Linux
unzip bot-scripting.skill -d ~/.claude/skills/

You should end up with ~/.claude/skills/bot-scripting/SKILL.md. Claude Code picks it up on its next session — ask for a script or invoke it directly with /bot-scripting.

Using it

Just describe the bot you want. The skill makes Claude look up real command signatures, follow the language rules, and check the result against this site's checker before you see it.

Prompts that work well

  • “Write me a power-miner for iron: drop when full, HUD with runtime, ores this trip and ores/hr.”
  • “Make a fishing tracker that watches the game messages and counts each kind of catch on the script tab, with a reset button.”
  • “My script gets these checker errors — fix it but keep what it does.” (paste the script and the errors)
  • “Add an overlay to this script showing a progress ring and xp/hr.”

Then run it

  1. Save Claude's script as yourbot.bot.
  2. Open it in the launcher's script editor — it checks live as you type, so a clean script loads straight away.
  3. Not sure about a change? Paste it into the playground — the same checker, in your browser.

If Claude can reach the web it verifies automatically against botwith.me's checker; if not, it will say so — the editor or the playground catches anything the moment you paste.

Keep it current

When the engine gains commands, a fresh skill is published here. Re-download and upload it again (or re-unzip for Claude Code) — it replaces the old one. This page's copy always matches the engine this site runs.