Menu
Use Symphony's linear_graphql client tool for raw Linear GraphQL operations such as comment editing, state transitions, and uploads.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | linear |
| description | Use Symphony's linear_graphql client tool for raw Linear GraphQL operations such as comment editing, state transitions, and uploads. |
Use the linear_graphql tool exposed by Symphony's app-server session for raw Linear API access.
{
"query": "query or mutation document",
"variables": { "optional": "graphql variables" }
}
One operation per call. Top-level errors array means the operation failed.
query IssueByKey($key: String!) {
issue(id: $key) {
id identifier title
state { id name }
project { id name }
url description
}
}
query IssueTeamStates($id: String!) {
issue(id: $id) {
team {
states { nodes { id name type } }
}
}
}
mutation MoveIssue($id: String!, $stateId: String!) {
issueUpdate(id: $id, input: { stateId: $stateId }) {
success
issue { id identifier state { name } }
}
}
mutation CreateComment($issueId: String!, $body: String!) {
commentCreate(input: { issueId: $issueId, body: $body }) {
success
comment { id url }
}
}
mutation UpdateComment($id: String!, $body: String!) {
commentUpdate(id: $id, input: { body: $body }) {
success
comment { id body }
}
}
mutation AttachPR($issueId: String!, $url: String!, $title: String) {
attachmentLinkGitHubPR(issueId: $issueId, url: $url, title: $title, linkKind: links) {
success
attachment { id url }
}
}
query ListMutations {
__type(name: "Mutation") { fields { name } }
}
query InspectInput($name: String!) {
__type(name: $name) {
inputFields { name type { kind name ofType { kind name } } }
}
}
After pushing a PR, move the issue to In Review so the orchestrator stops re-dispatching:
stateId for "In Review".mutation MoveIssue($id: String!, $stateId: String!) {
issueUpdate(id: $id, input: { stateId: $stateId }) {
success
issue { id identifier state { name } }
}
}
"In Review" is a non-active, non-terminal state. The orchestrator will stop the agent but keep the workspace intact for human review.
linear_graphql for all Linear API access. Do not use raw tokens in shell commands.stateId.attachmentLinkGitHubPR over generic URL attachment for PRs.Create a well-formed git commit from current changes using session history for rationale and summary; use when asked to commit, prepare a commit message, or finalize staged work.
Investigate stuck runs and execution failures by tracing Symphony logs with issue/session identifiers; use when runs stall, retry repeatedly, or fail unexpectedly.
Land a PR by monitoring conflicts, resolving them, waiting for checks, and squash-merging when green; use when asked to land, merge, or shepherd a PR to completion.
Pull latest origin/main into the current branch and resolve merge conflicts. Use when Codex needs to sync a feature branch with origin before pushing.
Push current branch to origin and create or update the PR; use when asked to push, publish updates, or create a pull request.
Set up, configure, run, and troubleshoot symphony-go — an autonomous agent orchestrator that polls Linear issues and runs Codex sessions. Use when the user asks to install symphony, create a WORKFLOW.md, configure Linear integration, start the orchestrator, debug stuck agents, fix failing hooks, tune retry/backoff, set up workspaces, or any task related to running symphony-go in a repository.