josephschmitt/dotfiles/implement-linear-issue

Implement Linear Issue

This skill helps you implement a Linear issue from start to finish, including creating a PR and linking it back to Linear.

Instructions

1. Parse the Argument

The $ARGUMENTS variable contains either:

• A full URL like https://linear.app/.../issue/JJS-78/...
• An issue ID like JJS-78

If it's a URL: Extract the issue ID using regex pattern /issue/([A-Z]+-\d+)/ If it's already an ID: Use it directly

2. Fetch Issue Details

Use the mcp__claude_ai_Linear__get_issue tool with the parsed issue ID to retrieve:

• Issue title
• Issue description
• Priority
• Labels
• Any attachments or linked resources

Display the issue details to understand what needs to be implemented.

3. Mark Issue as In Progress

Update the issue status to "In Progress":

mcp__claude_ai_Linear__update_issue with:
- id: <issue-id>
- state: "In Progress"

4. Understand and Implement

Read the issue requirements carefully. If the issue description contains images, use mcp__claude_ai_Linear__extract_images to view them.

Implement the feature/fix as described in the issue:

• Analyze the codebase to understand where changes need to be made
• Make the necessary code changes
• Test the implementation

5. After Implementation Complete

Once the implementation is done:

1. Commit and Push PR: Use the /commit-commands:commit-push-pr skill to:

• Commit the changes
• Push to a branch
• Open a pull request

1. Link PR to Linear: After the PR is created, add it as a link on the Linear issue:

``` mcp__claude_ai_Linear__update_issue with:

• id: <issue-id>
• links: [{ url: <pr-url>, title: "Pull Request" }]

```

1. Update Issue Status: Move the issue to "In Review":

``` mcp__claude_ai_Linear__update_issue with:

• id: <issue-id>
• state: "In Review"

```

Example Usage

/implement-linear-issue JJS-78
/implement-linear-issue https://linear.app/josephschmitt/issue/JJS-78/add-new-feature

Notes

• Prefer `/commit-commands:commit-push-pr` over raw git commands - Use the skill for committing, pushing, and creating PRs rather than running git add, git commit, git push directly
• If the issue has sub-issues or dependencies, consider implementing those first
• Include the Linear issue ID in your commit message for traceability
• The PR title should match or reference the Linear issue title