{
 "schema": "aiblocks-page/1",
 "id": "community-evidence-researcher",
 "type": "skill",
 "name": "Community evidence researcher",
 "summary": "Review customer posts, comments or files for a focused question. Get sourced findings, counted themes and a clear note on what the sample cannot show.",
 "headline": "Community evidence researcher",
 "subhead": "Share a question, a date range and the posts or files to review. It groups themes, checks quotes and compares conflicting views. Get an evidence table and a short brief with sources, counts and gaps.",
 "job": {
  "id": "research-topics",
  "name": "Research a topic properly"
 },
 "level": "intermediate",
 "thinking": "medium",
 "tested": true,
 "updated": "2026-10-28",
 "first_published": "2026-10-25",
 "inputs": [
  {
   "type": "question",
   "required": true,
   "label": "Question",
   "what": "the problem, decision or piece of work you want help with, and what a good outcome looks like"
  },
  {
   "type": "voc_reviews",
   "required": false,
   "label": "Voc reviews",
   "what": "customer words from reviews, tickets, surveys or calls, with source and date"
  },
  {
   "type": "source_text",
   "required": false,
   "label": "Source text",
   "what": "a long source in full: an article, a video or talk transcript, or notes from a book, with its title, author and link"
  }
 ],
 "outputs": [
  {
   "type": "audit_report",
   "required": true,
   "label": "Audit report",
   "what": "findings with evidence, severity, missing inputs and next actions"
  },
  {
   "type": "document",
   "required": true,
   "label": "Document",
   "what": "a finished document, such as a Word file, a PDF or a page of notes"
  }
 ],
 "you_give": [
  "A focused question and intended use",
  "Supplied posts, comments, documents or approved public-source links",
  "Date range and source boundary, if known",
  "Any terms, groups or exclusions that define the scope"
 ],
 "you_get": [
  "A table with source links or record IDs, with facts, opinions and conclusions kept separate",
  "Counts you can recheck, with the total used and how repeats were handled",
  "A short answer showing where sources disagree, who is missing and what to check next"
 ],
 "use_when": [
  "You have discussion exports and a focused customer or product question.",
  "You have Reddit posts or comments to review, or an approved reader that can access the named public sources.",
  "You want to compare public company or market discussion without treating sentiment as verified fact.",
  "You need counts and source locators alongside a short research brief."
 ],
 "skip_when": [
  "You need market size or how common a view is across all customers: run a survey, or check your own sales and usage data.",
  "You want investment advice or a price forecast from online talk: ask a licensed financial adviser.",
  "You have no posts, files or approved sources to review: gather a few first, or interview some customers yourself."
 ],
 "output_sample": {
  "input": [
   "Your research question and what you will use it for",
   "Posts, comments, files or exports to review",
   "Date range and sources to include",
   "Terms, groups or exclusions to leave out (optional)"
  ],
  "prerequisites": [
   "An AI that can read your files or pasted text",
   "A reader tool you approve, only if you want it to open public pages"
  ],
  "output": [
   {
    "name": "Question and scope",
    "contains": "Your exact question, date window, sources and how the material was collected."
   },
   {
    "name": "Answer",
    "contains": "A short direct reply, limited to what the sample can support."
   },
   {
    "name": "Evidence table",
    "contains": "One row per finding with ID, date, source locator, type, theme, quote and caveat."
   },
   {
    "name": "Counts",
    "contains": "Records checked, repeats removed and theme counts, each with the total used."
   },
   {
    "name": "Conflicts and limits",
    "contains": "Views that disagree, who is missing, access gaps and sample bias."
   },
   {
    "name": "Next useful evidence",
    "contains": "The smallest extra source or question that would cut the main doubt."
   }
  ]
 },
 "output_shape": "Question and scope\nAnswer limited to the available sample\nEvidence table: ID | date | locator | type | theme | quote or paraphrase | caveat\nCounts and denominator\nConflicts, sample limits, gaps, next useful evidence",
 "how_to_use": [
  "Write your question, the date window and the sources to include.",
  "Paste or attach your posts, comments or files. For public pages, use a reader tool you have approved in your AI.",
  "Know that public page access depends on that tool's rules and any paid use. The skill will not run paid tools without asking.",
  "Check the evidence table. Make sure each quote matches its source and each count adds up.",
  "Use the findings only for this sample. For next steps, run a survey or check a deduplicated feedback export."
 ],
 "checks": [
  "Every quote matches inspected source text and has a locator.",
  "Counts can be checked using record IDs, rules for repeats and the stated total.",
  "Facts, participant opinions and researcher inferences are distinct.",
  "Conflicting evidence, selection bias, access gaps and unknowns are stated.",
  "Company research makes no personalized investment recommendation or return promise."
 ],
 "next": [
  {
   "name": "Community needs research planner",
   "url": "https://useaiblocks.com/skills/community-needs-research-planner",
   "why": "Community needs research planner"
  }
 ],
 "source": null,
 "credits": [],
 "files": [
  "check-examples.mjs",
  "examples/company-discussion.json",
  "examples/customer-threads.json",
  "LICENSE",
  "provenance-review.json"
 ],
 "links": {
  "page": "https://useaiblocks.com/skills/community-evidence-researcher",
  "markdown": "https://useaiblocks.com/skills/community-evidence-researcher.md",
  "json": "https://useaiblocks.com/skills/community-evidence-researcher.json",
  "instructions": "https://useaiblocks.com/skills/community-evidence-researcher/SKILL.md",
  "download": "https://useaiblocks.com/skills/community-evidence-researcher.zip",
  "api_item": "https://useaiblocks.com/api/v1/items/community-evidence-researcher",
  "api_document": "https://useaiblocks.com/api/v1/documents/skill/community-evidence-researcher",
  "mcp": "https://useaiblocks.com/mcp"
 }
}