К основному содержанию
скилл CX Codex

linear-observability — скилл для Claude Code

Скилл linear-observability собирает метрики и алерты вокруг интеграции с Linear: вызовы API, вебхуки, очередь, сверка. Токены и текст задач в телеметрию не попадают.

MIT 1 установок ★ 2 935 обновлён 2026-10-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add jeremylongshore/tons-of-skills-marketplace --skill linear-observability -a claude-code
Открыть на GitHub

Что делает linear-observability

Скилл размечает наблюдаемость вокруг интеграции с Linear: успешность вызовов API, ошибки GraphQL, подтверждение вебхуков, задержку очереди, свежесть сверки. Внутри — порядок из шести шагов: сначала цели уровня сервиса, потом поля телеметрии, затем алерты и проверка дашбордов синтетическими сбоями. Инструменты: Read, Glob, Grep, Write, Edit; WebFetch только для документации Linear и метаданных пакетов.

В сигналы идут имена операций, статус, нормализованный код ошибки, задержка, число повторов, остаток бюджета по лимитам и сложности. Из вебхуков — хеш delivery ID, тип события, результат проверки подписи, задержка подтверждения, дедупликация. Токены, переменные GraphQL, текст задач и идентичности пользователей остаются за бортом. Если заголовка с бюджетом нет, метрика помечается как неизвестная.

Живая проверка требует сетевого доступа и одобренного ключа рабочего пространства Linear: без него скилл остаётся на чтении кода. Личный ключ идёт в Authorization: <API_KEY> для скриптов владельца, OAuth с PKCE — для приложений от имени пользователя. Ротация ключей, смена скоупов и включение вебхуков только с согласия ответственного. Аудит-логи Enterprise хранятся 90 дней и доступны лишь владельцу; обходить это через выгрузку из UI скилл запрещает.

Какие задачи решает

  • добавить метрики к вызовам Linear API без утечки токенов в телеметрию
  • настроить алерты на подтверждение вебхуков и возраст очереди
  • проверить свежесть сверки между Linear и своим сервисом
  • описать цели уровня сервиса для интеграции и связать их с ранбуками
  • отдать аудит-доказательства, вычистив чувствительные поля

Примеры запросов агенту

  • Разметь вызовы Linear API в services/sync метриками: имя операции, статус, код ошибки, задержка.
  • Добавь алерты на провал проверки подписи вебхука и на задержку обработки.
  • Проверь, какие поля уходят в телеметрию, и убери оттуда переменные GraphQL.

Как установить linear-observability

1Через Skills CLI (Vercel)

npx skills add jeremylongshore/tons-of-skills-marketplace --skill linear-observability -a claude-code

2Вручную: положить файлы

~/.claude/skills/linear-observability/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/linear-observability/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о linear-observability

Как установить linear-observability в Claude Code?

Командой npx skills add jeremylongshore/tons-of-skills-marketplace --skill linear-observability -a claude-code. Файл скилла окажется по пути ~/.claude/skills/linear-observability/SKILL.md.

Что делает linear-observability?

Раскладывает наблюдаемость интеграции с Linear на шесть шагов: цели сервиса, поля телеметрии, вебхуки, алерты, аудит-логи и проверка дашбордов синтетическими сбоями.

Что нужно для живой проверки?

Сетевой доступ и одобренный ключ рабочего пространства Linear. Без ключа скилл работает по коду и конфигурации репозитория, ничего не отправляя наружу.

Исходный текст

SKILL.md · MIT
---
name: linear-observability
description: >-
  Instrument Linear API, SDK, webhook, queue, and reconciliation behavior with useful redacted signals. Use when defining service objectives, dashboards, alerts, or audit evidence. Trigger with "monitor Linear integration", "add Linear API metrics", or "observe Linear webhooks".
argument-hint: "[repository-path] [metrics|logs|traces|alerts]"
allowed-tools: Read, Glob, Grep, WebFetch, Write, Edit
version: 1.13.0
author: Jeremy Longshore <[email protected]>
license: MIT
tags:
- saas
- linear
- observability
model: inherit
effort: high
compatibility: Designed for Claude Code; live verification requires network access and an approved Linear workspace credential
---
# Linear Integration Observability

## Overview

Measure contract health and business freshness without placing tokens, GraphQL variables, issue content, or user identities in telemetry.

## Prerequisites

- The target repository, Linear workspace, environment, and accountable owner
- Current security, privacy, compliance, capacity, and change-control requirements
- An approved Linear credential only when a bounded live verification is necessary

## Tool Discipline

Use `Read`, `Glob`, and `Grep` to inspect code, configuration, and evidence. Use `WebFetch` only for current first-party Linear documentation and package metadata. Use `Write` or `Edit` only for requested implementation with known target files. Never write credentials, customer content, unrestricted environment output, or unredacted GraphQL variables.

## Current Contract

- Linear returns request-limit, endpoint-limit, complexity, remaining-budget, and reset headers that can drive safe capacity telemetry.
- Webhook delivery headers include unique delivery ID, event type, signature, and timestamp; never log the signature as reusable evidence.
- Enterprise audit logs retain 90 days and can be queried or streamed, but are owner-only and contain sensitive actor/IP metadata.

## Authentication

Use a personal API key only for owner-controlled scripts, OAuth with PKCE for user-delegated applications, or an enabled client-credentials grant for approved automation. Personal keys use `Authorization: <API_KEY>`; OAuth tokens use `Authorization: Bearer <ACCESS_TOKEN>`. Store credentials server-side in an approved secret manager.

