llm-swarm-router: Skill for Claude Code

.agents/skills/netllm-doctor/SKILL.md

netllm-doctor is a skill for Claude Code from matthewdcage/llm-swarm-router. It costs 81 tokens per session (1,441 once invoked), scanned A, original, MIT.

A troubleshooting guide for netllm, a local tool that connects coding agents to language models and other agents.

In plain words
What is it for?
Use it when netllm cannot start, find models, reach its agent, or discover other swarm peers.
Why use it?
It checks common setup, network discovery, command-path, provider, and configuration problems when the tool is unavailable or incomplete.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter. Also seen: installed under .agents/ (shared by several agents); mentions Codex.

This is matthewdcage/llm-swarm-router's own configuration. It tells Claude Code how to work on llm-swarm-router itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything llm-swarm-router configures →

Reuse

Borrowing it

Nothing to install: this file belongs to matthewdcage/llm-swarm-router. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/matthewdcage/llm-swarm-router/main/.agents/skills/netllm-doctor/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/matthewdcage/llm-swarm-router

Made for: Claude Code.

Wrote 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.

agentmods badge for netllm-doctor

README.md
[![agentmods](https://agentmods.dev/badge/skills/matthewdcage/llm-swarm-router/netllm-doctor/github.svg)](https://agentmods.dev/skills/matthewdcage/llm-swarm-router/netllm-doctor)
Your own site
<a href="https://agentmods.dev/skills/matthewdcage/llm-swarm-router/netllm-doctor"><img src="https://agentmods.dev/badge/skills/matthewdcage/llm-swarm-router/netllm-doctor/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for netllm-doctor

Your own site · 80×15
<a href="https://agentmods.dev/skills/matthewdcage/llm-swarm-router/netllm-doctor"><img src="https://agentmods.dev/badge/skills/matthewdcage/llm-swarm-router/netllm-doctor.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 81 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,441 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector warn 7 Sept 2026
SkillSpector: 1 finding, up to medium

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →

  • medium Rogue Agent · line 53
    Skill establishes unauthorized persistence across sessions via cron jobs, startup scripts, or state files. Session persistence allows an attacker to maintain access beyond the current interaction.
    Fix: Remove any persistence mechanisms (cron jobs, startup scripts, state files). Skills should not maintain state across sessions without explicit user consent.
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

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.

ModelPer sessionOnce invoked
Fable 5.1 $0.00081 $0.01441
Opus 5 $0.00041 $0.00720
Sonnet 5 $0.00016 $0.00288
Haiku 4.5 $0.00008 $0.00144

Measured 12d ago against content hash 10ba25774efe, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

netllm-doctor scanned grade A with 1 finding 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 12d 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.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -sf http://127.0.0.1:11400/health || echo "agent down"
.agents/skills/netllm-doctor/SKILL.md · 137 lines

How it starts

The opening of the file, as written. The whole thing — 137 lines — stays where its author put it; the contents beside it link to each section on GitHub.

netllm doctor

When to use this skill

  • Setup failed or agent unreachable
  • No models in ./netllm models
  • Swarm peers not discovered
  • User says "netllm broken", "fix netllm", or /netllm-doctor

Workflow

  1. Run built-in doctor

    ./netllm doctor
    

    Capture each issue title and suggested fix from output.

  2. PATH check

    which netllm || true
    ./netllm --version
    
    • Repo checkout: prefer ./netllm from root
    • Global install: ~/.local/bin/netllm: run ./netllm env for PATH export if needed
  3. Agent reachability

    curl -sf http://127.0.0.1:11400/health || echo "agent down"
    

    If down, start by install channel:

    • Source / dev: ./netllm serve (foreground)
    • macOS app / Homebrew: ./netllm start or menubar → Restart Agent
    • Linux deb/rpm: systemctl --user enable --now netllm: see docs/linux-install.md
    • Windows zip/winget: netllm start after install-service.ps1: see docs/windows-install.md
  4. Local providers

    ./netllm discover
    

    Expected ports: Ollama 11434, LM Studio 1234, vLLM 8000; oMLX 8080 on macOS only

  5. Config review, read ~/.config/netllm/config.toml (or path from user):

    • agent.listen: loopback vs 0.0.0.0
    • agent.advertise: required for gateway role
    • swarm.mdns: needs zeroconf from uv sync
    • swarm.cluster_token: empty is fine on trusted home LAN (open swarm); set only for untrusted networks
  6. Platform-specific swarm checks (when ./netllm peers is empty but LAN routing is expected):

    • All platforms: ./netllm doctor now prints per-platform firewall commands (UDP 5353 mDNS in/out + TCP 11400 in) when mDNS looks blocked. LAN-bound agents auto-run a one-shot subnet scan 10s after start when mDNS finds nothing.
    • Loopback peers: ./netllm peers lists loopback-bound agents as found but unreachable — fix is menubar LAN mode, netllm init --swarm, or serve --host 0.0.0.0 on that machine
    • Token mismatches: heartbeats return 401; align tokens with netllm swarm-token + netllm join URL --token T
    • Linux: mDNS uses Avahi via python-zeroconf; install Avahi if browse fails. Fallback: swarm.peers or ./netllm peers --subnet-scan --save
    • Windows: mDNS is often blocked by firewall or missing Bonjour: prefer static swarm.peers or --subnet-scan. Allow inbound TCP on agent port (default 11400) when serve --host 0.0.0.0
    • All platforms: Guest Wi‑Fi often blocks mDNS; loopback bind (127.0.0.1) hides the agent from LAN peers

Read the full file on GitHub · 137 lines

Changes

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.

  1. 12d ago First seen · 137 lines · 81 tokens per session scan A 10ba25774efe

Subscribe to this mod's changes

netllm-doctor is a skill published in the GitHub repository matthewdcage/llm-swarm-router (25 stars, last pushed 10d ago), licensed MIT. It adds 81 tokens to every session and 1,441 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.