Directly execute GraphQL queries and mutations against Linear for advanced issue and project state management.

Install

mkdir -p .claude/skills/linear-sushaantu && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/15441" && unzip -o skill.zip -d .claude/skills/linear-sushaantu && rm skill.zip

Installs to .claude/skills/linear-sushaantu

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Use Symphony's `linear_graphql` client tool for raw Linear GraphQL operations such as comment editing and status updates.
121 charsno explicit “when” trigger
Intermediate

Key capabilities

  • Perform raw Linear GraphQL operations.
  • Query an issue by key.
  • Query a team's workflow states.
  • Update an issue state.
  • Update an existing comment.

How it works

The skill uses the `linear_graphql` client tool to execute GraphQL queries and mutations against the Linear API. It reuses Symphony's configured Linear authentication.

Inputs & outputs

You give it
GraphQL query or mutation document with optional variables
You get back
Result of the GraphQL operation or an error array

When to use linear

  • Update issue state
  • Modify Linear comment
  • Query team workflow states

About this skill

Linear GraphQL

Use this skill for raw Linear GraphQL work during Symphony app-server sessions.

Primary tool

Use the linear_graphql client tool exposed by Symphony's app-server session. It reuses Symphony's configured Linear auth for the session.

Tool input:

{
  "query": "query or mutation document",
  "variables": {
    "optional": "graphql variables object"
  }
}

Operating rules

  • Send one GraphQL operation per tool call.
  • Treat a top-level errors array as a failed GraphQL operation even if the tool call itself completed.
  • Keep queries and mutations narrowly scoped.

Common workflows

Query an issue by key

query IssueByKey($key: String!) {
  issue(id: $key) {
    id
    identifier
    title
    url
    description
    branchName
    state {
      id
      name
      type
    }
    project {
      id
      name
    }
  }
}

Query a team's workflow states

query IssueTeamStates($id: String!) {
  issue(id: $id) {
    id
    team {
      id
      key
      name
      states {
        nodes {
          id
          name
          type
        }
      }
    }
  }
}

Update an issue state

mutation MoveIssue($id: String!, $stateId: String!) {
  issueUpdate(id: $id, input: { stateId: $stateId }) {
    success
    issue {
      id
      identifier
      state {
        id
        name
      }
    }
  }
}

Update an existing comment

mutation UpdateComment($id: String!, $body: String!) {
  commentUpdate(id: $id, input: { body: $body }) {
    success
    comment {
      id
      body
    }
  }
}

When not to use it

  • When the task requires operations outside of Linear GraphQL.
  • When multiple GraphQL operations need to be sent in a single tool call.
  • When the `linear_graphql` client tool is not available.

Limitations

  • Sends one GraphQL operation per tool call.
  • Treats a top-level `errors` array as a failed GraphQL operation.
  • Requires queries and mutations to be narrowly scoped.

How it compares

This skill provides a direct interface for Linear GraphQL, allowing fine-grained control over Linear data compared to higher-level abstractions.

Compared to similar skills

linear side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
linear (this skill)02moNo flagsIntermediate
linear-core-workflow-b11moReviewIntermediate
agile-product-owner108moReviewBeginner
company-os23moNo flagsIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

You might also like

linear-core-workflow-b

jeremylongshore

Project and cycle management workflows with Linear. Use when implementing sprint planning, managing projects and roadmaps, or organizing work into cycles. Trigger with phrases like "linear project", "linear cycle", "linear sprint", "linear roadmap", "linear planning", "organize linear work".

10

agile-product-owner

davila7

Agile product ownership toolkit for Senior Product Owner including INVEST-compliant user story generation, sprint planning, backlog management, and velocity tracking. Use for story writing, sprint planning, stakeholder communication, and agile ceremonies.

1057

company-os

alirezarezvani

The meta-framework for how a company runs — the connective tissue between all C-suite roles. Covers operating system selection (EOS, Scaling Up, OKR-native, hybrid), accountability charts, scorecards, meeting pulse, issue resolution, and 90-day rocks. Use when setting up company operations, selecting a management framework, designing meeting rhythms, building accountability systems, implementing OKRs, or when user mentions EOS, Scaling Up, operating system, L10 meetings, rocks, scorecard, accountability chart, or quarterly planning.

212

gsd-planner

toonight

Creates executable phase plans with task breakdown, dependency analysis, and goal-backward verification

12

agency-studio-producer

iFrescoo

Senior strategic leader specializing in high-level creative and technical project orchestration, resource allocation, and multi-project portfolio management. Focused on aligning creative vision with business objectives while managing complex cross-functional initiatives and ensuring optimal studio o

00

nextcloud-cli-deck

NicholaiVogel

Work with the Nextcloud Deck app through Nextcloud CLI. Use when an agent needs to list boards and cards, create boards or stacks, create or update cards, move cards, archive or delete cards safely, validate Deck availability, or perform dry-run protected project-board workflows with nxc.

00

Search skills

Search the agent skills registry