What types of Linear errors can this skill fix?

It provides solutions for authentication failures (401/403), rate limiting (429), bad user input (400), GraphQL validation errors, and network timeouts.

Can it help with Linear webhooks?

Yes, the skill includes a utility to validate Linear webhook signatures using HMAC SHA256 to ensure incoming data is authentic.

How does it handle API rate limits?

It implements an exponential backoff pattern that listens for the RATE_LIMITED code and automatically retries requests after the suggested delay.

Does it work with the official @linear/sdk?

Yes, it includes specific code patterns, type-safe error handling, and update commands specifically for the Linear JavaScript/TypeScript SDK.

Linear API Error Resolver

Name: Linear API Error Resolver
Author: Brmbobo

byBrmbobo

API Development

Diagnoses and resolves common Linear API integration issues including authentication, rate limiting, and validation errors.

About

This skill empowers Claude to identify and fix frequent roadblocks encountered when working with the Linear API. It provides a structured approach to troubleshooting 401/403 authentication failures, 429 rate limit issues, and 400 validation errors by analyzing request patterns and response codes. Whether you are dealing with invalid API keys, incorrect GraphQL queries, or network timeouts, this skill offers specific code patterns for exponential backoff, webhook verification, and SDK-level error handling to ensure stable and resilient project management integrations.

Key Features

Implementation of exponential backoff strategies for 429 rate limiting
Automated diagnosis of 401/403 authentication and permission errors
0 GitHub stars
GraphQL schema validation and SDK version mismatch detection
Field validation for team IDs, priorities, states, and assignees
Built-in diagnostic commands for testing connectivity and rate limit status

Use Cases

Debugging failed issue creation or updates in automated Linear workflows
Verifying webhook signatures and API key permissions during initial integration setup
Implementing robust error handling and retry logic in TypeScript applications

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add brmbobo/web2podcast linear-common-errors

For use in Claude.ai and ChatGPT

Download Skill

GitHub