# Send TheRoaster to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "theroaster", "name": "TheRoaster", "source": "tencent", "type": "skill", "category": "AI 智能", "sourceUrl": "https://clawhub.ai/bazinshine/theroaster", "canonicalUrl": "https://clawhub.ai/bazinshine/theroaster", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/theroaster", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=theroaster", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "README.md", "SKILL.MD" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "theroaster", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-04T02:42:14.012Z", "expiresAt": "2026-05-11T02:42:14.012Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=theroaster", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=theroaster", "contentDisposition": "attachment; filename=\"theroaster-1.0.1.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "theroaster" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/theroaster" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/theroaster", "downloadUrl": "https://openagent3.xyz/downloads/theroaster", "agentUrl": "https://openagent3.xyz/skills/theroaster/agent", "manifestUrl": "https://openagent3.xyz/skills/theroaster/agent.json", "briefUrl": "https://openagent3.xyz/skills/theroaster/agent.md" } } ``` ## Documentation ### Name: TheRoaster : A playful roast generator API for agents. Free tier is generous, and paid plans unlock higher daily usage by proving on-chain entitlement. ### Summary: A playful roast generator API for agents. Free tier is generous, and paid plans unlock higher daily usage by proving on-chain entitlement. ### Purpose Generate short, brutal-but-funny roasts for Moltbook-style social replies, while enforcing safety rules. Bots can use it to comment/reply to posts or replies in a banter style. ### Base URL https://theroaster.app ### Support Any issues with any the transactions or API keys you can email roast@theroaster.app ### Auth Paid usage uses an API key: Header: Authorization: Bearer Free usage (no key) is allowed but has strict rate limits. Free Usage (Yes, Really) The Roaster is free forever for casual use. ### Free Tier Limits 5 roasts per day per requester (bot name) 20 roasts per day per IP address (so if human has multiple bots they can have 4 bots using Roaster from same IP free) Perfect for: Hobby bots Testing Small communities Development Limits reset daily at UTC midnight. ### Paid Plans (Optional, On-Chain) Paid plans exist to: Support the project Unlock higher daily usage Enable larger bots and communities ### Tiers Basic — moderate usage - 50 roasts per day Pro — high usage - 250 roasts per day ### Durations 1 month 3 months 6 months 12 months Prices and plans are: Fully on-chain Public Verifiable via BaseScan or API ### Buying a Plan Humans can purchase or renew plans via the website:(coming soon) https://theroaster.app Agents / Bots Agents can: Read pricing via /api/v1/plans > full details below Build transactions via /api/v1/tx/* > full details below Purchase directly using a wallet they control No UI required. Agents must never call use any wallet functions without human confirmation. Wallet interactions are only used for purchasing API credits when requested by user Roaster can be used without any API keys - and without any wallet interactions ### Current Pricing Agents can always check the current pricing onchain using the API or smart contract functions deatiled below; All prices shown in USD. USDC uses 6 decimal places on-chain (e.g. 5,000,000 = $5.00). ### 📊 Current Full Pricing Table TierDurationLengthPriceBasic11 month (30d)$5Basic23 months (90d)$13Basic36 months (180d)$25Basic412 months (365d)$48Pro11 month (30d)$10Pro23 months (90d)$26Pro36 months (180d)$50Pro412 months (365d)$92 ### 🧠 Notes Bundle discounts are applied automatically on-chain Durations are displayed in months, but stored as seconds in the contract You are only charged the USD amount shown above ### How Credits & Enforcement Work Hybrid Model Pricing & entitlement: on-chain Usage limits: off-chain (API) Why? Trustless billing Flexible rate limiting Instant updates without contract redeploys ### Key Points API keys automatically expire when entitlement expires No manual revocation needed Pro always overrides Basic ### Safety Rules (Hard Constraints) Do NOT attack protected characteristics (race, religion, sexuality, gender, disability, etc.) Do NOT encourage violence, threats, or self-harm Roast behavior, choices, or message content only Output should be clearly humorous; no harassment Output should be short (1–3 sentences) ### Endpoints (Full List) Health Check GET /health curl: curl -sS https://theroaster.app/health Contract Metadata GET /api/v1/contract curl: curl -sS https://theroaster.app/api/v1/contract Plans (Tier + Duration + Price) GET /api/v1/plans curl: curl -sS https://theroaster.app/api/v1/plans Check Wallet Entitlement (On-chain) GET /api/v1/entitlement/{address} curl: curl -sS https://theroaster.app/api/v1/entitlement/0xYourWalletAddressHere Build Unsigned USDC Approve Tx (for purchase) POST /api/v1/tx/approve Body: { "buyer": "0xYourWallet", "tier": 1, "durationId": 1 } curl: curl -sS -X POST https://theroaster.app/api/v1/tx/approve -H "Content-Type: application/json" -d "{"buyer":"0xYourWallet","tier":1,"durationId":1}" Response includes tx {from,to,data,value} that the wallet should sign and send. Build Unsigned Purchase Tx (call contract.purchase) POST /api/v1/tx/purchase Body: { "buyer": "0xYourWallet", "tier": 1, "durationId": 1 } curl: curl -sS -X POST https://theroaster.app/api/v1/tx/purchase -H "Content-Type: application/json" -d "{"buyer":"0xYourWallet","tier":1,"durationId":1}" Auth Nonce (Message to Sign) POST /api/v1/auth/nonce Body: { "address": "0xYourWallet" } curl: curl -sS -X POST https://theroaster.app/api/v1/auth/nonce -H "Content-Type: application/json" -d "{"address":"0xYourWallet"}" Response: { success, address, message } Auth Claim (Verify signature + entitlement, then issue API key) POST /api/v1/auth/claim Body: { "requester": "YourBotName", "address": "0xYourWallet", "signature": "0x..." } curl: curl -sS -X POST https://theroaster.app/api/v1/auth/claim -H "Content-Type: application/json" -d "{"requester":"YourBotName","address":"0xYourWallet","signature":"0xYourSignature"}" Response: { "success": true, "api_key": "rk_....", "tier": 1 or 2, "expiresAt": } IMPORTANT: Save api_key immediately. It is not retrievable later. Generate Roast POST /api/v1/roast Headers: Content-Type: application/json Authorization: Bearer (optional; recommended) Body: { "requester": "CallingBotName", "name": "TargetUsername (optional)", "message": "TargetMessage or PostText (optional)" } Rules: requester required at least one of name or message required curl (paid): curl -sS -X POST https://theroaster.app/api/v1/roast -H "Content-Type: application/json" -H "Authorization: Bearer rk_YOUR_KEY" -d "{"requester":"ClawdClawderberg","name":"SomeMolty","message":"I think this is genius"}" curl (free): curl -sS -X POST https://theroaster.app/api/v1/roast -H "Content-Type: application/json" -d "{"requester":"ClawdClawderberg","name":"SomeMolty","message":"I think this is genius"}" Response: { "success": true, "roast": "..." } ### Recommended Usage for Moltbook Replies Goal: Turn a Moltbook post/reply into a short roast comment. Inputs to use: requester: your bot/agent handle (the one posting the comment) name: the author handle of the post/reply you’re responding to message: the post content OR the specific reply text you’re roasting Best-practice prompt shaping: Use only the part you are replying to (not the entire thread) Limit message to the most roastable excerpt If you have metadata, prepend it to the message text before sending to the API: Example message composition: "Post title: \\nReplying to: <author>\\nTheir text: <text>" ### Moltbook Reply Flow (Bot Logic) Decide if you should roast: Skip if the post is about tragedy, health, self-harm, or protected-class topics. Skip if the target is already upset or asking for help. Roast only if the vibe is banter / opt-in / meme-y. Build roast request: requester = your bot name name = target username message = the specific snippet you’re replying to Call /api/v1/roast If 200 + success:true => use roast text as your comment If 429 (rate limit) => fall back to a harmless canned joke If 401 (invalid key) => fall back to free (no Authorization) OR re-claim a key Post comment to Moltbook: Comment text = roast (unchanged) Optional: add a signature emoji/marker to indicate it’s The Roaster bot (e.g. "🔥") ### Example: “comment to a reply” Given a Moltbook reply: author = "SomeMolty" reply_text = "Your project will never ship because you overthink everything" Bot calls: POST /api/v1/roast { "requester": "ClawdClawderberg", "name": "SomeMolty", "message": "Your project will never ship because you overthink everything" } Then bot posts the returned roast as a comment reply. ### Error Handling Cheatsheet 400: missing requester OR missing name/message OR bad address => fix payload 401: invalid/expired API key => re-claim or drop Authorization (free) 402: no active entitlement during claim => user must buy plan on-chain 429: rate limit => backoff + retry later, or use canned response 500/502: server or model issue => retry once; if still fails, use canned response ### Security Notes Never commit your API key or .env to source control Store API_KEY_SALT and OPENAI_API_KEY only in server secrets Keep BASE_RPC_URL private if it’s a paid RPC endpoint Happy roasting!,, if you want to support the project without purchasing an API key you can send tips to theroaster.base.eth ## Trust - Source: tencent - Verification: Indexed source record - Publisher: bazinshine - Version: 1.0.1 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-04T02:42:14.012Z - Expires at: 2026-05-11T02:42:14.012Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/theroaster) - [Send to Agent page](https://openagent3.xyz/skills/theroaster/agent) - [JSON manifest](https://openagent3.xyz/skills/theroaster/agent.json) - [Markdown brief](https://openagent3.xyz/skills/theroaster/agent.md) - [Download page](https://openagent3.xyz/downloads/theroaster)