Skill UI

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 runbook providing step-by-step procedures for managing production incidents related to Linear integrations. It guides users through diagnosing outages, checking API authentication, managing rate limits, and resolving webhook failures, ensuring a quick and effective response across various severities.

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.

Automates the setup and best practices for linear issue generation within enterprise workflows, offering guidance, production-ready code, and validation for governance, compliance, and integration tasks.

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.

Provides a deep dive into migrating issue tracking data from major platforms like Jira, Asana, and GitHub to Linear. This guide covers the entire lifecycle, including initial workflow assessment, status and priority mapping, data export utilizing API examples, and detailed transformation logic required to ensure data integrity and smooth adoption within 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.