Skill UI

This skill provides comprehensive patterns for synchronizing, backing up, and maintaining data consistency between a local database and the Linear API. It covers full pagination sync, efficient webhook-based incremental updates, and conflict resolution. Implement this when building client applications that require a reliable, up-to-date local mirror of Linear issue data.

A comprehensive, production-ready toolkit for robustly debugging and monitoring Linear API integrations. This bundle includes features like an instrumented client wrapper for detailed request/response logging, a performance request tracer with summary statistics (avg, p95, max latency), a health check utility, and an environment validator. Ideal for developers setting up logging, performance monitoring, or debugging utilities in a live SaaS environment.

This skill integrates Continuous Integration/Continuous Deployment (CI/CD) pipelines with Linear issue tracking. It automatically detects deployment URLs (e.g., Vercel, Railway), adds detailed deployment comments to relevant Linear issues, and manages state transitions (e.g., moving an issue to 'Review' or 'Done') based on the deployment environment (staging or production). It ensures a seamless link between code commits, deployment status, and project management tickets.

This comprehensive guide demonstrates how to implement robust Role-Based Access Control (RBAC) for applications deeply integrated with Linear. It covers utilizing Linear's built-in roles, mapping application roles to specific OAuth scopes, implementing powerful permission guard middleware, and integrating advanced enterprise features like SAML SSO and SCIM provisioning, ensuring secure and scalable access management for large organizations.

This guide details how to use the official @linear/sdk to interact with the Linear project management API. It covers performing core CRUD operations, such as creating new issues, listing teams, querying issue states, and performing raw GraphQL requests. Ideal for developers needing to integrate Linear into a custom workflow, test API connectivity, or learn foundational automation patterns.

A comprehensive guide for installing and configuring the Linear SDK for TypeScript/JavaScript. It details two primary authentication methods: using a personal API key for scripts and server-side tools, and implementing the full OAuth 2.0 flow (including PKCE and token refreshing) for user-facing applications. Essential for integrating Linear functionality into custom software.

This guide provides a comprehensive workflow for setting up a local development environment for Linear integrations. It covers project scaffolding, environment configuration, connection verification using the official SDK, robust integration testing with Vitest, and simulating webhooks using ngrok. Essential for developers building and testing SaaS connections with Linear.

A robust pattern for configuring API clients to interact with Linear across multiple isolated environments (Development, Staging, Production). This setup ensures that environment-specific credentials (API keys, webhooks) are securely loaded from secret managers (Vault, AWS, GCP) and implements environment guards to prevent accidental operations in the wrong environment. Ideal for professional CI/CD pipelines.

A comprehensive guide and implementation using TypeScript to establish production-grade observability for Linear API integrations. This includes defining Prometheus metrics (tracking latency, error rates, rate limits, and webhooks), implementing structured logging (using pino), and setting up robust health check endpoints. It ensures full visibility into API performance and system health, critical for mission-critical SaaS applications.

A comprehensive guide to optimizing interactions with the Linear API. Learn advanced techniques to improve application performance by eliminating N+1 queries, implementing robust caching strategies for static data (e.g., teams, states), managing cache invalidation via webhooks, and efficiently batching multiple mutations into single GraphQL requests. Essential for building scalable, low-latency SaaS applications.

This comprehensive checklist provides best practices and patterns for deploying Linear integrations to a production environment. It covers critical areas including robust authentication and secure secret management, error handling and system resilience (rate limiting, timeouts), performance optimization (caching, batching), and setting up full observability (health checks, structured logging). Use this when preparing for a go-live or auditing existing deployments.

This guide provides advanced techniques for managing API rate limits (429 errors) and complexity budgets when interacting with the Linear API. It covers reading rate limit headers, implementing exponential backoff with jitter for robust retries, controlling request bursts via token buckets, and optimizing GraphQL queries to minimize complexity scores. Use this when developing reliable integrations that must adhere to strict API quotas.