BOT Chain
Skill Engine
A portable skill and local MCP toolkit that turns Claude Code, Codex, Cursor, and Windsurf into specialized BOT Chain engineering agents — read, build, sign, deploy, and verify without leaving the prompt.
npx skills add manueldezman/botchain-init-toolkit --skill botchain-skill-engine -g
npx github:manueldezman/botchain-init-toolkit --global
Skill Introduction
A unified BOT Chain skill that bundles environment health checks, contract scaffolding, compilation bridges, local signing, and deployment to the configured BOT Chain network — enabling an AI coding agent to execute and verify complete on-chain workflows from natural-language prompts.
Capabilities
Nine bundled capabilities cover the path from "write a contract" to "confirmed on explorer," across every supported IDE.
Portable Skill Install
Installs the BOT Chain skill globally through the standard Skills CLI. The MCP bootstrap then configures Claude, Codex, Cursor, and Windsurf from one client-independent setup.
Progressive Skill Directory
Drops token-efficient SKILL.md files, references, and asset templates into global registries for Claude Code, Codex, Cursor, and Windsurf.
Environment Doctor
Runs hidden path checks (which forge / npx hardhat) to confirm compiler availability before any build starts.
Auto-Correction Loop
If Foundry or Hardhat is missing, the agent diagnoses the gap and requests permission before any installation or setup action.
Compiler Bridge
Executes local compilation frameworks (forge build / forge create) through a safe terminal execution tool.
Live Network Deploy
Signs locally and deploys compiled bytecode to BOT Chain testnet or mainnet, according to the network the user intentionally configured.
Explorer Fetcher
Checks transaction confirmation status and returns the matching BOT Chain explorer link inside the chat.
Agent Identity Template
Ships an optional identity-contract pattern for wallets, blueprint references, and boundary policies. It is a toolkit convention, not a native chain feature.
Gasless Eligibility Check
Checks BOT Chain paymaster sponsorship through the network's pm_isSponsorable RPC method before a transaction is sent.
Skill File Storage Path
Claude Code loads global and project-level skills from its skills directory.
Codex loads global skills from its skills directory and picks them up on a new session.
Cursor reads skill definitions from its skills directory. Project-level skills override global ones with the same name.
Windsurf is configured through Rules output instead of a global skills directory. The project-level Rules file is written only when the installer runs inside a real project.
Verify Skill Installation in Terminal
Installed skills appear in the system reminder at session start, and can be checked in any new conversation.
Codex loads skills on session start. A successful install appears in the available skills list on a new session.
If the BOT Chain skill appears in Cursor's installed skills list, the installation was picked up correctly.
Windsurf uses Rules output instead of a skills route. If the files are present but the tool does not pick them up, use the manual fallback in Settings → Cascade → Rules.
How Agent Uses Skill
Write Your Prompt
Describe your task naturally. The agent scans the global SKILL.md and detects which skill to invoke.
Agent Runs Pre-Flight
The MCP server checks compiler health and, if needed, asks approval to auto-install missing tooling.
Skill Executes & Verifies
A complete imperative prompt is authorization for that exact action. The skill compiles, signs locally, executes, and verifies the result.
Everything You Need, In One Place
Use the quick links for complete reference material, or resolve the most common setup issues without leaving this page.
When Setup Stalls
01 / SKILL NOT FOUND
Restart your coding agent
Skills and MCP configuration are loaded when a new Claude Code, Codex, Cursor, or Windsurf session starts.
02 / RPC UNREACHABLE
Check the testnet values
Use rpc.bohr.life with chain ID 968. Confirm your network can reach the endpoint before retrying.
03 / COMPILER MISSING
Install Foundry or Hardhat
The environment doctor requires Node and either Forge or a locally available Hardhat installation.
04 / CANNOT SIGN
Run the interactive MCP bootstrap
Paste a dedicated, minimally funded private key into the hidden prompt. Confirm the public address, then restart your agent. The key is stored once for every supported client.
Return to the installation steps and rerun step 2 to replace or configure the shared wallet.
From Prompt To Result
Expand an example to see what you can ask and the response the BOT Chain skill returns.