{ "schema": "aiblocks-page/1", "id": "support-issue-cause-investigator", "type": "skill", "name": "Support issue cause investigator", "summary": "Find the root cause of a support issue. Give it 3 or more related tickets and get the shared pattern, a likely cause, evidence and a fix plan.", "headline": "Support issue cause investigator", "subhead": "Give it related support tickets, a topic, or pasted issue notes. It looks for what they share and asks why again and again until it finds a likely cause. You get the evidence, the impact, and fixes to check with the right team.", "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": "voc_reviews", "required": true, "label": "Voc reviews", "what": "customer words from reviews, tickets, surveys or calls, with source and date" }, { "type": "tool_connection", "required": false, "label": "Tool connection", "what": "an AI connected to an outside tool or service, such as an MCP server" }, { "type": "audit_report", "required": false, "label": "Audit report", "what": "findings with evidence, severity, missing inputs and next actions" } ], "outputs": [ { "type": "audit_report", "required": true, "label": "Audit report", "what": "findings with evidence, severity, missing inputs and next actions" } ], "you_give": [ "Related ticket numbers, a topic, or pasted issue descriptions.", "Dates, common errors or known workarounds (optional)." ], "you_get": [ "A likely root cause, stated in specific terms.", "An evidence table that shows what each ticket tells you.", "An impact summary, with Unknown where your data has no number.", "Fixes listed by priority and owner.", "A temporary workaround agents can share." ], "use_when": [ "Three or more tickets seem to describe the same problem.", "A complaint keeps coming back and you don't know why.", "You need to tell engineering what is broken, with proof.", "Agents need a workaround while a fix is built." ], "skip_when": [ "You have one ticket or a one-off bug: write a normal reply to that customer instead.", "You need a fast answer for a single customer: reply to them directly, then come back if more tickets arrive.", "You have no ticket text or data to share: gather a few examples first, or ask a teammate who has seen the issue." ], "output_sample": { "input": [ "Related Gorgias ticket numbers, a topic, or pasted issue descriptions", "Dates, common errors or known workarounds (optional)" ], "prerequisites": [ "Live ticket lookups need Composio CLI with your Gorgias account connected. Pasted text works without it." ], "output": [ { "name": "Issue Cluster", "contains": "How many tickets were checked, the time range, and which customers are affected." }, { "name": "Symptom", "contains": "What customers see and report, in plain words." }, { "name": "Root Cause", "contains": "The specific underlying problem your AI thinks is behind the tickets." }, { "name": "Five Whys Chain", "contains": "A chain of why questions from the symptom down to the root cause." }, { "name": "Evidence", "contains": "A table of data points and what each one shows." }, { "name": "Impact", "contains": "Customers affected, ticket volume, revenue impact and trend. Anything not in your data is marked Unknown." }, { "name": "Recommendations", "contains": "A table of fixes with priority, owner and expected impact." }, { "name": "Workaround", "contains": "Steps agents can give customers until the fix is live." } ] }, "how_to_use": [ "Open Claude, ChatGPT or Gemini and paste in the skill text from the page.", "Paste your ticket descriptions. Or give ticket numbers if Composio CLI and Gorgias are connected. Live lookup needs your own Gorgias account and a Composio account with the Gorgias connection, and either may cost money depending on the plan, so check before you start. Pasted text needs neither.", "Add dates, errors or workarounds you know about.", "Check the evidence table against your tickets. Make sure each claim has a source.", "Send the fixes to the teams that own them and ask them to confirm the cause before acting.", "Next, update the help article with the solved ticket help page writer, or send a customer reply with the customer reply drafter. For a software bug you have already pinned down, use the bug root cause finder." ], "checks": [], "next": [ { "name": "Support ticket help article writer", "url": "https://useaiblocks.com/skills/solved-ticket-help-page-writer", "why": "Support ticket help article writer" }, { "name": "Customer reply drafter", "url": "https://useaiblocks.com/skills/customer-reply-drafter", "why": "Customer reply drafter" } ], "source": { "by": "Composio", "repo": "composio-community/support-skills", "url": "https://github.com/composio-community/support-skills/tree/83382c4b055fc4e5b055044adb5bfb7585484c9a/root-cause", "licence": "MIT", "original_name": "root-cause", "commit": "83382c4b055fc4e5b055044adb5bfb7585484c9a" }, "credits": [ { "title": "root-cause skill", "by": "Composio", "url": "https://github.com/composio-community/support-skills/tree/83382c4b055fc4e5b055044adb5bfb7585484c9a/root-cause", "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/support-issue-cause-investigator", "markdown": "https://useaiblocks.com/skills/support-issue-cause-investigator.md", "json": "https://useaiblocks.com/skills/support-issue-cause-investigator.json", "instructions": "https://useaiblocks.com/skills/support-issue-cause-investigator/SKILL.md", "download": "https://useaiblocks.com/skills/support-issue-cause-investigator.zip", "api_item": "https://useaiblocks.com/api/v1/items/support-issue-cause-investigator", "api_document": "https://useaiblocks.com/api/v1/documents/skill/support-issue-cause-investigator", "mcp": "https://useaiblocks.com/mcp" } }