name: work-on-linear-issue
description: Fetches a Linear issue and creates a comprehensive plan for implementation.

Work on Linear Issue

Fetches issue details from Linear and guides you through creating a comprehensive implementation plan.

When to Use

• When starting work on a Linear issue
• When you need to analyze and plan implementation for an issue
• When onboarding to a new task from Linear

Prerequisites

• LINEAR_API_KEY environment variable must be set (can also be in .env file)
• curl and jq must be installed

Usage

builtin:///skills/scripts/work-on-linear-issue <issue-abbreviation>

Examples:

builtin:///skills/scripts/work-on-linear-issue MC-123
builtin:///skills/scripts/work-on-linear-issue https://linear.app/abc/issue/MC-123/issue-title

Workflow

"AI models are geniuses who start from scratch on every task." — Noam Brown

Onboard yourself to the current task:
• Use ultrathink.
• Explore the codebase.
• Ask questions if needed.

Goal: Be fully prepared to start working on the task.

Take as long as you need to prepare. Over-preparation is better than under-preparation.

Planning Tasks

1. Review the issue details fetched from Linear
2. Examine relevant parts of the codebase
3. Analyze existing patterns and potential issues
4. Create a comprehensive plan considering:
5. Required code changes
6. Potential impacts on other parts of the system
7. Necessary tests to be written or updated
8. Documentation updates
9. Performance considerations
10. Security implications
11. Backwards compatibility (if applicable)

12. Reference links to featurebase or user request sources

13. Think deeply about edge cases, potential challenges, and best practices

14. ASK FOR EXPLICIT APPROVAL before starting on the TODO list

Remember: Your task is to create a plan, not to implement changes. Focus on providing a thorough, well-thought-out strategy, then ASK FOR APPROVAL BEFORE STARTING WORK.