Update to Cheerful

{
  "description": "Get started with Cheerful: say everything Cheerful can do in this chat, confirm which Cheerful account is connected, check its mailboxes and integrations, list its campaigns and show the credits left, then suggest what to do next. Read-only. Use when the user says \"what can you do\", \"what can Cheerful do\", \"help\", \"get started with Cheerful\", \"set up Cheerful\", \"is Cheerful connected\", \"which Cheerful account is this\", \"show me my Cheerful account\", or has just installed the Cheerful plugin.",
  "included_files": [
    {
      "relative_path": "agents/openai.yaml",
      "size_in_bytes": 634
    }
  ],
  "name": "cheerful-getting-started",
  "skill_md_contents": "---\nname: cheerful-getting-started\ndescription: \"Get started with Cheerful: say everything Cheerful can do in this chat, confirm which Cheerful account is connected, check its mailboxes and integrations, list its campaigns and show the credits left, then suggest what to do next. Read-only. Use when the user says \\\"what can you do\\\", \\\"what can Cheerful do\\\", \\\"help\\\", \\\"get started with Cheerful\\\", \\\"set up Cheerful\\\", \\\"is Cheerful connected\\\", \\\"which Cheerful account is this\\\", \\\"show me my Cheerful account\\\", or has just installed the Cheerful plugin.\"\n---\n\n# Get started with Cheerful\n\nTwo parts, in this order: **what Cheerful can do here** (the full list, so nothing is missed),\nthen **one quick pass over the user's account** (who is connected, what they can send from,\nconnections, campaigns, credits). It only reads; it changes nothing and spends no credits.\n\n## Step 0: Check the connection\n\nEvery step below calls a Cheerful tool. If a Cheerful tool is unavailable, or a call answers\n\"Tool not found\" or asks to reconnect, stop and tell the user: \"Connect Cheerful from the plugin\npage, then ask me again.\" Don't retry the call and don't guess the account's contents.\n\n## Read this first: what the data can and can't tell you\n\n- **Lead with what it can do, not what it can't.** \"What can you do?\" is answered with the\n  capability list below, written for the tools you actually have. The things done in the\n  Cheerful app get one short line at the end, never the opening.\n- **Two tool sets exist.** If `create_campaign_draft` and `preview_campaign_launch` are listed, Cheerful can set\n  up a campaign and the user sends it from the launch card. If they are not listed, campaigns\n  are set up and sent in the Cheerful app; say that once and keep everything else.\n- **Read is not send.** A mailbox the user can read is not necessarily one they may send from.\n  `account_read` separates the two; report them separately.\n- **Teammates' work shows up too.** Campaigns carrying `owner_email` or `team_id` belong to a\n  teammate. Say whose they are.\n- **Credits, never dollars.** If `computed_at` is empty in `billing_usage`, say \"not counted yet\n  this cycle\" rather than zero.\n- **A section that fails is a gap, not a stop.** If one call errors, write \"couldn't check this\n  right now\" for that section and carry on with the rest.\n\n## What Cheerful can do here\n\nWrite this list every time the user asks what Cheerful can do, or has just connected. Keep every\ngroup; one line per item, each with a short example the user can paste.\n\n**Find creators** (Instagram, TikTok, YouTube; searches use credits)\n- Search from a brief: niche, country, follower range, engagement. \"Find 20 US skincare creators\n  on TikTok with 10k-100k followers\"\n- Creators like one you already love. \"Find creators like @handle\"\n- YouTube deep search: vets each channel's videos in the background (10-45 minutes) and saves\n  the results to a list.\n- Vet one creator against a brief: audience, engagement, recent posts, red flags. \"Is @handle a\n  good fit for our vegan snack?\"\n- Save creators to a list and read your saved lists. \"Save these to my Spring list\"\n\n**Run campaigns** (only when `create_campaign_draft` is listed)\n- Set up a campaign from a brief: the first email, a follow-up, the product, the send window.\n  Nothing is sent. \"Set up a gifting campaign for our new protein bar\"\n- Add creators to it from a search, a saved list or names and emails you paste.\n- Check your sending inbox and your domain's email setup, and get the link to connect Gmail.\n  \"Which inbox will this send from?\"\n- Preview the launch: the real first email, who gets it, when and how fast. It goes out only when\n  you click **Confirm & send** on the card. \"Show me the launch preview\"\n\nWithout `create_campaign_draft`: one line instead, \"Setting up and sending campaigns happens in the\nCheerful app (https://app.cheerful.ai); everything below works here.\"\n\n**Track results** (reading costs no credits)\n- Campaigns: status, who sends them, sent, replies, opt-ins. \"Which campaign has the lowest\n  reply rate?\"\n- One-call campaign summary: performance, replies waiting on you, opt-ins, top posts. \"Give me a\n  summary of my latest campaign\"\n- Replies: who answered, who opted in, who still needs an answer, with reply text drafted for you\n  to send from Cheerful. \"Who replied to my campaigns?\"\n- Posted content: which creators posted, and the top posts. \"Show me the posts from Spring\n  Seeding\"\n\n**Your account**\n- Credits left and renewal date; mailboxes; connected tools (Shopify, Google Sheets, Instantly and\n  others) and whether any needs attention.\n\n**Done in the Cheerful app** (one line): editing, pausing or deleting a live campaign, replying\nto creators, and buying sending domains.\n\n## Workflow\n\n1. **Account.** Call `get_profile`. Note the email and team name (the `nickname` reads\n   \"email · team\").\n2. **Access.** Call `account_read`. Count the mailboxes the user can send from and the ones they\n   can only read, and list their teams.\n3. **Connections.** Call `integration_status`. List what is connected and healthy, and flag any\n   connection that reports an error. Connecting or fixing one happens in Cheerful, not here.\n4. **Campaigns.** Call `campaign_read` with `action=\"index\"` and `include_stats=true`. Count the\n   campaigns by status. Pick up to 3 to show: campaigns with sends first (most replies, then most\n   sent), then the most recently updated. Show each with sent, replies and opt-ins. Don't fill\n   the 3 with drafts that have sent nothing when campaigns with results exist.\n5. **Credits.** Call `billing_usage`. Report `remaining` of `plan_included_credits` and the renewal\n   date (`cycle_end`).\n6. **Next steps.** Suggest exactly 3 things to try, chosen from what you found:\n   - `create_campaign_draft` listed → always include \"Set up a campaign from a brief\";\n   - no campaigns yet → \"Find creators for a brief\";\n   - campaigns with replies → \"See who replied and who needs an answer\";\n   - several campaigns → \"Which campaign is behind?\" or \"Summary of <campaign name>\";\n   - a creator in mind → \"Vet @handle against my brief\".\n\n## Output layout\n\n```\nHere's what I can do with Cheerful in this chat:\n\n**Find creators** (Instagram, TikTok, YouTube; searches use credits)\n- Search from a brief: \"Find 20 US skincare creators on TikTok with 10k-100k followers\"\n- ... (every item from \"What Cheerful can do here\")\n\n**Run campaigns**\n- ...\n\n**Track results**\n- ...\n\nDone in the Cheerful app: editing, pausing or deleting a live campaign, replying to creators,\nbuying sending domains.\n\n---\n\n**Connected as** ava@brand.com · Brand Team\n**Mailboxes:** 2 you can send from, 1 you can read only\n**Connections:** Shopify, Google Sheets connected · Instantly needs attention\n**Campaigns:** 3 (1 active, 2 paused)\n- Spring Skincare Seeding — 40 sent, 12 replies, 5 opted in\n- Vegan Snacks Launch — 20 sent, 3 replies\n**Credits:** 2,470 of 2,500 left, renews Oct 31\n\n**Try next**\n1. \"Set up a gifting campaign for our new protein bar\"\n2. \"Who replied to my campaigns?\"\n3. \"Give me a summary of Spring Skincare Seeding\"\n```\n\nKeep it to this shape. If the user only asked \"which account is connected\" or \"is Cheerful\nconnected\", skip the capability list and give the account part only. No mailbox → say \"No mailbox\nconnected yet — connect one to send campaigns.\" No campaigns → say so in one line and lead with\nthe find-creators suggestion.\n\n## Rules\n\n- Plain language. Don't show ids, field names, status codes or the word \"tool\" to the user.\n- Never say Cheerful will send an email by itself. When the campaign tools are available,\n  outreach goes out only when the user clicks Confirm & send on the launch card; otherwise\n  sending and launching happen in Cheerful at https://app.cheerful.ai. Editing or pausing a live\n  campaign happens in Cheerful either way.\n- Report credits as credits. Don't mention prices or promote plans.\n- Don't invent mailboxes, integrations or campaigns that weren't in the results.\n"
}