Update to CommScore

{
  "description": "Set up or update a brand's voice guide in CommScore (tone, values, style do's and don'ts, audiences, terms to use or avoid) from its website or from brand guidelines the user provides, so CommScore can write and score communications in that voice. Use whenever the user wants to add a brand or organisation to CommScore, build or fill in a brand voice guide, import brand guidelines or a style guide, or add terms the brand uses or avoids, even if they don't mention CommScore by name.",
  "included_files": [],
  "name": "set-up-a-brand",
  "skill_md_contents": "---\nname: set-up-a-brand\ndescription: Set up or update a brand's voice guide in CommScore (tone, values, style do's and don'ts, audiences, terms to use or avoid) from its website or from brand guidelines the user provides, so CommScore can write and score communications in that voice. Use whenever the user wants to add a brand or organisation to CommScore, build or fill in a brand voice guide, import brand guidelines or a style guide, or add terms the brand uses or avoids, even if they don't mention CommScore by name.\n---\n\n# Set up a brand\n\nCommScore writes and scores communications against a brand's voice guide. A complete\nguide makes everything else better: drafts sound like the organisation, and scores point at\nwhat actually matters for it. This skill gets a brand from nothing (or half-filled) to a\nguide the user has reviewed and approved.\n\nThe user stays in charge of what their brand guide says. Draft freely, but save only what\nthey have seen and agreed to.\n\n## 1. Check what already exists\n\nCall `list_brands`. If the brand is already there, don't create it again. Work on the\nexisting one: read it with `get_brand_profile` and fill the gaps (step 4). Brands with\nthe same name are told apart by website.\n\n## 2. Create the brand (if it's new)\n\nCall `create_brand` with the name, website, language (e.g. `en-AU`) and country (e.g.\n`AU`). Ask the user for anything you can't infer. Creating a brand needs a CommScore admin\nor member account; if the tool says so, tell the user who can do it.\n\nIf the user gave you brand guidelines (a pasted style guide, a document's text), you can\npass the parts you're confident about straight into `create_brand`, mapped to the guide\nfields.\n\n## 3. Draft the guide\n\nThere are two sources. Use whichever the user has, or both:\n\n- **The website:** call `research_brand`. It drafts values, customer charter, tone,\n  writing principles, style examples, audiences and terms from the brand's public web\n  presence, in about 30 seconds, using the workspace's AI credits. It saves nothing.\n  If part of it is unavailable, say which part and carry on with the rest.\n- **Their own guidelines:** extract the guide fields from what they gave you. Quote their\n  wording where you can; don't invent values or rules the document doesn't contain.\n\n## 4. Review with the user, then save\n\nShow the draft in readable sections, not as raw JSON:\n- **Voice:** tone, core idea, writing principles.\n- **Values:** company values, service values, customer charter.\n- **Style:** do's, don'ts, checklist.\n- **Audiences.**\n- **Terms to use** and **terms to avoid**, each with its explanation or alternative.\n\nAsk what to change. Apply their edits, then save:\n\n- `update_brand_profile` fills empty fields and adds terms and audiences. It never\n  overwrites, so it's safe for a first save or for topping up.\n- If it reports `skipped` fields (already filled), show the user the current value next\n  to the new one. Use `replace_brand_fields` only for the fields they confirm should be\n  replaced. Remember that a list passed to it replaces the whole stored list.\n\n## 5. Show the result\n\nCall `get_brand_profile` and summarise what the guide now holds, in a few lines. Offer a\nquick test: draft or score a short sample communication for the brand (an email or SMS)\nso the user can see the guide at work.\n\n## When something goes wrong\n\n- **\"Only CommScore admins and members can…\":** the user's account can read brands but not\n  change them. Suggest they ask a CommScore admin, or use the CommScore web app.\n- **Web research turned off:** ask the user for their brand guidelines instead, and draft\n  from those (step 3).\n- **Duplicate refused by `create_brand`:** use the brand_id it gives you and continue from\n  step 4.\n"
}