work-on-linear-issue
Fetches a Linear issue and creates a comprehensive plan for implementation.
When & Why to Use This Skill
This Claude skill bridges the gap between project management and technical execution by automating the initial phases of software development. It fetches real-time issue data from Linear and leverages AI to perform deep codebase exploration, resulting in a comprehensive, structured implementation plan. By focusing on over-preparation and architectural impact analysis, it helps developers minimize errors and ensure all edge cases, security implications, and testing requirements are addressed before the coding process begins.
Use Cases
- Developer Onboarding: Quickly orient a developer to a new task by fetching Linear ticket details and generating a roadmap of the relevant codebase areas and required changes.
- Technical Planning & Risk Mitigation: Use the skill to analyze complex issues and identify potential impacts on system performance, security, and backward compatibility before starting implementation.
- Workflow Automation: Streamline the transition from 'To Do' to 'In Progress' by automatically generating a TODO list and technical strategy that requires only a final human approval.
- Codebase Impact Analysis: Automatically identify which existing patterns and files need to be modified or updated based on the specific requirements of a Linear issue.
| 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_KEYenvironment variable must be set (can also be in.envfile)curlandjqmust 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
Review the issue details fetched from Linear
Examine relevant parts of the codebase
Analyze existing patterns and potential issues
Create a comprehensive plan considering:
- Required code changes
- Potential impacts on other parts of the system
- Necessary tests to be written or updated
- Documentation updates
- Performance considerations
- Security implications
- Backwards compatibility (if applicable)
- Reference links to featurebase or user request sources
Think deeply about edge cases, potential challenges, and best practices
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.