Linear Issue Workflow

Automates the complete workflow for working on Linear issues: fetch issue, update status, create branch, implement, test, create PR, and mark for review.

Usage

/linear-issue MEG-5

Or simply:

/linear-issue

(Will prompt you to select an issue)

Workflow

This skill automates the following steps:

1. •Fetch Issue: Get issue details from Linear
2. •Update to In Progress: Move issue to "In Progress" state
3. •Create Branch: Create a new git branch based on issue identifier and title
4. •Implement: Guide implementation according to issue requirements
5. •Test: Verify the implementation works correctly
6. •Create PR: Create a GitHub pull request with issue details
7. •Update to In Review: Move issue to "In Review" state and link PR

Instructions

When this skill is invoked:

1. •

   Parse the issue identifier from the arguments (e.g., "MEG-5"). If no argument provided, list recent backlog issues and ask user to select one.

2. •

   Fetch the issue details from Linear using mcp__linear__Linear_GetIssue with the issue identifier.

3. •

   Update issue status to "In Progress" using mcp__linear__Linear_TransitionIssueState with target state "In Progress".

4. •

   Create a git branch:

   • •Generate branch name from issue: feature/MEG-5-short-description (use kebab-case)
   • •Run: git checkout -b <branch-name>
   • •Confirm branch created successfully
5. •

   Review the issue details with the user:

   • •Display the issue title, description, and scope
   • •Show the review checklist
   • •Show files that will be changed
   • •Ask user to confirm before proceeding with implementation
6. •

   Implement the feature:

   • •Follow the issue's objective and scope exactly
   • •Use the TodoWrite tool to track implementation progress based on the issue's scope
   • •Create/modify files as specified in the issue
   • •Ensure code follows project conventions
   • •Add proper error handling and type safety
   • •Follow the review checklist items
7. •

   Test the implementation:

   • •Run relevant tests based on the issue's testing checklist
   • •Verify no TypeScript errors: bun run type-check (if such script exists)
   • •Test manually if needed
   • •Ensure all success criteria are met
   • •Fix any issues found during testing
8. •

   Commit the changes:

   • •Stage all changes: git add .
   • •Create a descriptive commit message referencing the issue
   • •Commit format: feat(scope): description\n\nFixes MEG-X\n\nCo-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
9. •

   Push and create PR:

   • •Push branch: git push -u origin <branch-name>
   • •Create PR using gh pr create with:
     • •Title: Issue title
     • •Body: Include issue summary, implementation notes, testing done, and link to Linear issue
     • •Use format:
       code

       ## Summary
       [Brief description of changes]
       
       ## Implementation
       [Key implementation details]
       
       ## Testing
       - [x] Testing item 1
       - [x] Testing item 2
       
       ## Review Checklist
       [Copy from issue]
       
       Closes [Linear issue URL]
       
       🤖 Generated with [Claude Code](https://claude.com/claude-code)
       

10. •

    Update issue to "In Review":

    • •Use mcp__linear__Linear_TransitionIssueState with target state "In Review"
    • •Add a comment to the Linear issue with the PR URL using mcp__linear__Linear_AddComment
11. •

    Confirm completion:

    • •Display summary of what was done
    • •Show the PR URL
    • •Show the updated Linear issue URL
    • •Remind user that issue is now in review

Error Handling

• •If issue not found, list available backlog issues
• •If branch already exists, ask user if they want to switch to it or create a new one
• •If tests fail, fix issues before creating PR
• •If PR creation fails, provide manual instructions
• •If Linear state transition fails, continue but warn user to update manually

Notes

• •This skill assumes Linear states "In Progress" and "In Review" exist
• •The skill will use fuzzy matching for state names if exact match fails
• •Always verify implementation works before creating PR
• •Never create PR with failing tests or TypeScript errors