{
 "schema": "aiblocks-page/1",
 "id": "community-workshop-guide-builder",
 "type": "skill",
 "name": "Community workshop guide builder",
 "summary": "Share a community goal and local facts. Get practical activities, worksheets, and clear notes for the host.",
 "headline": "Community workshop guide builder",
 "subhead": "Share a community goal, local facts, and time available. The skill designs useful activities, then drafts editable worksheets and facilitator notes. It marks local roles and facts that still need review, so the host can confirm details before the workshop.",
 "job": {
  "id": "teach-and-train",
  "name": "Teach and train people"
 },
 "level": "intermediate",
 "thinking": "high",
 "tested": true,
 "updated": "2026-11-03",
 "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": "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"
  },
  {
   "type": "document",
   "required": false,
   "label": "Document",
   "what": "a finished document, such as a Word file, a PDF or a page of notes"
  }
 ],
 "outputs": [
  {
   "type": "document",
   "required": true,
   "label": "Document",
   "what": "a finished document, such as a Word file, a PDF or a page of notes"
  }
 ],
 "you_give": [
  "Community and goal, local evidence, available time, participation needs, and any existing guide."
 ],
 "you_get": [
  "A workshop guide or focused revision, worksheets, host notes, and maintenance details where needed."
 ],
 "use_when": [],
 "skip_when": [
  "You want a travel guide or visitor plan for a place: use a travel writer or a local tourism office.",
  "You only need a document formatted or turned into a PDF: use your word processor or a simple formatting step.",
  "A real emergency is happening now: call local emergency services. This tool does not direct live incidents."
 ],
 "output_sample": {
  "input": [
   "Your community and the goal you share",
   "Local facts you already have, like surveys or notes from residents",
   "How much time you have and how you will meet",
   "Access needs, like paper copies or other languages",
   "An existing guide to adapt or revise (optional)"
  ],
  "prerequisites": [
   "An AI that can read the skill folder and its reference files",
   "Python 3.10 or newer, only if you want the optional plan checker to run"
  ],
  "output": [
   {
    "name": "Community brief",
    "contains": "Who the guide serves, the goal, local setting, time, medium, owner, and which voices are still missing."
   },
   {
    "name": "Participant worksheet",
    "contains": "Short fields that turn each activity into a decision, map, plan or other usable result."
   },
   {
    "name": "Facilitator notes",
    "contains": "Timings, preparation, supplies, instructions, debrief questions, completion checks and fallbacks for each activity."
   },
   {
    "name": "Sources and adaptation notes",
    "contains": "Where local facts came from, what was changed for this community, and what still needs checking."
   },
   {
    "name": "Maintenance record",
    "contains": "Who owns the guide, when to review it, and how feedback leads to changes."
   }
  ]
 },
 "how_to_use": [
  "Add the downloaded skill folder to an AI that can read its reference files.",
  "Give the community, shared goal, time available, local facts, and access needs.",
  "For one short session, ask for only a brief participant worksheet and separate host notes. Set a length limit if needed. Expect the pieces in this order: the brief, the activities, the worksheet, then the host notes.",
  "Check that section names, timings, and worksheet fields agree. Keep roles proposed until someone accepts them; review drafts before use.",
  "After the first run, give the worksheet and host notes to the person who will host. Try the session with a few community members, then revise from what they say."
 ],
 "checks": [],
 "next": [
  {
   "name": "Backwards unit planner",
   "url": "https://useaiblocks.com/skills/backwards-unit-planner",
   "why": "Backwards unit planner"
  },
  {
   "name": "Perspective-taking activity builder",
   "url": "https://useaiblocks.com/skills/perspective-taking-activity",
   "why": "Perspective-taking activity builder"
  }
 ],
 "source": {
  "by": "Magnus Hedemark",
  "repo": "magnus919/agent-skills",
  "url": "https://github.com/magnus919/agent-skills/tree/92c327e525da69c9ad3812fd223a1770e977c2e3/community-guides",
  "licence": "MIT",
  "original_name": "community-guides",
  "commit": "92c327e525da69c9ad3812fd223a1770e977c2e3"
 },
 "credits": [
  {
   "title": "community-guides skill",
   "by": "Magnus Hedemark",
   "url": "https://github.com/magnus919/agent-skills/tree/92c327e525da69c9ad3812fd223a1770e977c2e3/community-guides",
   "used": "Copied under the MIT licence. We gave it a plain name. We added Before you start and After this sections that link to other AI Blocks steps. We refreshed those generated sections from the catalogue inputs and next-step links."
  }
 ],
 "files": [
  "evals/evals.json",
  "evals/files/absent-residents.json",
  "evals/files/conflicting-sources.json",
  "evals/files/garden-seasonal-care.json",
  "evals/files/multilingual-renters-outage.json",
  "evals/files/participant-feedback.json",
  "evals/files/rural-offline.json",
  "evals/files/sparse-brief.json",
  "evals/files/workshop-45-minute.json",
  "evals/trigger-queries.json",
  "examples/apartment-facilitator.md",
  "examples/apartment-guide.md",
  "examples/apartment-plan.json",
  "LICENSE.md",
  "README.md",
  "references/facilitation.md",
  "references/guide-plan.md",
  "references/localization.md",
  "references/review.md",
  "references/source-pattern.md",
  "scripts/test_validate_guide.py",
  "scripts/validate_guide.py",
  "templates/community-brief.md",
  "templates/facilitator.md",
  "templates/maintenance.md",
  "templates/module.md",
  "templates/revision.md",
  "templates/worksheet.md"
 ],
 "links": {
  "page": "https://useaiblocks.com/skills/community-workshop-guide-builder",
  "markdown": "https://useaiblocks.com/skills/community-workshop-guide-builder.md",
  "json": "https://useaiblocks.com/skills/community-workshop-guide-builder.json",
  "instructions": "https://useaiblocks.com/skills/community-workshop-guide-builder/SKILL.md",
  "download": "https://useaiblocks.com/skills/community-workshop-guide-builder.zip",
  "api_item": "https://useaiblocks.com/api/v1/items/community-workshop-guide-builder",
  "api_document": "https://useaiblocks.com/api/v1/documents/skill/community-workshop-guide-builder",
  "mcp": "https://useaiblocks.com/mcp"
 }
}