{
 "schema": "aiblocks-page/1",
 "id": "gorgias-to-linear-issue-handover",
 "type": "skill",
 "name": "Gorgias to Linear issue planner",
 "summary": "Share a support ticket or problem. Review a Linear issue draft and Slack alert, then approve the handover.",
 "headline": "Gorgias to Linear issue planner",
 "subhead": "Use a Composio setup linked to Linear and Slack, plus Gorgias for ticket input. It gathers the known problem, finds a team and channel, and shows both drafts for approval. It then creates the issue and uses its returned link in the alert. Check each result separately; an issue may exist even if the Slack step fails.",
 "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": false,
   "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 or a clear problem description.",
  "The intended Linear team and Slack channel."
 ],
 "you_get": [
  "A plan to approve first, with the issue title, team, priority and Slack message.",
  "A Linear issue created after you approve.",
  "A Slack alert that includes the Linear issue link.",
  "A short report with the links and next steps."
 ],
 "use_when": [
  "A Gorgias ticket describes a bug that engineering must fix.",
  "A customer problem needs a Linear issue and a heads-up to your team in Slack.",
  "A teammate describes a problem and you need it logged with the right team and priority."
 ],
 "skip_when": [
  "Routine customer replies or refunds: answer them in Gorgias, where your support team already works.",
  "You have no Composio access or connected Gorgias, Linear and Slack accounts: write the issue and Slack message by hand.",
  "The problem is not for engineering: tell the right team in Slack directly, with no Linear issue."
 ],
 "output_sample": {
  "input": [
   "A Gorgias ticket number, or a short description of the problem",
   "The Linear team that should get the issue (optional)",
   "The Slack channel for the alert (optional)"
  ],
  "prerequisites": [
   "An AI that can run Composio CLI commands",
   "Gorgias, Linear and Slack accounts connected to Composio"
  ],
  "output": [
   {
    "name": "Escalation Plan",
    "contains": "The ticket source, subject and customer, the proposed Linear team, title, priority and description, and a preview of the Slack message."
   },
   {
    "name": "Linear issue",
    "contains": "A new issue made only after you say yes, using the team, title, priority and description you approved."
   },
   {
    "name": "Slack notification",
    "contains": "A message in your chosen channel with the ticket reference, customer, issue summary, priority and the Linear issue link."
   },
   {
    "name": "Escalation Complete",
    "contains": "The Linear issue link, the Slack channel it was sent to, the original ticket number and suggested next steps."
   }
  ]
 },
 "how_to_use": [
  "Use an AI that can run Composio CLI commands, with Gorgias, Linear and Slack connected to Composio.",
  "Open the skill folder in your AI and ask it to run escalate.",
  "Give it a Gorgias ticket number, or describe the problem in a few sentences.",
  "Read the Escalation Plan. Fix the team, title, priority or message if needed.",
  "Say yes. Nothing is created or posted until you do.",
  "Open the Linear issue from the report. Update the Gorgias ticket once the issue is fixed."
 ],
 "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/escalate",
  "licence": "MIT",
  "original_name": "escalate",
  "commit": "83382c4b055fc4e5b055044adb5bfb7585484c9a"
 },
 "credits": [
  {
   "title": "escalate skill",
   "by": "Composio",
   "url": "https://github.com/composio-community/support-skills/tree/83382c4b055fc4e5b055044adb5bfb7585484c9a/escalate",
   "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-to-linear-issue-handover",
  "markdown": "https://useaiblocks.com/skills/gorgias-to-linear-issue-handover.md",
  "json": "https://useaiblocks.com/skills/gorgias-to-linear-issue-handover.json",
  "instructions": "https://useaiblocks.com/skills/gorgias-to-linear-issue-handover/SKILL.md",
  "download": "https://useaiblocks.com/skills/gorgias-to-linear-issue-handover.zip",
  "api_item": "https://useaiblocks.com/api/v1/items/gorgias-to-linear-issue-handover",
  "api_document": "https://useaiblocks.com/api/v1/documents/skill/gorgias-to-linear-issue-handover",
  "mcp": "https://useaiblocks.com/mcp"
 }
}