Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/netdata/skills/troubleshoot-consulnpx skills add netdata/skills --skill troubleshoot-consulgit clone --depth 1 https://github.com/netdata/skillsWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/netdata/skills/troubleshoot-consul)<a href="https://agentmods.dev/skills/netdata/skills/troubleshoot-consul"><img src="https://agentmods.dev/badge/skills/netdata/skills/troubleshoot-consul.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00067 | $0.02232 |
| Opus 5 | $0.00034 | $0.01116 |
| Sonnet 5 | $0.00013 | $0.00446 |
| Haiku 4.5 | $0.00007 | $0.00223 |
Grade A, and why
troubleshoot-consul scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 182 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Troubleshoot Consul
When to use this skill
- Leader instability: The leader cannot commit Raft entries fast enough (disk latency, CPU starvation, network partitions). Repeated elections. All writes fail during elections. Cascading effect: anti-entropy cannot sync, health checks go stale, service discovery returns stale data.
- Gossip partition / flapping: Network issues cause nodes to oscillate between alive/failed/left states. This creates a storm of catalog deregistrations and re-registrations. Health checks flip. Downstream consumers (load balancers, service meshes) react to every flip, causing traffic storms.
- Catalog bloat / memory exhaustion: Large numbers of registered services, checks, or KV entries grow unbounded. Snapshots become enormous. Raft replication slows. Server restarts take minutes to hours to restore the snapshot.
- Blocking query accumulation: Consul's watch mechanism uses HTTP long-polling (blocking queries). Each blocking query holds a goroutine and a connection. Misconfigured or leaked watches accumulate indefinitely. Servers eventually run out of goroutines or file descriptors.
- Certificate/CA failures: Connect certificates expire without rotation. CA root rotation fails mid-roll. Envoy sidecars reject connections. Silent mutual TLS failures cause intermittent service-to-service communication failures that look like application bugs.
- Cross-DC WAN degradation: WAN gossip between datacenters degrades silently. Cross-DC service lookups fail or return stale results. Prepared queries that failover across DCs stop working.
- Any time the user reports a Consul service behaving outside its expected envelope (elevated errors, latency, saturation, resource exhaustion, or unexpected restarts).
- An on-call engineer is paging on a Netdata alert tied to a Consul instance and wants a structured triage path.
What ships with it
2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 6d ago First seen · 182 lines · 67 tokens per session scan A 267feab04fd3
troubleshoot-consul is a skill published in the GitHub repository netdata/skills (2 stars, last pushed 3mo ago), licensed Apache-2.0. It adds 67 tokens to every session and 2,232 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other skills, from other repositories
gke-ai-troubleshooting-jobset-interruption
Diagnoses GKE JobSet interruptions, restarts, and preemptions for AI/ML training workloads autonomously. Use when troubleshooting JobSet restart loops, spot VM preemptions, node readiness failures, host VM issues, or coordinator worker crashes. Don't use for general GKE cluster creation, basic workload deployment, or…
gke-node-notready
Diagnoses GKE nodes reporting NotReady or Unknown status by inspecting node conditions, events, kubelet/containerd logs, and node metrics, then proposing safe remediations. Use when nodes show NotReady, when the kubelet stops posting node status, or when workloads are evicted or stuck Pending due to node health. Don't…
gke-workload-troubleshooting
Diagnoses GKE workload failures (CrashLoopBackOff, OOMKilled, ImagePullBackOff, Pending, etc.) via logs and events. Use when pods fail to start or crash repeatedly. Don't use for GKE cluster infrastructure provisioning, node pool creation, or non-Kubernetes Google Cloud services.
gke-ai-troubleshooting-handle-disruption-gpu-tpu
Diagnoses, predicts, and mitigates node disruptions during Compute Engine host maintenance and hardware or software maintenance events for GPU and TPU workloads on GKE. Use when diagnosing node disruptions, predicting host maintenance events on GPU/TPU nodepools, inspecting node interruption PromQL metrics, auditing…
agentcore-investigation
Investigate Bedrock AgentCore runtime sessions via CloudWatch Logs Insights — resolve session/trace IDs, query OTEL spans, filter noise, build timelines. Use when debugging AgentCore agent sessions, tracing tool calls, or analyzing latency.
troubleshoot-sandbox
Troubleshoot OpenSandbox issues by running diagnostics (logs, inspect, events, summary) via CLI or HTTP API to diagnose sandbox failures like OOM, crash, image pull errors, network problems, etc.