doctor

A diagnostic report for Cladding's runtime health, including coding-tool hooks, CI version pinning, project-governance activity, and missed event signals. Hooks are automatic callbacks that run at points such as session start or after an edit; CI is automated build and test work.

In plain words
What is it for?
Use it before tuning the host or when results look incomplete. It checks observed hook activity and versions, warns about floating CI package versions, and summarizes governance events and missed signals.
Why use it?
It helps find silent hooks, changing Cladding versions in automated builds, and incomplete scan or run records. It reads the available logs and reports problems without changing project files.

Skill for Claude CodeCodex

Install

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.

agentmods
npx agentmods add skills/qwerfunch/cladding/doctor
Any agent
npx skills add qwerfunch/cladding --skill doctor
Clone the repo
git clone --depth 1 https://github.com/qwerfunch/cladding

Made for: Claude Code, Codex.

Per session 93 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 856 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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 $0.00093 $0.00856
Opus 5 $0.00046 $0.00428
Sonnet 5 $0.00019 $0.00171
Haiku 4.5 $0.00009 $0.00086

Measured 2d ago against content hash e530159f5d3a, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

doctor 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 2d 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.

plugins/antigravity/skills/doctor/SKILL.md · 45 lines

How it starts

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

Cladding doctor

Run clad doctor from the project root. The verb is observability — it never mutates the working tree.

  • --cwd <path> — read events from a project directory other than the current one (default cwd).
  • --json — emit the raw DoctorReport shape instead of the formatted text surface; the additive shape ({cwd, events, sentinelMiss, governance, hooks, ciVersion}) is the stable wire format for MCP clients and follow-up tooling.

The text surface prints:

  1. One pulse line with total events and total sentinel-miss count (pass when zero misses, note otherwise).
  2. An event-type breakdown line (one <type>=<count> token per non-zero EventType).
  3. Claude Code hook health: whether the runtime has actually been observed, whether the observed engine version matches the current CLI, and the last firing time (or never observed) for session start, prompt submit, before edit, after edit, and session stop.
  4. A non-blocking CI warning naming each GitHub Actions workflow that invokes an unversioned or floating npx cladding package. Numeric selectors such as [email protected] and [email protected] stay quiet.
  5. Governance counts for gate runs, done attempts and rejections, stop blocks, known-failing Stop exits, blocked fingerprints reproduced by a later gate, and attestation state.
  6. When sentinel-miss events exist:
    • by phase / by cause / by fallback aggregates from the v0.3.39 telemetry payload.
    • Top-5 missed sentinels (CONVENTIONS_MD / ARCHITECTURE_YAML / SCENARIO_FLOWS / CAPABILITIES_YAML / WHY / WHAT / PURPOSE) sorted by count desc, name asc.
    • Last 3 unique dispatcher error strings (most recent first; errors are truncated to 200 chars at the emit site).
    • A one-line tuning hint.

Exit codes

  • 0 — events.log was either missing (greenfield) or readable. A greenfield workspace prints a friendly note and exits 0; a healthy host with zero misses also exits 0 with a pass line.
  • 1events.log.jsonl exists but cannot be parsed as JSONL (corrupt telemetry).

Read the full file on GitHub · 45 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. 2d ago First seen · 45 lines · 93 tokens per session scan A e530159f5d3a

Subscribe to this mod's changes

doctor is a skill published in the GitHub repository qwerfunch/cladding (14 stars, last pushed 4d ago), licensed MIT. It adds 93 tokens to every session and 856 once invoked, about $0.0005 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-30.

Related

Other skills, from other repositories

map-plan

ARCHITECT phase - decompose complex tasks into atomic subtasks with research, spec, and branch-scoped plan artifacts under .map.

azalio/map-framework · 31 tokens

map-debug

Structured MAP debugging via task-decomposer, actor, and monitor agents. Use when reproducing a bug, isolating a regression, or diagnosing an error with specialized agents — including failing or flaky tests (pytest AssertionError), crashes and segmentation faults, memory-corruption or memory errors in native/C…

azalio/map-framework · 213 tokens

map-learn

Capture reusable lessons after a completed MAP workflow. Use when a MAP run has finished and you want rules written to .claude/rules/learned/ from a workflow summary or handoff. Do NOT use during active implementation.

azalio/map-framework · 51 tokens

map-efficient

State-machine MAP execution workflow for Codex. Use when implementing an approved MAP plan end to end, resuming from branch MAP taskplan or stepstate.json artifacts, or running non-trivial multi-subtask work. Use map-fast for tiny one-shot edits.

azalio/map-framework · 55 tokens

map-explain

Deep walkthrough of code, a diff, or the whole project — problem, entities, flow, load-bearing-line rationale, side effects, assumptions, breakage. Use when learning unfamiliar code or auditing a diff.

azalio/map-framework · 46 tokens

map-task

Execute a single subtask from an existing MAP plan via Actor and Monitor. Use when map-plan has decomposed work and you want fine-grained control over one subtask. Do NOT use without an existing plan; run map-plan first.

azalio/map-framework · 51 tokens