{
 "schema": "aiblocks-page/1",
 "id": "gorgias-bug-report-writer",
 "type": "skill",
 "name": "Gorgias bug report writer",
 "summary": "Share a Gorgias ticket. Get a bug report with known steps, evidence and missing details, then choose whether to create a Linear issue.",
 "headline": "Gorgias bug report writer",
 "subhead": "Use a Composio setup linked to Gorgias and share the ticket number. It reads the thread and separates expected behaviour, reported behaviour, evidence and gaps. Get a bug report to review. If you approve creating a Linear issue, it asks for the team, creates the issue and returns its link. Missing steps and impact stay marked for follow-up.",
 "job": {
  "id": "help-customers",
  "name": "Help your customers"
 },
 "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": "tool_connection",
   "required": true,
   "label": "Tool connection",
   "what": "an AI connected to an outside tool or service, such as an MCP server"
  }
 ],
 "outputs": [
  {
   "type": "audit_report",
   "required": true,
   "label": "Audit report",
   "what": "findings with evidence, severity, missing inputs and next actions"
  }
 ],
 "you_give": [
  "A Gorgias ticket number for a reported bug.",
  "The Linear team that should get the issue (optional)."
 ],
 "you_get": [
  "A bug report with title, steps, expected and actual results, impact and quoted evidence.",
  "A list of details missing from the ticket, and what to ask the customer.",
  "A Linear issue link, only after you approve the report and pick the team (optional)."
 ],
 "use_when": [
  "A customer writes in about something broken and your engineers need a clear report.",
  "A ticket thread has grown long and nobody has pulled out the steps to reproduce.",
  "You want to hand a bug to engineering without retyping the customer's words.",
  "You need to know what to ask the customer before the bug can be fixed."
 ],
 "skip_when": [
  "The ticket is a feature request or a billing question: reply to the customer yourself or ask a support lead, since this tool only reads bug reports.",
  "You have no Composio access to Gorgias or Linear: paste the ticket text into your AI and ask for a bug report by hand.",
  "You want a bug fixed or the cause found: send the finished report to your engineers, because this tool only writes the report."
 ],
 "output_sample": {
  "input": [
   "Your Gorgias ticket number for a reported bug",
   "Which Linear team should get the issue (optional, only if you create one)"
  ],
  "prerequisites": [
   "An AI that can run Composio CLI commands",
   "Gorgias connected through Composio",
   "Linear connected through Composio (only to create an issue)"
  ],
  "output": [
   {
    "name": "Bug Report header",
    "contains": "The ticket source, reporter, date reported and a severity rating of Critical, High, Medium or Low."
   },
   {
    "name": "Title and Description",
    "contains": "A clear bug title, not the ticket subject, and a one or two sentence summary."
   },
   {
    "name": "Steps to Reproduce",
    "contains": "Numbered steps taken from the customer thread, with gaps flagged as missing."
   },
   {
    "name": "Expected Behavior and Actual Behavior",
    "contains": "What should have happened, next to what the customer says happened."
   },
   {
    "name": "Environment and Evidence",
    "contains": "Browser, system, account details, quoted error messages, and screenshots or IDs the customer mentioned."
   },
   {
    "name": "Impact",
    "contains": "How many users are affected, whether a workaround exists, and any revenue impact if it can be found."
   },
   {
    "name": "Additional Context",
    "contains": "Other useful details from the thread, plus a list of missing information to ask the customer for."
   },
   {
    "name": "Linear issue link",
    "contains": "Only if you approve: a new issue in the team you pick, with the full report inside."
   }
  ]
 },
 "how_to_use": [
  "Use an AI that can run commands and read skill files. Install Composio CLI and connect Gorgias. Connect Linear too if you want an issue.",
  "Add the downloaded folder to your AI and ask it to run the Gorgias bug report writer.",
  "Give it the ticket number of a bug report. Say which ticket it is.",
  "Read the report. Check the steps and the missing details, and fix anything that looks wrong.",
  "If you want a Linear issue, say yes and pick the team. Nothing is created before you approve.",
  "If a step says Gorgias is not connected, run the link command your AI shows, then try again."
 ],
 "checks": [],
 "next": [
  {
   "name": "Support issue cause investigator",
   "url": "https://useaiblocks.com/skills/support-issue-cause-investigator",
   "why": "Support issue cause investigator"
  },
  {
   "name": "Escalation brief writer",
   "url": "https://useaiblocks.com/skills/escalation-brief-writer",
   "why": "Escalation brief writer"
  },
  {
   "name": "Support ticket help article writer",
   "url": "https://useaiblocks.com/skills/solved-ticket-help-page-writer",
   "why": "Support ticket help article writer"
  }
 ],
 "source": {
  "by": "Composio",
  "repo": "composio-community/support-skills",
  "url": "https://github.com/composio-community/support-skills/tree/83382c4b055fc4e5b055044adb5bfb7585484c9a/bug-report",
  "licence": "MIT",
  "original_name": "bug-report",
  "commit": "83382c4b055fc4e5b055044adb5bfb7585484c9a"
 },
 "credits": [
  {
   "title": "bug-report skill",
   "by": "Composio",
   "url": "https://github.com/composio-community/support-skills/tree/83382c4b055fc4e5b055044adb5bfb7585484c9a/bug-report",
   "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."
  }
 ],
 "files": [
  "README.md"
 ],
 "links": {
  "page": "https://useaiblocks.com/skills/gorgias-bug-report-writer",
  "markdown": "https://useaiblocks.com/skills/gorgias-bug-report-writer.md",
  "json": "https://useaiblocks.com/skills/gorgias-bug-report-writer.json",
  "instructions": "https://useaiblocks.com/skills/gorgias-bug-report-writer/SKILL.md",
  "download": "https://useaiblocks.com/skills/gorgias-bug-report-writer.zip",
  "api_item": "https://useaiblocks.com/api/v1/items/gorgias-bug-report-writer",
  "api_document": "https://useaiblocks.com/api/v1/documents/skill/gorgias-bug-report-writer",
  "mcp": "https://useaiblocks.com/mcp"
 }
}