Skip to main content
skill CX Codex

medic — Claude Code skill: checks and installation

The medic Claude Code skill checks whether an agent team is ready to work and reports problems. Run it on a new machine or after agents stop communicating.

Apache-2.0 ★ 869 updated 2026-11-16

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add sno-ai/sno-station-skills --skill medic -a claude-code
Open on GitHub

What medic does

medic inspects the local setup and prints a line for each check. It looks for required tools and core skills, tests whether skill commands respond, and checks hooks, Reach, heartbeat, subscription quotas and temporary disk space.

Each result is marked OK, WARN or FAIL; warnings and failures include a suggested fix command. The skill only reads system state. It does not install or repair software, start or stop processes, or spend anything. The free-space threshold is 500 MB unless changed with --min-free-mb N.

Requirements include bash 4+, GNU coreutils, jq, reach 2.0+, heartbeat 1.0+ and subscription-quota-check 1.0+. medic does not test whether an agent can answer a prompt or deliver a message; those need separate tests.

What it helps with

  • check whether required tools and core skills are installed
  • find broken skill commands or unconfigured hooks
  • see whether Reach and heartbeat are active
  • check subscription quota access and temporary disk space

Example prompts for the agent

  • Run sno medic run and report the agent team's status.
  • Check whether this new machine is ready for the agent team.
  • Show the setup problems and their suggested fix commands.

How to install medic

1Skills CLI (Vercel)

npx skills add sno-ai/sno-station-skills --skill medic -a claude-code

2Manually: put the files in place

~/.claude/skills/skill/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/skill/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about medic

How do I install medic in Claude Code?

Run npx skills add sno-ai/sno-station-skills --skill medic -a claude-code. The skill file is installed at ~/.claude/skills/skill/SKILL.md.

What does medic do?

It checks tools, skills, commands, hooks, Reach, heartbeat, subscription quotas and temporary disk space. It reports results and fix commands but does not change the machine.

What does medic need to run?

It requires bash 4+, GNU coreutils, jq, reach 2.0+, heartbeat 1.0+ and subscription-quota-check 1.0+.

Source text

SKILL.md · Apache-2.0
---
name: medic
description: "Check that this machine's agent team can work and say what is wrong in plain lines: tools installed, core skills installed, skill commands runnable, hooks configured, Reach seat live, a heartbeat running, both vendors' quota readable, temp space free. Checks only, never repairs. Use on a new machine, when agents stop reaching each other or a long run fails to start, or when the owner asks whether everything is healthy."
requires:
  programs:
    - {name: reach, min_version: "2.0"}
    - {name: heartbeat, min_version: "1.0"}
    - {name: subscription-quota-check, min_version: "1.0"}
  harness:
    - {slot: 4.shell, need: required}
---

# medic

`sno medic run` looks at the agent team on this machine and prints one line per check. It reads and
reports; it never installs, repairs, starts, stops or spends anything.

```
OK <check>: <what was found>
WARN <check>: <what is wrong> -> <the command that fixes it>
FAIL <check>: <what is wrong> -> <the command that fixes it>
MEDIC ok=N warn=N fail=N
```

`FAIL` means the team cannot work at all (a required program is missing, no agent command line is
installed, Reach is broken). `WARN` means it works worse than it should. Exit status is 0 when there is
no `FAIL`, 1 otherwise, 2 for a wrong command line.

Prerequisites: bash 4+, GNU coreutils and jq. `sno medic` with no arguments, or `--help`, prints the usage.

## Use

1. Run `sno medic run`. It takes about ten seconds because it asks `sno doctor` and reads both quotas.
2. Tell the owner the result in plain words: the counts, then each `WARN` and `FAIL` line with its fix.
   Do not paste the whole output when everything is `OK`; one sentence says so.
3. Run a fix only when the owner asks for it. Installing and updating change the machine, and one
   warning is often not worth a fix (for example no heartbeat when nothing long is running).
4. After a fix, run `sno medic run` again and read the same line: it must now say `OK`.

## What each check reads

| Check | Looks at | Common fix |
|---|---|---|
| `tools` | `sno`, `jq`, `tmux`, `git` are on PATH, and `sno heartbeat` and `sno subscription-quota-check` run | install the named program |
| `agent-cli` | `claude` or `codex` is on PATH | install one of them |
| `skills` | the six core skills (`reach`, `heartbeat`, `join-talk`, `handoff`, `deliver`, `charter`) exist where each installed agent reads skills | reinstall the skills |
| `commands` | `sno deliver-proof`, `sno handoff-checkpoint`, `sno rotate-agent-resume` and `sno rem-reflect` answer `--help` | reinstall the skills |
| `hooks` | `sno doctor` reports hooks configured (and trusted, for codex) for each installed agent | reinstall the skills |
| `reach` | `sno doctor` reports Reach as ok | the fix `sno doctor` names |
| `skill-files` | every installed skill file passes `sno doctor` | update the skills |
| `seat` | this agent's own seat (`SNO_REACH_ADDR`) is live, or at least one seat is live | run `join-talk` in this window |
| `heartbeat` | at least one heartbeat is running on this machine | arm one when a long job starts |
| `quota` | each installed agent's subscription quota can be read and is not `wait` | log in, or wait for the reset |
| `temp-space` | free space in `$TMPDIR` (or `/tmp`) is at least 500 MB; change it with `--min-free-mb N` | free space or point `TMPDIR` elsewhere |

A check that cannot run because a program is missing prints `WARN <check>: not checked, <program> is
missing`; fix the `tools` line first.

## Limits

`sno medic` does not prove that an agent can answer a prompt or that a seat delivers a message: for a live
receiver test before a vendor switch use `rotate-agent-preflight` (the `rotate-agent` skill), and for a
single unit's behaviour use that unit's own self-test.

© sno-ai · Apache-2.0 · sno-ai/sno-station-skills

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set40

The whole set →
heartbeat The heartbeat Claude Code skill runs recurring checks and watches for long-running jobs to finish. Request progress updates or wait for a completion file. CX Codex +1 ★ 869repo stars handoff handoff — a skill for Claude Code transfers a task to a new agent with a verified brief and an explicit release. It handles executor changes, including direct assignments without a work card. CX Codex +1 ★ 869repo stars rem-reflect rem-reflect — a Claude Code skill that reviews agent sessions and stores lessons for later work. It processes sessions daily and can bring saved lessons into a new session. CX Codex +1 ★ 869repo stars sno-cli The sno-cli Claude Code skill operates the sno command-line tool. It handles Sno product setup and checks, plus Station and REM tasks. CX Codex +1 ★ 869repo stars peer-review The peer-review Claude Code skill runs adversarial reviews of code, plans, specs, and migration manifests. It starts on review or audit requests and can carry code findings through a fix loop. CX Codex +1 ★ 869repo stars cross-vendor-security-audit The cross-vendor-security-audit Claude Code skill reviews security questions and searches code for vulnerabilities. It runs the full audit workflow on explicit audit, pen-test, or report requests. CX Codex +1 ★ 869repo stars catch-report The catch-report Claude Code skill compares findings from peer reviews with mistakes agents catch themselves. It runs when someone asks for review results or a weekly summary. CX Codex +1 ★ 869repo stars away-brief The away-brief Claude Code skill creates a short report on completed work, blockers, pending questions, and quota readings. It runs when someone asks what happened while they were away. CX Codex +1 ★ 869repo stars

Project sponsors

Companies that keep this analytics open