What versions of the Linear SDK does this skill support?

The skill provides specific patterns and compatibility matrices for migrating across all major versions, with a focus on transitions from 1.x through the latest 3.x releases.

How does it handle breaking changes in return types?

It includes migration patterns for common breaking changes like the shift from direct object returns to paginated 'nodes' connections.

Does this skill automatically rewrite my code?

It provides Claude with the necessary context and patterns to identify deprecated code and suggest specific refactors, which you can then apply and verify through the provided test steps.

What if the upgrade breaks my production environment?

The skill includes a defined rollback procedure using Git and npm to quickly revert to the last known stable version of the SDK while you investigate the issue.

Can I use this for TypeScript projects?

Yes, it includes specific instructions for handling strict types, nullable fields, and running tsc checks to ensure the migration is type-safe.

Linear SDK Upgrade & Migration

Name: Linear SDK Upgrade & Migration
Author: Brmbobo

byBrmbobo

0•

Collaboration Tools

Automates the process of upgrading Linear SDK versions and resolving breaking changes in codebase integrations.

The Linear Upgrade Migration skill is a specialized tool for developers maintaining integrations with the Linear project management platform. It streamlines the transition between SDK versions by providing structured patterns for handling breaking changes, such as field renames, return type modifications (like paginated connections), and the shift from CommonJS to ESM. By implementing compatibility layers and feature flags, this skill helps teams upgrade their Linear dependencies safely without disrupting existing workflows or project management automations.

Key Features

01Automated version checking and changelog retrieval for @linear/sdk

02Predefined migration patterns for renamed fields and changed return types

03Framework for creating backward-compatible client wrappers

04Type-safe verification using TypeScript compiler integration

05Step-by-step rollback procedures and error handling strategies

060 GitHub stars

Use Cases

01Updating legacy CommonJS Linear code to modern ESM import syntax

02Refactoring issue creation logic to support new required API parameters

03Migrating an existing Linear integration from version 2.x to 3.x with strict typing

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add brmbobo/web2podcast linear-upgrade-migration

For use in Claude.ai and ChatGPT

Download Skill