Skip to main content
linear-core-workflow-a Issue lifecycle management with Linear: create, update, transition,
relate, comment, and organize issues through the SDK and GraphQL API.
Trigger: "linear issue workflow", "linear issue lifecycle",
"create linear issues", "update linear issue", "linear state transition",
"linear sub-issues", "linear comments".
インストールへ移動 Skills Marketplace コミュニティが作成したAIスキルを発見・探索
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/jeremylongshore/claude-code-plugins-plus-skills --skill linear-core-workflow-aコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
Zipをダウンロード ダウンロード中... jeremylongshore
jeremylongshore/claude-code-plugins-plus-skills
GitHub リポジトリを開く name linear-core-workflow-a description Issue lifecycle management with Linear: create, update, transition,
relate, comment, and organize issues through the SDK and GraphQL API.
Trigger: "linear issue workflow", "linear issue lifecycle",
"create linear issues", "update linear issue", "linear state transition",
"linear sub-issues", "linear comments".
allowed-tools Read, Write, Edit, Grep version 1.12.0 license MIT author Jeremy Longshore <jeremy@intentsolutions.io> tags ["saas","linear","workflow"] compatibility Designed for Claude Code, also compatible with Codex and OpenClaw
Linear Core Workflow A: Issue Lifecycle
Overview
Master issue lifecycle management: creating, updating, transitioning states, building parent/sub-issue hierarchies, managing labels, and commenting. Linear issues flow through typed workflow states (triage -> backlog -> unstarted -> started -> completed | canceled), belong to a team, and support priorities 0-4, estimates, due dates, labels, and cycle/project assignment.
Prerequisites
@linear/sdk installed with API key or OAuth token configuredAccess to target team(s)
Understanding of your team's workflow states
Instructions
Step 1: Create Issues
import { LinearClient } from "@linear/sdk" ;
const client = new LinearClient ({ apiKey : process.env .LINEAR_API_KEY ! });
const teams = await client.teams ();
const team = teams.nodes .find (t =>key === "ENG" ) ?? teams.nodes [0 ];
const result = await client.createIssue ({
teamId : team.id ,
title : "Implement user authentication" ,
description : "Add OAuth 2.0 login flow with Google and GitHub providers." ,
priority : 2 ,
if
success
const
await
issue
console
log
`Created: ${issue?.identifier} — ${issue?.title} `
console
log
`URL: ${issue?.url} `
const
await
issueLabels
filter
name
eq
"Bug"
const
nodes
0
const
await
states
const
nodes
find
s =>
type
"unstarted"
await
createIssue
teamId
id
title
"Fix login redirect loop on Safari"
description
"Users get stuck in infinite redirect after SSO callback."
priority
1
stateId
id
assigneeId
"user-uuid"
labelIds
id
estimate
3
dueDate
"2026-04-15"
Step 2: Update Issues
await client.updateIssue ("issue-uuid" , {
title : "Updated title" ,
priority : 1 ,
estimate : 5 ,
dueDate : "2026-04-30" ,
});
const issues = await client.issues ({
filter : { number : { eq : 123 }, team : { key : { eq : "ENG" } } },
});
const issue = issues.nodes [0 ];
if (issue) {
await issue.update ({
priority : 2 ,
description : "Updated description with more details." ,
});
}
const featureLabel = (await client.issueLabels ({
filter : { name : { eq : "Feature" } },
})).nodes [0 ];
if (featureLabel) {
await client.updateIssue (issue.id , {
labelIds : [...(issue.labelIds ?? []), featureLabel.id ],
});
}
Step 3: State Transitions
const teamStates = await team.states ();
for (const state of teamStates.nodes ) {
console .log (`${state.name} (type: ${state.type } , position: ${state.position} )` );
}
const inProgress = teamStates.nodes .find (s =>name === "In Progress" );
if (inProgress) {
await client.updateIssue (issue.id , { stateId : inProgress.id });
}
const done = teamStates.nodes .find (s =>type === "completed" );
if (done) {
await issue.update ({ stateId : done.id });
}
Step 4: Parent/Sub-Issue Hierarchy
const parentResult = await client.createIssue ({
teamId : team.id ,
title : "Auth system overhaul" ,
description : "Epic: modernize authentication infrastructure." ,
});
const parent = await parentResult.issue ;
await client.createIssue ({
teamId : team.id ,
title : "Implement JWT token refresh" ,
parentId : parent!.id ,
priority : 2 ,
});
await client.createIssue ({
teamId : team.id ,
title : "Add MFA support" ,
parentId : parent!.id ,
priority : 3 ,
});
const children = await parent!.children ();
for (const child of children.nodes ) {
console .log (` Sub: ${child.identifier} — ${child.title} ` );
}
Step 5: Issue Relations
await client.createIssueRelation ({
issueId : "blocked-issue-id" ,
relatedIssueId : "blocking-issue-id" ,
type : "blocks" ,
});
await client.createIssueRelation ({
issueId : "duplicate-issue-id" ,
relatedIssueId : "original-issue-id" ,
type : "duplicate" ,
});
const relations = await issue.relations ();
for (const rel of relations.nodes ) {
const related = await rel.relatedIssue ;
console .log (`${rel.type } : ${related?.identifier} ` );
}
Step 6: Comments
await client.createComment ({
issueId : issue.id ,
body : "Deployed fix to staging.\n\n```bash\nnpm run test:e2e -- --filter auth\n```\n\nAll 47 tests passing." ,
});
const comments = await issue.comments ();
for (const comment of comments.nodes ) {
const user = await comment.user ;
console .log (`${user?.name} : ${comment.body.substring(0 , 80 )} ...` );
}
Step 7: Attachments
await client.createAttachment ({
issueId : issue.id ,
title : "Figma Design" ,
url : "https://figma.com/file/xxx" ,
subtitle : "Login page redesign" ,
});
Error Handling Error Cause Solution Entity not foundInvalid issue ID or deleted Verify with client.issue(id) first State not foundWrong team's state ID List states for correct team: team.states() Validation error on createMissing required field teamId + title required; priority must be 0-4Circular dependencyIssue blocks itself transitively Validate relation graph before creating ForbiddenNo write access to team Check team membership and API key scope
Examples
Bulk Create from CSV import { parse } from "csv-parse/sync" ;
import fs from "fs" ;
const rows = parse (fs.readFileSync ("issues.csv" ), { columns : true });
for (const row of rows) {
const result = await client.createIssue ({
teamId : team.id ,
title : row.title ,
description : row.description ,
priority : parseInt (row.priority ) || 3 ,
});
const issue = await result.issue ;
console .log (`Created: ${issue?.identifier} ` );
}
Close Stale Issues const stale = await client.issues ({
filter : {
state : { type : { in : ["unstarted" , "started" ] } },
updatedAt : { lt : new Date (Date .now () - 90 * 24 * 60 * 60 * 1000 ).toISOString () },
},
first : 50 ,
});
const canceled = (await team.states ()).nodes .find (s =>type === "canceled" )!;
for (const issue of stale.nodes ) {
await issue.update ({ stateId : canceled.id });
await client.createComment ({
issueId : issue.id ,
body : "Auto-closed: no activity for 90 days." ,
});
console .log (`Closed: ${issue.identifier} (last updated ${issue.updatedAt} )` );
}
Resources 