[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6F7Y64TQ1T96RVPAP3Y58MM":3,"skill-same:01M6F7Y64TQ1T96RVPAP3Y58MM":77},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":45,"linkOnly":46,"markdownContent":47,"markdownBody":48,"frontMatter":49,"refName":54,"commitSha":55,"skillDirectory":56,"forksCount":57,"repositoryHtmlUrl":58,"repositoryHomepageUrl":6,"ownerHtmlUrl":59,"ownerBlogUrl":60,"ownerDescription":61,"updatedAt":62,"install":63,"resources":76},"01M6F7Y64TQ1T96RVPAP3Y58MM","linear-observability",null,"Implement monitoring, logging, and alerting for Linear integrations.\nUse when setting up metrics collection, creating dashboards,\nor configuring alerts for Linear API usage.\nTrigger with phrases like \"linear monitoring\", \"linear observability\",\n\"linear metrics\", \"linear logging\", \"monitor linear integration\".","Dicklesworthstone\u002Fpi_agent_rust","Dicklesworthstone","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F35050222?v=4","01M6CG26AR942CSVMN1M5E3DSE","Jeff Emanuel","01M6CG26EPP71PSHW1VDS71121",1992,"MIT","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Flinear-pack\u002Fskills\u002Flinear-observability\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44],"linear","observability","linear observability","read","when","for","usage","with","trigger","io","alerts","up","use","edit","write","implement","integrations","dashboards","api","collection","monitoring","alerting","integration","metrics","logging","monitor","2026-11-10 10:12:30",false,"---\nname: linear-observability\ndescription: |\n  Implement monitoring, logging, and alerting for Linear integrations.\n  Use when setting up metrics collection, creating dashboards,\n  or configuring alerts for Linear API usage.\n  Trigger with phrases like \"linear monitoring\", \"linear observability\",\n  \"linear metrics\", \"linear logging\", \"monitor linear integration\".\nallowed-tools: Read, Write, Edit, Grep\nversion: 1.0.0\nlicense: MIT\nauthor: Jeremy Longshore \u003Cjeremy@intentsolutions.io>\n---\n\n# Linear Observability\n\n## Overview\nComprehensive monitoring, logging, and alerting for Linear integrations.\n\n## Prerequisites\n- Linear integration deployed\n- Metrics infrastructure (Prometheus, Datadog, etc.)\n- Logging infrastructure (ELK, CloudWatch, etc.)\n- Alerting system configured\n\n## Instructions\n\n### Step 1: Metrics Collection\n```typescript\n\u002F\u002F lib\u002Fmetrics.ts\nimport { Counter, Histogram, Gauge, Registry } from \"prom-client\";\n\nconst registry = new Registry();\n\n\u002F\u002F Request metrics\nexport const linearRequestsTotal = new Counter({\n  name: \"linear_api_requests_total\",\n  help: \"Total Linear API requests\",\n  labelNames: [\"operation\", \"status\"],\n  registers: [registry],\n});\n\nexport const linearRequestDuration = new Histogram({\n  name: \"linear_api_request_duration_seconds\",\n  help: \"Linear API request duration in seconds\",\n  labelNames: [\"operation\"],\n  buckets: [0.1, 0.25, 0.5, 1, 2.5, 5, 10],\n  registers: [registry],\n});\n\nexport const linearComplexityCost = new Histogram({\n  name: \"linear_api_complexity_cost\",\n  help: \"Linear API query complexity cost\",\n  labelNames: [\"operation\"],\n  buckets: [10, 50, 100, 250, 500, 1000, 2500],\n  registers: [registry],\n});\n\n\u002F\u002F Rate limit metrics\nexport const linearRateLimitRemaining = new Gauge({\n  name: \"linear_rate_limit_remaining\",\n  help: \"Remaining Linear API rate limit\",\n  registers: [registry],\n});\n\nexport const linearComplexityRemaining = new Gauge({\n  name: \"linear_complexity_remaining\",\n  help: \"Remaining Linear complexity quota\",\n  registers: [registry],\n});\n\n\u002F\u002F Webhook metrics\nexport const linearWebhooksReceived = new Counter({\n  name: \"linear_webhooks_received_total\",\n  help: \"Total Linear webhooks received\",\n  labelNames: [\"type\", \"action\"],\n  registers: [registry],\n});\n\nexport const linearWebhookProcessingDuration = new Histogram({\n  name: \"linear_webhook_processing_duration_seconds\",\n  help: \"Linear webhook processing duration\",\n  labelNames: [\"type\"],\n  buckets: [0.01, 0.05, 0.1, 0.25, 0.5, 1, 2.5],\n  registers: [registry],\n});\n\n\u002F\u002F Cache metrics\nexport const linearCacheHits = new Counter({\n  name: \"linear_cache_hits_total\",\n  help: \"Total Linear cache hits\",\n  registers: [registry],\n});\n\nexport const linearCacheMisses = new Counter({\n  name: \"linear_cache_misses_total\",\n  help: \"Total Linear cache misses\",\n  registers: [registry],\n});\n\nexport { registry };\n```\n\n### Step 2: Instrumented Client Wrapper\n```typescript\n\u002F\u002F lib\u002Finstrumented-client.ts\nimport { LinearClient } from \"@linear\u002Fsdk\";\nimport {\n  linearRequestsTotal,\n  linearRequestDuration,\n  linearRateLimitRemaining,\n  linearComplexityRemaining,\n} from \".\u002Fmetrics\";\n\nexport function createInstrumentedClient(apiKey: string): LinearClient {\n  const client = new LinearClient({\n    apiKey,\n    fetch: async (url, init) => {\n      const operation = extractOperationName(init?.body);\n      const timer = linearRequestDuration.startTimer({ operation });\n\n      try {\n        const response = await fetch(url, init);\n\n        \u002F\u002F Record rate limit headers\n        const remaining = response.headers.get(\"x-ratelimit-remaining\");\n        const complexity = response.headers.get(\"x-complexity-remaining\");\n\n        if (remaining) linearRateLimitRemaining.set(parseInt(remaining));\n        if (complexity) linearComplexityRemaining.set(parseInt(complexity));\n\n        \u002F\u002F Record success\u002Ffailure\n        const status = response.ok ? \"success\" : \"error\";\n        linearRequestsTotal.inc({ operation, status });\n\n        timer();\n        return response;\n      } catch (error) {\n        linearRequestsTotal.inc({ operation, status: \"error\" });\n        timer();\n        throw error;\n      }\n    },\n  });\n\n  return client;\n}\n\nfunction extractOperationName(body: BodyInit | undefined): string {\n  if (!body || typeof body !== \"string\") return \"unknown\";\n\n  try {\n    const parsed = JSON.parse(body);\n    \u002F\u002F Extract operation name from GraphQL query\n    const match = parsed.query?.match(\u002F(?:query|mutation)\\s+(\\w+)\u002F);\n    return match?.[1] || \"anonymous\";\n  } catch {\n    return \"unknown\";\n  }\n}\n```\n\n### Step 3: Structured Logging\n```typescript\n\u002F\u002F lib\u002Flogger.ts\nimport pino from \"pino\";\n\nexport const logger = pino({\n  level: process.env.LOG_LEVEL || \"info\",\n  formatters: {\n    level: (label) => ({ level: label }),\n  },\n  base: {\n    service: \"linear-integration\",\n    environment: process.env.NODE_ENV,\n  },\n});\n\n\u002F\u002F Linear-specific logger\nexport const linearLogger = logger.child({ component: \"linear\" });\n\n\u002F\u002F Log API calls\nexport function logApiCall(operation: string, duration: number, success: boolean) {\n  linearLogger.info({\n    event: \"api_call\",\n    operation,\n    duration_ms: duration,\n    success,\n  });\n}\n\n\u002F\u002F Log webhook events\nexport function logWebhook(type: string, action: string, id: string) {\n  linearLogger.info({\n    event: \"webhook_received\",\n    webhook_type: type,\n    webhook_action: action,\n    entity_id: id,\n  });\n}\n\n\u002F\u002F Log errors with context\nexport function logError(error: Error, context: Record\u003Cstring, unknown>) {\n  linearLogger.error({\n    event: \"error\",\n    error_message: error.message,\n    error_stack: error.stack,\n    ...context,\n  });\n}\n```\n\n### Step 4: Health Check Endpoint\n```typescript\n\u002F\u002F api\u002Fhealth.ts\nimport { LinearClient } from \"@linear\u002Fsdk\";\nimport { registry } from \"..\u002Flib\u002Fmetrics\";\n\ninterface HealthStatus {\n  status: \"healthy\" | \"degraded\" | \"unhealthy\";\n  checks: {\n    linear_api: { status: string; latency_ms?: number; error?: string };\n    cache: { status: string; hit_rate?: number };\n    rate_limit: { status: string; remaining?: number; percentage?: number };\n  };\n  timestamp: string;\n}\n\nexport async function healthCheck(client: LinearClient): Promise\u003CHealthStatus> {\n  const checks: HealthStatus[\"checks\"] = {\n    linear_api: { status: \"unknown\" },\n    cache: { status: \"unknown\" },\n    rate_limit: { status: \"unknown\" },\n  };\n\n  \u002F\u002F Check Linear API\n  const start = Date.now();\n  try {\n    await client.viewer;\n    checks.linear_api = {\n      status: \"healthy\",\n      latency_ms: Date.now() - start,\n    };\n  } catch (error) {\n    checks.linear_api = {\n      status: \"unhealthy\",\n      error: error instanceof Error ? error.message : \"Unknown error\",\n    };\n  }\n\n  \u002F\u002F Check rate limit status\n  const metrics = await registry.getMetricsAsJSON();\n  const rateLimitMetric = metrics.find(m => m.name === \"linear_rate_limit_remaining\");\n  if (rateLimitMetric) {\n    const remaining = (rateLimitMetric as any).values?.[0]?.value || 0;\n    const percentage = (remaining \u002F 1500) * 100;\n    checks.rate_limit = {\n      status: percentage > 10 ? \"healthy\" : percentage > 5 ? \"degraded\" : \"unhealthy\",\n      remaining,\n      percentage: Math.round(percentage),\n    };\n  }\n\n  \u002F\u002F Determine overall status\n  const statuses = Object.values(checks).map(c => c.status);\n  let status: HealthStatus[\"status\"] = \"healthy\";\n  if (statuses.includes(\"unhealthy\")) status = \"unhealthy\";\n  else if (statuses.includes(\"degraded\")) status = \"degraded\";\n\n  return {\n    status,\n    checks,\n    timestamp: new Date().toISOString(),\n  };\n}\n```\n\n### Step 5: Alerting Rules\n```yaml\n# prometheus\u002Falerts.yml\ngroups:\n  - name: linear-integration\n    rules:\n      # High error rate\n      - alert: LinearHighErrorRate\n        expr: |\n          sum(rate(linear_api_requests_total{status=\"error\"}[5m]))\n          \u002F sum(rate(linear_api_requests_total[5m])) > 0.05\n        for: 5m\n        labels:\n          severity: warning\n        annotations:\n          summary: High Linear API error rate\n          description: \"Linear API error rate is {{ $value | humanizePercentage }}\"\n\n      # Rate limit approaching\n      - alert: LinearRateLimitLow\n        expr: linear_rate_limit_remaining \u003C 100\n        for: 2m\n        labels:\n          severity: warning\n        annotations:\n          summary: Linear rate limit running low\n          description: \"Only {{ $value }} requests remaining in rate limit window\"\n\n      # Slow API responses\n      - alert: LinearSlowResponses\n        expr: |\n          histogram_quantile(0.95, rate(linear_api_request_duration_seconds_bucket[5m])) > 2\n        for: 5m\n        labels:\n          severity: warning\n        annotations:\n          summary: Slow Linear API responses\n          description: \"95th percentile response time is {{ $value }}s\"\n\n      # Webhook processing errors\n      - alert: LinearWebhookErrors\n        expr: |\n          sum(rate(linear_webhooks_received_total{status=\"error\"}[5m])) > 0.1\n        for: 5m\n        labels:\n          severity: critical\n        annotations:\n          summary: Linear webhook processing errors\n          description: \"Webhook error rate: {{ $value }} per second\"\n```\n\n### Step 6: Grafana Dashboard\n```json\n{\n  \"dashboard\": {\n    \"title\": \"Linear Integration\",\n    \"panels\": [\n      {\n        \"title\": \"API Request Rate\",\n        \"type\": \"graph\",\n        \"targets\": [\n          {\n            \"expr\": \"sum(rate(linear_api_requests_total[5m])) by (status)\",\n            \"legendFormat\": \"{{ status }}\"\n          }\n        ]\n      },\n      {\n        \"title\": \"Request Latency (p95)\",\n        \"type\": \"gauge\",\n        \"targets\": [\n          {\n            \"expr\": \"histogram_quantile(0.95, rate(linear_api_request_duration_seconds_bucket[5m]))\"\n          }\n        ]\n      },\n      {\n        \"title\": \"Rate Limit Remaining\",\n        \"type\": \"stat\",\n        \"targets\": [\n          {\n            \"expr\": \"linear_rate_limit_remaining\"\n          }\n        ]\n      },\n      {\n        \"title\": \"Webhooks by Type\",\n        \"type\": \"piechart\",\n        \"targets\": [\n          {\n            \"expr\": \"sum(linear_webhooks_received_total) by (type)\"\n          }\n        ]\n      }\n    ]\n  }\n}\n```\n\n## Error Handling\n| Error | Cause | Solution |\n|-------|-------|----------|\n| `Metrics not collecting` | Missing instrumentation | Add metrics to client wrapper |\n| `Alerts not firing` | Wrong threshold | Adjust alert thresholds |\n| `Missing labels` | Logger misconfigured | Check logger configuration |\n\n## Resources\n- [Prometheus Client Library](https:\u002F\u002Fgithub.com\u002Fsiimon\u002Fprom-client)\n- [Grafana Dashboards](https:\u002F\u002Fgrafana.com\u002Fdocs\u002Fgrafana\u002Flatest\u002Fdashboards\u002F)\n- [Pino Logger](https:\u002F\u002Fgetpino.io\u002F)\n\n## Next Steps\nCreate incident runbooks with `linear-incident-runbook`.\n","# Linear Observability\n\n## Overview\nComprehensive monitoring, logging, and alerting for Linear integrations.\n\n## Prerequisites\n- Linear integration deployed\n- Metrics infrastructure (Prometheus, Datadog, etc.)\n- Logging infrastructure (ELK, CloudWatch, etc.)\n- Alerting system configured\n\n## Instructions\n\n### Step 1: Metrics Collection\n```typescript\n\u002F\u002F lib\u002Fmetrics.ts\nimport { Counter, Histogram, Gauge, Registry } from \"prom-client\";\n\nconst registry = new Registry();\n\n\u002F\u002F Request metrics\nexport const linearRequestsTotal = new Counter({\n  name: \"linear_api_requests_total\",\n  help: \"Total Linear API requests\",\n  labelNames: [\"operation\", \"status\"],\n  registers: [registry],\n});\n\nexport const linearRequestDuration = new Histogram({\n  name: \"linear_api_request_duration_seconds\",\n  help: \"Linear API request duration in seconds\",\n  labelNames: [\"operation\"],\n  buckets: [0.1, 0.25, 0.5, 1, 2.5, 5, 10],\n  registers: [registry],\n});\n\nexport const linearComplexityCost = new Histogram({\n  name: \"linear_api_complexity_cost\",\n  help: \"Linear API query complexity cost\",\n  labelNames: [\"operation\"],\n  buckets: [10, 50, 100, 250, 500, 1000, 2500],\n  registers: [registry],\n});\n\n\u002F\u002F Rate limit metrics\nexport const linearRateLimitRemaining = new Gauge({\n  name: \"linear_rate_limit_remaining\",\n  help: \"Remaining Linear API rate limit\",\n  registers: [registry],\n});\n\nexport const linearComplexityRemaining = new Gauge({\n  name: \"linear_complexity_remaining\",\n  help: \"Remaining Linear complexity quota\",\n  registers: [registry],\n});\n\n\u002F\u002F Webhook metrics\nexport const linearWebhooksReceived = new Counter({\n  name: \"linear_webhooks_received_total\",\n  help: \"Total Linear webhooks received\",\n  labelNames: [\"type\", \"action\"],\n  registers: [registry],\n});\n\nexport const linearWebhookProcessingDuration = new Histogram({\n  name: \"linear_webhook_processing_duration_seconds\",\n  help: \"Linear webhook processing duration\",\n  labelNames: [\"type\"],\n  buckets: [0.01, 0.05, 0.1, 0.25, 0.5, 1, 2.5],\n  registers: [registry],\n});\n\n\u002F\u002F Cache metrics\nexport const linearCacheHits = new Counter({\n  name: \"linear_cache_hits_total\",\n  help: \"Total Linear cache hits\",\n  registers: [registry],\n});\n\nexport const linearCacheMisses = new Counter({\n  name: \"linear_cache_misses_total\",\n  help: \"Total Linear cache misses\",\n  registers: [registry],\n});\n\nexport { registry };\n```\n\n### Step 2: Instrumented Client Wrapper\n```typescript\n\u002F\u002F lib\u002Finstrumented-client.ts\nimport { LinearClient } from \"@linear\u002Fsdk\";\nimport {\n  linearRequestsTotal,\n  linearRequestDuration,\n  linearRateLimitRemaining,\n  linearComplexityRemaining,\n} from \".\u002Fmetrics\";\n\nexport function createInstrumentedClient(apiKey: string): LinearClient {\n  const client = new LinearClient({\n    apiKey,\n    fetch: async (url, init) => {\n      const operation = extractOperationName(init?.body);\n      const timer = linearRequestDuration.startTimer({ operation });\n\n      try {\n        const response = await fetch(url, init);\n\n        \u002F\u002F Record rate limit headers\n        const remaining = response.headers.get(\"x-ratelimit-remaining\");\n        const complexity = response.headers.get(\"x-complexity-remaining\");\n\n        if (remaining) linearRateLimitRemaining.set(parseInt(remaining));\n        if (complexity) linearComplexityRemaining.set(parseInt(complexity));\n\n        \u002F\u002F Record success\u002Ffailure\n        const status = response.ok ? \"success\" : \"error\";\n        linearRequestsTotal.inc({ operation, status });\n\n        timer();\n        return response;\n      } catch (error) {\n        linearRequestsTotal.inc({ operation, status: \"error\" });\n        timer();\n        throw error;\n      }\n    },\n  });\n\n  return client;\n}\n\nfunction extractOperationName(body: BodyInit | undefined): string {\n  if (!body || typeof body !== \"string\") return \"unknown\";\n\n  try {\n    const parsed = JSON.parse(body);\n    \u002F\u002F Extract operation name from GraphQL query\n    const match = parsed.query?.match(\u002F(?:query|mutation)\\s+(\\w+)\u002F);\n    return match?.[1] || \"anonymous\";\n  } catch {\n    return \"unknown\";\n  }\n}\n```\n\n### Step 3: Structured Logging\n```typescript\n\u002F\u002F lib\u002Flogger.ts\nimport pino from \"pino\";\n\nexport const logger = pino({\n  level: process.env.LOG_LEVEL || \"info\",\n  formatters: {\n    level: (label) => ({ level: label }),\n  },\n  base: {\n    service: \"linear-integration\",\n    environment: process.env.NODE_ENV,\n  },\n});\n\n\u002F\u002F Linear-specific logger\nexport const linearLogger = logger.child({ component: \"linear\" });\n\n\u002F\u002F Log API calls\nexport function logApiCall(operation: string, duration: number, success: boolean) {\n  linearLogger.info({\n    event: \"api_call\",\n    operation,\n    duration_ms: duration,\n    success,\n  });\n}\n\n\u002F\u002F Log webhook events\nexport function logWebhook(type: string, action: string, id: string) {\n  linearLogger.info({\n    event: \"webhook_received\",\n    webhook_type: type,\n    webhook_action: action,\n    entity_id: id,\n  });\n}\n\n\u002F\u002F Log errors with context\nexport function logError(error: Error, context: Record\u003Cstring, unknown>) {\n  linearLogger.error({\n    event: \"error\",\n    error_message: error.message,\n    error_stack: error.stack,\n    ...context,\n  });\n}\n```\n\n### Step 4: Health Check Endpoint\n```typescript\n\u002F\u002F api\u002Fhealth.ts\nimport { LinearClient } from \"@linear\u002Fsdk\";\nimport { registry } from \"..\u002Flib\u002Fmetrics\";\n\ninterface HealthStatus {\n  status: \"healthy\" | \"degraded\" | \"unhealthy\";\n  checks: {\n    linear_api: { status: string; latency_ms?: number; error?: string };\n    cache: { status: string; hit_rate?: number };\n    rate_limit: { status: string; remaining?: number; percentage?: number };\n  };\n  timestamp: string;\n}\n\nexport async function healthCheck(client: LinearClient): Promise\u003CHealthStatus> {\n  const checks: HealthStatus[\"checks\"] = {\n    linear_api: { status: \"unknown\" },\n    cache: { status: \"unknown\" },\n    rate_limit: { status: \"unknown\" },\n  };\n\n  \u002F\u002F Check Linear API\n  const start = Date.now();\n  try {\n    await client.viewer;\n    checks.linear_api = {\n      status: \"healthy\",\n      latency_ms: Date.now() - start,\n    };\n  } catch (error) {\n    checks.linear_api = {\n      status: \"unhealthy\",\n      error: error instanceof Error ? error.message : \"Unknown error\",\n    };\n  }\n\n  \u002F\u002F Check rate limit status\n  const metrics = await registry.getMetricsAsJSON();\n  const rateLimitMetric = metrics.find(m => m.name === \"linear_rate_limit_remaining\");\n  if (rateLimitMetric) {\n    const remaining = (rateLimitMetric as any).values?.[0]?.value || 0;\n    const percentage = (remaining \u002F 1500) * 100;\n    checks.rate_limit = {\n      status: percentage > 10 ? \"healthy\" : percentage > 5 ? \"degraded\" : \"unhealthy\",\n      remaining,\n      percentage: Math.round(percentage),\n    };\n  }\n\n  \u002F\u002F Determine overall status\n  const statuses = Object.values(checks).map(c => c.status);\n  let status: HealthStatus[\"status\"] = \"healthy\";\n  if (statuses.includes(\"unhealthy\")) status = \"unhealthy\";\n  else if (statuses.includes(\"degraded\")) status = \"degraded\";\n\n  return {\n    status,\n    checks,\n    timestamp: new Date().toISOString(),\n  };\n}\n```\n\n### Step 5: Alerting Rules\n```yaml\n# prometheus\u002Falerts.yml\ngroups:\n  - name: linear-integration\n    rules:\n      # High error rate\n      - alert: LinearHighErrorRate\n        expr: |\n          sum(rate(linear_api_requests_total{status=\"error\"}[5m]))\n          \u002F sum(rate(linear_api_requests_total[5m])) > 0.05\n        for: 5m\n        labels:\n          severity: warning\n        annotations:\n          summary: High Linear API error rate\n          description: \"Linear API error rate is {{ $value | humanizePercentage }}\"\n\n      # Rate limit approaching\n      - alert: LinearRateLimitLow\n        expr: linear_rate_limit_remaining \u003C 100\n        for: 2m\n        labels:\n          severity: warning\n        annotations:\n          summary: Linear rate limit running low\n          description: \"Only {{ $value }} requests remaining in rate limit window\"\n\n      # Slow API responses\n      - alert: LinearSlowResponses\n        expr: |\n          histogram_quantile(0.95, rate(linear_api_request_duration_seconds_bucket[5m])) > 2\n        for: 5m\n        labels:\n          severity: warning\n        annotations:\n          summary: Slow Linear API responses\n          description: \"95th percentile response time is {{ $value }}s\"\n\n      # Webhook processing errors\n      - alert: LinearWebhookErrors\n        expr: |\n          sum(rate(linear_webhooks_received_total{status=\"error\"}[5m])) > 0.1\n        for: 5m\n        labels:\n          severity: critical\n        annotations:\n          summary: Linear webhook processing errors\n          description: \"Webhook error rate: {{ $value }} per second\"\n```\n\n### Step 6: Grafana Dashboard\n```json\n{\n  \"dashboard\": {\n    \"title\": \"Linear Integration\",\n    \"panels\": [\n      {\n        \"title\": \"API Request Rate\",\n        \"type\": \"graph\",\n        \"targets\": [\n          {\n            \"expr\": \"sum(rate(linear_api_requests_total[5m])) by (status)\",\n            \"legendFormat\": \"{{ status }}\"\n          }\n        ]\n      },\n      {\n        \"title\": \"Request Latency (p95)\",\n        \"type\": \"gauge\",\n        \"targets\": [\n          {\n            \"expr\": \"histogram_quantile(0.95, rate(linear_api_request_duration_seconds_bucket[5m]))\"\n          }\n        ]\n      },\n      {\n        \"title\": \"Rate Limit Remaining\",\n        \"type\": \"stat\",\n        \"targets\": [\n          {\n            \"expr\": \"linear_rate_limit_remaining\"\n          }\n        ]\n      },\n      {\n        \"title\": \"Webhooks by Type\",\n        \"type\": \"piechart\",\n        \"targets\": [\n          {\n            \"expr\": \"sum(linear_webhooks_received_total) by (type)\"\n          }\n        ]\n      }\n    ]\n  }\n}\n```\n\n## Error Handling\n| Error | Cause | Solution |\n|-------|-------|----------|\n| `Metrics not collecting` | Missing instrumentation | Add metrics to client wrapper |\n| `Alerts not firing` | Wrong threshold | Adjust alert thresholds |\n| `Missing labels` | Logger misconfigured | Check logger configuration |\n\n## Resources\n- [Prometheus Client Library](https:\u002F\u002Fgithub.com\u002Fsiimon\u002Fprom-client)\n- [Grafana Dashboards](https:\u002F\u002Fgrafana.com\u002Fdocs\u002Fgrafana\u002Flatest\u002Fdashboards\u002F)\n- [Pino Logger](https:\u002F\u002Fgetpino.io\u002F)\n\n## Next Steps\nCreate incident runbooks with `linear-incident-runbook`.\n",{"name":5,"author":50,"license":15,"version":51,"description":52,"allowed-tools":53},"Jeremy Longshore \u003Cjeremy@intentsolutions.io>","1.0.0","Implement monitoring, logging, and alerting for Linear integrations.\nUse when setting up metrics collection, creating dashboards,\nor configuring alerts for Linear API usage.\nTrigger with phrases like \"linear monitoring\", \"linear observability\",\n\"linear metrics\", \"linear logging\", \"monitor linear integration\".\n","Read, Write, Edit, Grep","main","90b50ed0778745a80fd5bfb13b1843d45b9e82f7","tests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Flinear-pack\u002Fskills\u002Flinear-observability",233,"https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust","https:\u002F\u002Fgithub.com\u002FDicklesworthstone","https:\u002F\u002Fwww.jeffreyemanuel.com\u002F","Building in NY","2026-11-15 01:54:15",{"source":8,"skillName":5,"commands":64,"prompt":74,"zipAvailable":75},[65,68,71],{"tool":66,"command":67},"npx","npx skills add Dicklesworthstone\u002Fpi_agent_rust --skill linear-observability",{"tool":69,"command":70},"bunx","bunx skills add Dicklesworthstone\u002Fpi_agent_rust --skill linear-observability",{"tool":72,"command":73},"pnpm","pnpm dlx skills add Dicklesworthstone\u002Fpi_agent_rust --skill linear-observability","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Flinear-pack\u002Fskills\u002Flinear-observability\u002FSKILL.md",true,[],[78,111,145,168,193,219],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":82,"licenseFileUrl":83,"sourceHtmlUrl":84,"categories":85,"keywords":91,"publishedAt":110},"01M6FCR7G5A005P364Z6ZWCJDP","theme-factory","Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors\u002Ffonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fcreative-design\u002Ftheme-factory\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fcreative-design\u002Ftheme-factory\u002FSKILL.md",[86],{"categoryNo":87,"categoryName":88,"taxonomyType":89,"taxonomyTypeDesc":90},"01JBSEEDCAT000000000000015","视觉设计","SCENARIO","使用场景",[92,93,94,95,96,97,98,99,100,101,102,103,104,105,106,107,26,108,109],"theme factory","factory","theme","docs","toolkit","generate","artifacts","SET","fly","slides","landing","html","styling","artifact","pages","themes","you","fonts","2026-11-11 15:11:14",{"skillNo":112,"name":113,"nameZh":6,"description":114,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":82,"licenseFileUrl":115,"sourceHtmlUrl":116,"categories":117,"keywords":121,"publishedAt":45},"01M6FEGPPK0ZTKCCM0R3E3KS33","web-artifacts-builder","Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn\u002Fui). Use for complex artifacts requiring state management, routing, or shadcn\u002Fui components - not for simple single-file HTML\u002FJSX artifacts.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Futilities\u002Fweb-artifacts-builder\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Futilities\u002Fweb-artifacts-builder\u002FSKILL.md",[118],{"categoryNo":119,"categoryName":120,"taxonomyType":89,"taxonomyTypeDesc":90},"01JBSEEDCAT000000000000009","前端开发",[122,123,98,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,31,103,139,140,141,142,24,143,144],"web artifacts builder","web","artifacts builder","builder","frontend","css","components","react","component","routing","state management","state","shadcn","file","ui","Tools","Tailwind","single-file","simple","ui components","multi","jsx","suite",{"skillNo":146,"name":147,"nameZh":6,"description":148,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":82,"licenseFileUrl":149,"sourceHtmlUrl":150,"categories":151,"keywords":156,"publishedAt":45},"01M6FEE9VTK1W4GY21AKREJXRG","webapp-testing","Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fsecurity\u002Fwebapp-testing\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fsecurity\u002Fwebapp-testing\u002FSKILL.md",[152,155],{"categoryNo":153,"categoryName":154,"taxonomyType":89,"taxonomyTypeDesc":90},"01JBSEEDCAT000000000000008","测试与质量",{"categoryNo":119,"categoryName":120,"taxonomyType":89,"taxonomyTypeDesc":90},[157,158,159,126,160,161,123,162,96,163,136,164,165,166,167,26,24],"testing","webapp testing","webapp","screenshots","playwright","debugging","browser","logs","applications","behavior","local",{"skillNo":169,"name":170,"nameZh":6,"description":171,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":172,"sourceHtmlUrl":173,"categories":174,"keywords":175,"publishedAt":45},"01M6FE20F7ZTQBFWKF4MPJ2SBX","neuropixels-analysis","Neuropixels neural recording analysis. Load SpikeGLX\u002FOpenEphys data, preprocess, motion correction, Kilosort4 spike sorting, quality metrics, Allen\u002FIBL curation, AI-assisted visual analysis, for Neuropixels 1.0\u002F2.0 extracellular electrophysiology. Use when working with neural recordings, spike sorting, extracellular electrophysiology, or when the user mentions Neuropixels, SpikeGLX, Open Ephys, Kilosort, quality metrics, or unit curation.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fscientific\u002Fneuropixels-analysis\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fscientific\u002Fneuropixels-analysis\u002FSKILL.md",[],[176,177,178,42,179,180,181,182,31,183,184,185,186,187,188,189,26,190,191,192,24,23],"analysis","neuropixels analysis","spike","data","open","quality","user","recordings","Neural","motion","visual","quality metrics","unit","sorting","curation","recording","load",{"skillNo":194,"name":195,"nameZh":6,"description":196,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":82,"licenseFileUrl":197,"sourceHtmlUrl":198,"categories":199,"keywords":203,"publishedAt":45},"01M6FDP0PDK6F1GGX395C7625Z","skill-creator","Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fskill-creator\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fskill-creator\u002FSKILL.md",[200],{"categoryNo":201,"categoryName":202,"taxonomyType":89,"taxonomyTypeDesc":90},"01JBSEEDCAT000000000000023","Skill与智能体开发",[204,205,206,207,208,209,210,211,35,212,213,214,215,216,26,24,217,23,218],"skill creator","creator","workflows","create","update","capabilities","knowledge","tool","specialized","guide","new skill","existing skill","users","Existing","new",{"skillNo":220,"name":221,"nameZh":6,"description":222,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":223,"sourceHtmlUrl":224,"categories":225,"keywords":227,"publishedAt":45},"01M6FDM8Y7VK7NYG9SM7QPA3PW","notebooklm","Use this skill to query your Google NotebookLM notebooks directly from Claude Code for source-grounded, citation-backed answers from Gemini. Browser automation, library management, persistent auth. Drastically reduced hallucinations through document-only responses.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fnotebooklm\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fnotebooklm\u002FSKILL.md",[226],{"categoryNo":201,"categoryName":202,"taxonomyType":89,"taxonomyTypeDesc":90},[221,228,229,230,231,232,233,163,234,235,31,236,237,238,239,24,240],"google","browser automation","gemini","automation","auth","code","library","management","only","document","query","Citation","source"]