{
  "schema_version": 2,
  "kind": "shortening-method",
  "format": "agent-skill",
  "id": "survey-summary",
  "name": "Survey summary",
  "category": "Work",
  "summary": "Summarize survey results with their denominators, scope, and uncertainty intact.",
  "use_cases": [
    "Employee surveys",
    "Customer questionnaires",
    "Post-event surveys"
  ],
  "word_count": 152,
  "url": "https://sho.rten.it/methods/survey-summary/",
  "instructions_url": "https://sho.rten.it/methods/survey-summary/SKILL.md",
  "skill_url": "https://sho.rten.it/methods/survey-summary/SKILL.md",
  "json_url": "https://sho.rten.it/methods/survey-summary/llms.txt",
  "plain_text_url": "https://sho.rten.it/methods/survey-summary/prompt.txt",
  "license": "MIT",
  "sources_url": "https://sho.rten.it/sources/#survey-summary",
  "skill_name": "survey-summary",
  "skill_description": "Summarize survey results with their denominators, scope, and uncertainty intact. Use for Employee surveys, Customer questionnaires, Post-event surveys.",
  "agents_md_url": "https://sho.rten.it/methods/survey-summary/AGENTS.md",
  "sources": [],
  "instructions": "Condense the supplied survey report into a short account of what respondents reported. Use this when the source contains structured survey results; do not convert qualitative interviews into statistics.\n\nStart with the population contacted, response count, collection period, and sampling limits when supplied. Report each result with the denominator that applies to that question. Keep units, wording that changes interpretation, and distinctions between all respondents and a subgroup. Explain when multiple selections were allowed; totals need not equal 100%.\n\nGroup related results, then retain the strongest exception or limitation. Do not combine questions with different denominators, average incompatible scales, round away meaningful differences, or imply that nonrespondents agree. Keep calculations already in the source; avoid adding derived percentages unless requested.\n\nUse a short sample note, result bullets, and a limits line. Remove survey administration detail that does not affect interpretation. Do not infer causation or claim a change without a comparable baseline.",
  "example": {
    "before": "The optional onboarding survey was sent to 80 people who joined the company in June. We collected responses from 32 people between 1 and 8 July. The opening question asked whether the equipment instructions were easy to follow, and 24 of the 32 respondents answered yes. The question about account setup was optional: 20 people answered it, and 11 of those 20 said they had needed help. A separate question let all 32 respondents choose more than one useful resource. Twenty-two selected the checklist and 18 selected the buddy session, so these groups overlap. The survey team sent two reminders. We do not know how the 48 nonrespondents experienced onboarding. Last year's survey used different questions, so the team did not make a year-over-year comparison.",
    "after": "Sample: Optional survey of 80 June joiners; 32 responded, 1–8 July.\n\n- Equipment instructions were easy to follow: 24 of 32 respondents.\n- Needed account-setup help: 11 of 20 who answered that optional question.\n- Useful resources: checklist, 22 of 32; buddy session, 18 of 32. Multiple selections were allowed; groups overlap.\n\nLimits: Experiences of 48 nonrespondents are unknown. Different questions prevent a year-over-year comparison.",
    "context": "Employee onboarding survey",
    "must_preserve": [
      "80 invited June joiners; 32 responses; 1–8 July; optional",
      "24/32 equipment instructions",
      "11/20 optional account question",
      "22/32 checklist; 18/32 buddy; overlapping selections",
      "48 nonrespondents unknown",
      "Different questions prevent prior-year comparison"
    ],
    "omitted": [
      "Two reminder messages"
    ],
    "kind": "illustrative"
  }
}