bullet-bots: Skill for Claude Code

Set up a Bullet market maker

The user is crypto-native but may never have used a terminal deploy tool. You run the commands; they click links and approve. Plain language, say what you are about to do and why. Aim for 10 minutes; batch questions, since every round trip costs.

Hard rules:

• Never ask the user to paste a private key, seed phrase or Telegram token into chat unless they chose the own-bot Telegram path (then only the BotFather token, and set it straight into fly secrets set; never echo it back).
• Never print the Fly deploy token or paste it into chat: pipe it straight into gh secret set (step 3).
• The bot makes its own key on the Fly machine. The user only pastes the bot's PUBLIC address into Bullet.
• Do not place orders yourself. Never use the latest image tag.
• New bots paper trade first (BB_MM_DRY_RUN=true). Real orders only after step 7.
• Work from the root of the user's bot repo once step 3 creates it. fly.toml and config/simple-mm-fly.toml are already tuned; do not change the strategy numbers.

Steps

1. Funding and account

1. Say this plainly, in one sentence: this is software that trades real money, you can lose money and the losses are yours, Bullet's terms apply, so start small.
2. Get the BTC price (curl -s "https://tradingapi.bullet.xyz/fapi/v1/ticker/price?symbol=BTC-USD") and state the minimum before they fund: the bot quotes 2 orders of 0.0003 BTC, so its max position (20% of equity) must be at least 0.0006 BTC, i.e. equity of at least 0.0006 × BTC price × 5 (about $245 at $81.5k; give the current figure).
3. In the same message, offer the account choice:
   • Sub-account (recommended). The bot's key is a delegate on that sub-account only, so Bullet itself stops it touching the main account or other sub-accounts. Opening a sub-account costs about $1.
   • Main account. No sub-account needed, but the bot treats the account's whole BTC-USD state as its own: every 60 s it cancels BTC-USD orders it didn't place, it counts any BTC-USD position toward its caps and quotes to unwind it, and its close tool would flatten the whole position. The key can trade everything else in the account too (it can never withdraw). No funded Bullet account yet: https://app.bullet.xyz/trade?r=BB (referral BB). Have them fund the chosen account (for a sub-account: create it, move the capital in) and reply with its index (the number shown next to it in the app, e.g. "Subaccount 1" is 1) and its equity in USD.
4. Propose limits and confirm with the user before using them:
   • BB_MM_MAX_POSITION in BTC = about 20% of equity / BTC price (round down to 0.0001 BTC steps). Below 0.0006 the account is too small: stop until they add funds. Never raise the cap above 20% of equity to make it fit.
   • BB_MM_DAILY_LOSS_USD = about 5% of equity. Explain: "max position is the most BTC the bot will hold either way; the daily loss is the amount at which it stops and cancels."