Treat app approval, team access, scope changes, credential creation, rotation, revocation, and production access as owner-approved actions.

## Instructions

1. Define service objectives for API success, GraphQL application errors, webhook acknowledgement, queue lag, and reconciliation freshness.
2. Emit operation names, status, normalized error code, latency, retry count, and rate/complexity budget—not raw queries or variables.
3. Track webhook delivery ID hashes, event type, verification result, acknowledgement latency, dedupe outcome, and processing lag.
4. Alert on sustained budget exhaustion, auth failures, signature failures, queue age, and reconciliation divergence.
5. Keep audit-log ingestion separate, least-privileged, redacted, and aligned with the organization's retention policy.
6. Test dashboards and alerts with synthetic failures and record owner, runbook, and quieting rules.

## Approval Boundaries

Do not create, reveal, rotate, or revoke credentials; authorize an OAuth app; change scopes or team access; create, mutate, archive, or delete workspace data; configure or re-enable webhooks; import or export data; change roles, SCIM, or audit streaming; transmit diagnostics; change paid entitlements; or perform another production mutation without explicit approval from the accountable owner. Keep diagnosis read-only unless implementation was requested.

## Output

Return the workspace and team scope, auth mode without credential value, files and contracts inspected, exact operation names, evidence collected, validation result, sensitive fields redacted, remaining risk, accountable owner, approval state, and rollback or next action.

## Error Handling

| Condition | Response |
|---|---|
| Sensitive telemetry | Drop and scrub the field before expanding observability. |
| Header absent | Mark the metric unknown; do not fabricate a full budget. |
| Alert storm | Aggregate by workspace/operation and preserve the first actionable evidence. |
| Audit access denied | Confirm Enterprise owner authority; do not work around it with scraped UI data. |

## Examples

Use a compact handoff that makes scope, mutation authority, and verification evidence reviewable.

Input:

```text
slo=webhook-ack<5s; dimensions=workspace-hash,operation; payload-logging=false
```

Expected handoff:

```text
metrics=bounded; alerts=runbook-linked; content=excluded
```

## Resources

- [Skill-specific official documentation](references/official-docs.md)
- [Linear developer documentation index](https://linear.app/llms.txt)
- [Linear GraphQL API](https://linear.app/developers/graphql.md)

© Jeremy Longshore · MIT · jeremylongshore/tons-of-skills-marketplace

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
cyrus-setup-linear cyrusagents Скилл cyrus-setup-linear создаёт OAuth-приложение Linear и прописывает его ключи в конфиг Cyrus, чтобы агент получал вебхуки и отвечал на issues. CX Codex +1 1 200установок linear-webhooks hookdeck Скилл linear-webhooks помогает настроить приём вебхуков от Linear, проверить HMAC-SHA256 подпись и обработать события задач или проектов. CX Codex +1 123установок linear-release-setup linear Скилл linear-release-setup помогает настроить пайплайны Linear Release в GitHub Actions, GitLab CI или CircleCI. Проводит по шагам от выбора модели веток до добавления секретов. CX Codex +1 15 400установок linear-cli schpet Скилл linear-cli для Claude Code управляет задачами, проектами и документами Linear через CLI. Срабатывает по запросам о Linear и ID вроде ENG-123. CX Codex +1 16 900установок linear vercel-labs linear — скилл для Claude Code, тестирующий интеграции локально. Тестирует задачи, OAuth и вебхуки без реального API. CX Codex +1 113установок cyrus-setup-endpoint cyrusagents Скилл cyrus-setup-endpoint для Claude Code настраивает публичный вебхук-эндпоинт агента Cyrus через ngrok, Cloudflare Tunnel или собственный домен. Эндпоинт принимает события из Linear, Slack и GitHub. CX Codex +1 1 100установок

Из того же набора139

Весь набор →
granola-core-workflow-a Скилл granola-core-workflow-a помогает настроить шаблоны заметок, реципы для чата и контекст перед встречами в Granola. Пригодится при подготовке к 1:1 и созвонам с клиентами. CX Codex +1 1установок monitoring-cross-chain-bridges Скилл monitoring-cross-chain-bridges для Claude Code собирает данные о TVL, комиссиях, объёме и статусе переводов через кроссчейн-мосты. Сравнивает маршруты и проверяет транзакции. CX Codex +1 1установок vercel-cost-tuning Скилл vercel-cost-tuning для Claude Code разбирает счета Vercel и показывает, где возникают лишние расходы. Помогает урезать траты на функции, трафик и middleware. CX Codex +1 1установок linear-cost-tuning Скилл linear-cost-tuning снижает расход квот и нагрузку на API Linear: заменяет частый поллинг вебхуками и урезает избыточную сложность запросов GraphQL. CX Codex +1 1установок linear-prod-checklist Скилл linear-prod-checklist проверяет готовность интеграции Linear к запуску: доступы, данные, лимиты, вебхуки, восстановление и ответственность. CX Codex +1 1установок supabase-webhooks-events Скилл supabase-webhooks-events помогает настроить вебхуки Supabase, асинхронные HTTP-запросы через pg_net, события LISTEN/NOTIFY и приёмники Edge Functions с проверкой HMAC-подписи. CX Codex +1 1установок supabase-cost-tuning Скилл supabase-cost-tuning разбирает расходы Supabase и помогает найти лишние траты в базе, хранилище, соединениях и Edge Functions. CX Codex +1 1установок sql-query-optimizer Скилл подсказывает, как оптимизировать SQL-запросы. Активируется сам, когда в запросе встречается «sql query optimizer», «sql optimizer» или просто «sql». CX Codex +1 1установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой