---
name: implement-linear-issue
description: Implement a Linear issue. Use when the user wants to work on a Linear ticket, provides a Linear issue ID (e.g., JJS-78) or Linear URL.
argument-hint: <issue-id-or-url>
allowed-tools: mcp__claude_ai_Linear__*, Skill(commit-commands:commit-push-pr), Bash(git add *), Bash(git commit *), Bash(git push *), Bash(gh pr *)
disable-model-invocation: true
---

# 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

2. **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" }]
   ```

3. **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