linear-common-errors
Szybka diagnoza i naprawa błędów Linear API — debugowanie integracji w minuty
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Umiejętność do debugowania i rozwiązywania typowych problemów z Linear API i SDK. Pomaga w diagnozowaniu błędów autentykacji, limitów szybkości, problemów z zapytaniami GraphQL oraz błędów integracji. Analizuje strukturę odpowiedzi Linear, identyfikuje typ błędu na podstawie pola extensions.type i sugeruje konkretne kroki naprawcze. Idealna dla deweloperów integrujących Linear z własnymi aplikacjami.
Jak używać
Zainstaluj umiejętność w swoim środowisku Claude Code, Codex lub OpenClaw, upewniając się, że masz dostęp do narzędzi Read, Write, Edit, Grep i Bash (z uprawnieniami curl).
Gdy napotkasz błąd Linear API, wyzwól umiejętność frazą taką jak "linear error", "linear API error", "debug linear", "linear not working", "linear 429" lub "linear authentication error".
Przygotuj informacje diagnostyczne: pełną odpowiedź błędu z Linear (zwłaszcza pole
response.errors[]zextensions.typeiextensions.userPresentableMessage), kod integracji, który wysyła zapytanie, oraz logi aplikacji.Umiejętność przeanalizuje strukturę błędu GraphQL i zidentyfikuje typ problemu — czy to błąd autentykacji (HTTP 401), problem z uprawnieniami (forbidden), przekroczenie limitu szybkości (429) czy błąd walidacji danych wejściowych.
Na podstawie typu błędu otrzymasz konkretne kroki naprawcze: sprawdzenie klucza API, weryfikację uprawnień tokenu, dodanie opóźnień między żądaniami, lub poprawę formatu zapytania GraphQL.
Pamiętaj, że Linear zwraca HTTP 200 nawet z błędami — zawsze sprawdzaj tablicę
errorsw odpowiedzi, nie tylko kod statusu HTTP.