Skill UI

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.

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.

This guide provides production-grade architectural patterns for integrating with the Linear API. It helps developers choose the optimal strategy—be it Simple SDK calls, Service-Oriented Gateways with caching, or Event-Driven Webhooks—based on system complexity, scale, and real-time requirements. Includes patterns like CQRS and rate limiting best practices.

This guide details secure methods for connecting external applications to the Linear API. It covers essential security practices, including secure storage of API keys using environment variables, implementing OAuth 2.0 with PKCE for robust authentication, managing token refresh cycles, and verifying webhook signatures using HMAC-SHA256. Essential for building production-grade, secure integrations.

This comprehensive guide outlines a multi-step process for safely upgrading the Linear SDK across major versions. It details how to check for breaking changes (like renamed fields or changed return types), implement compatibility layers using patterns like the Bridge pattern in TypeScript, run thorough unit and integration tests, and establish a robust deployment and rollback plan, ensuring zero downtime migration.

A comprehensive framework for setting up and processing Linear webhooks. This skill demonstrates best practices for real-time event handling, including mandatory HMAC signature verification, replay attack prevention, and robust event routing for various data types (Issues, Comments, Projects). Ideal for building reliable, real-time integrations between Linear and external systems.

A comprehensive guide to integrating Lokalise into Continuous Integration/Continuous Deployment (CI/CD) workflows using GitHub Actions. This setup automates the entire translation lifecycle: uploading source strings on code pushes, downloading the latest translations during builds, and running PR checks to ensure translation coverage across all required locales. It eliminates manual file management, keeping code, translations, and CI pipelines perfectly synchronized.

A comprehensive guide for diagnosing and fixing common Lokalise API errors and exceptions. This skill details the error response format and provides diagnostic cURL commands for specific HTTP status codes (401, 400, 404, 429, 413, 500, 503). Use it when encountering failed requests, debugging integration issues, or needing to verify API token validity and rate limit status.

A comprehensive workflow tool for managing the entire localization process using Lokalise. It handles downloading translated files (JSON, XLIFF, PO), reviewing translation status, updating keys, and integrating the output directly into development applications. Ideal for CI/CD pipelines and developers needing to sync localized content efficiently.

A comprehensive tool designed to collect all necessary diagnostic evidence for troubleshooting Lokalise integration issues or filing support tickets. It gathers environment details (Node, Python, OS), tests API connectivity, lists project metrics, checks upload processes, and collects redacted logs, bundling everything into a single archive.

This skill provides a comprehensive guide for integrating Lokalise into CI/CD pipelines. It outlines how to automate the download of the latest, reviewed translations during the build stage, ensuring that production environments always ship the most current localized content. Ideal for setting up deployment workflows on platforms like Vercel, Netlify, and GitHub Actions.