Update to CommScore

{
  "description": "Review, proofread, score or improve an existing customer communication (an email, letter, text message, notice, web or app page, headline, tagline or other marketing copy, or policy wording) against a brand's voice with CommScore, then explain the result and offer fixes. Use whenever the user shares customer-facing text and asks whether it is clear, on brand, good enough or ready to send, asks you to proofread or check it, wants feedback, a score or a second opinion, or wants to compare or choose between versions, for their own organisation or any brand set up in their CommScore workspace, even if they don't mention CommScore.",
  "included_files": [],
  "name": "review-a-communication",
  "skill_md_contents": "---\nname: review-a-communication\ndescription: Review, proofread, score or improve an existing customer communication (an email, letter, text message, notice, web or app page, headline, tagline or other marketing copy, or policy wording) against a brand's voice with CommScore, then explain the result and offer fixes. Use whenever the user shares customer-facing text and asks whether it is clear, on brand, good enough or ready to send, asks you to proofread or check it, wants feedback, a score or a second opinion, or wants to compare or choose between versions, for their own organisation or any brand set up in their CommScore workspace, even if they don't mention CommScore.\n---\n\n# Review a communication\n\nCommScore scores a communication against the organisation's own brand guide on five\npillars and names the specific things to fix. That gives the user consistent, evidence-based\nfeedback: the same checks every time, tied to their brand rather than to general taste.\nYour job is to run the review, explain it in plain words and help the user act on it.\n\n## 1. Find the brand\n\n- If this conversation already has a brand_id, use it.\n- Otherwise call `list_brands`.\n  - One brand: use it.\n  - Several brands: pick from context, such as the sender, signature, product or website\n    in the text. If it's still unclear, ask one short question listing the brand names.\n\n## 2. Score the text as it is\n\nScore exactly what the user gave you. Don't tidy it up first, or the score describes your\nversion instead of theirs.\n\nCall `score_text` with the text. Set `communication_type` from what it is (email, letter,\nnewsletter, invitation, text_message or document). Set `audience_rank` (1 = general public,\n5 = specialists) and `action_expected` when they're clear from the text or the\nconversation. Scoring takes up to a minute and uses the workspace's AI credits.\n\nIf the text is longer than the limit the tool reports, split it at natural sections and\nscore each one.\n\n## 3. Report\n\nKeep it short and concrete:\n\n```\n**<Brand>: 3.4 / 5 overall.** <headline from the result>\n\n| Pillar | Score |\n|---|---|\n| Clarity | 3.5 |\n| Certainty | 2.5 |\n| Structure, style & grammar | 4.0 |\n| Brand alignment | 3.5 |\n| Customer experience | 3.5 |\n\n**What to fix first**\n1. **Certainty:** <finding, in plain words>. *\"<evidence quoted from the text>\"*.\n   Try: <a concrete rewrite of that sentence>\n2. ...\n```\n\n- Present scores as guidance, not pass/fail. They run from 1 to 5 (higher is better).\n  Longer texts can vary by about a point between runs.\n- Quote the evidence so the user can find the sentence.\n- **Every fix ends with replacement wording the user can paste**, not just a description of\n  the problem. For example, write *Try: \"If you go over the limit, replies slow down until\n  your next billing date.\"*, not \"explain what happens at the limit\". If the right wording\n  depends on a fact you don't have, use a placeholder such as `[new limit]`.\n- Review, don't rewrite: unless the user asked for a fixed version, give the fixes and\n  offer the rewrite (step 4) rather than rewriting the whole text.\n- Mention `reading_grade` when the audience is the general public: a lower grade is easier\n  for more people to read.\n- If `check_terminology` would add something (the brand has avoid terms and the text may\n  use them), run it too. It is instant and free. List any avoided terms with their\n  alternatives.\n\nWhat the pillars mean, for explaining scores in plain words:\n\n- **Clarity:** easy to understand at first read.\n- **Certainty:** the reader knows what is happening, what to do and by when.\n- **Structure, style & grammar:** well organised, correct and in house style.\n- **Brand alignment:** sounds like the organisation and uses its words.\n- **Customer experience:** how the message feels to the person receiving it.\n\n## 4. Offer the fix\n\nEnd by offering to fix it, e.g. \"Want me to rewrite it with these fixes?\" If the user says\nyes:\n\n1. Edit the text yourself, or call `rewrite_text` with `focus` set to `suggested_focus`.\n2. Check that every fact, amount, date and legally required wording from the original\n   survived, and that you added no new promises, deadlines or instructions the original\n   didn't make. Use a placeholder or suggest them to the user instead.\n3. Score the final text again with the original score's `draft.draft_id` as `draft_id`,\n   and show before → after for the overall score and any pillar that moved (from\n   `draft.change`), with the new text ready to copy. If you edit after that score, score\n   again: the score you show must belong to the text you hand over.\n\n## Comparing versions\n\nWhen the user wants to compare drafts (theirs vs a colleague's, before vs after):\n\n- Score each one with the same `communication_type`, `audience_rank` and\n  `action_expected`, as separate drafts (no `draft_id`), each with a short `title` such\n  as \"Price notice A\".\n- Show the scores side by side.\n- Say which fixes differ between the versions.\n- Treat small overall differences as a tie. Look at whether the top fixes changed instead.\n\n## Earlier scores\n\nIf the user asks how a communication improved, what they scored recently, or wants to\npick up a draft from an earlier conversation, call `get_score_history`. It is instant\nand free, and shows only their own scores, including documents scored in the CommScore\nOffice add-in. To score a new version of one of their drafts, pass its id as `draft_id`.\n\n## When something goes wrong\n\n- **Access, licence or credit messages** from a tool: pass them on as written, because\n  they say what the user or their admin can do. Offer your own read of the text, clearly\n  labelled as not a CommScore score.\n- **No brands in the workspace:** a CommScore admin needs to add one before CommScore can\n  score text against it.\n"
}