wf-doctor

wf-doctor is a skill for Claude Code from dioptx/weft. It costs 38 tokens per session (348 once invoked), scanned A, original, MIT.

A read-only checker for Weft templates, comparing working copies with their bundled originals and checking whether the plugin’s local Git clone is behind upstream.

In plain words
What is it for?
Use it only with `/wf-doctor` to find outdated or modified templates and decide whether to reconcile or remove a drifting local copy.
Why use it?
It reveals template drift that ordinary project Git tracking cannot show, while also reporting whether the plugin copy may be outdated.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter.

Runs only inside its plugin — its command needs a path that Claude Code sets for a plugin’s own hooks and for nothing else. Install the plugin, not this.

Part of the weft plugin — 13 skills, 4 hooks shipped together

Good fit Use it only with /wf-doctor to find outdated or modified templates and…

Compare 6 skills from other repositories ↓
View source ↗ dioptx/weft
Install

Getting it into your agent

This one installs as part of its plugin. Adding the marketplace and installing the plugin brings it with everything else the plugin ships.

Claude Code
/plugin marketplace add dioptx/weft
Claude Code
/plugin install weft

Made for: Claude Code.

Or install weft, the plugin that ships this one along with the rest of its 13 skills, 4 hooks.

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 wf-doctor

README.md
[![agentmods](https://agentmods.dev/badge/skills/dioptx/weft/wf-doctor.svg)](https://agentmods.dev/skills/dioptx/weft/wf-doctor)
Your own site
<a href="https://agentmods.dev/skills/dioptx/weft/wf-doctor"><img src="https://agentmods.dev/badge/skills/dioptx/weft/wf-doctor.svg" alt="Measured on agentmods" height="20"></a>
Per session 38 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 348 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
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.00038 $0.00348
Opus 5 $0.00019 $0.00174
Sonnet 5 $0.00008 $0.00070
Haiku 4.5 $0.00004 $0.00035

Measured 7d ago against content hash 870eab5a2ec4, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

wf-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 7d 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.

skills/wf-doctor/SKILL.md · 33 lines

What it actually says

Weft Template Doctor

Report whether the user's templates are current. Git already covers project-local templates as repo files; this surfaces the gap git can't see — a working copy that has drifted from the plugin-bundled template it was derived from — plus whether the weft plugin's own git clone is behind upstream.

Instructions

  1. Run the currency check:

    python3 "${CLAUDE_PLUGIN_ROOT}/core/cli.py" doctor
    
  2. If --json is in $ARGUMENTS, emit raw JSON instead:

    python3 "${CLAUDE_PLUGIN_ROOT}/core/cli.py" doctor --json
    
  3. Read the output back to the user:

    • "plugin clone behind by N" → suggest git pull in the weft repo to refresh bundled templates.
    • Any drifted template → the working copy differs from the bundled canonical. Show its path and ask whether to reconcile (keep the local edits) or delete the copy to fall back to the canonical version.
    • All current and clone up to date → say everything's current; nothing to do.

Notes: read-only, no network. The plugin-clone "behind" count is only as fresh as the last git fetch, so a stale unknown/ok may just mean it hasn't fetched recently.

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. 7d ago First seen · 33 lines · 38 tokens per session scan A 870eab5a2ec4

Subscribe to this mod's changes

wf-doctor is a skill published in the GitHub repository dioptx/weft (25 stars, last pushed 22d ago), licensed MIT. It adds 38 tokens to every session and 348 once invoked, about $0.0002 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

app-it

Turn a local project or a hosted web app (including a published Claude Artifact URL) into a macOS Dock-launchable .app. Use when the user wants a clickable Dock app, local app package, icon, App It install, hosted-URL or Artifact wrapper, or repeatable desktop launcher. Defaults to native Swift WebKit, shipped…

Christian-Katzmann/app-it · 91 tokens

app-it-windows

Create Windows beta desktop launchers for local web projects: WPF + WebView2 .exe, Start Menu shortcut, .ico, warm server, quit cleanup. Use when the user asks for app-it-windows, a Windows app, .exe launcher, Start Menu shortcut, Windows package, or desktop icon. CI-guarded but untested on Windows hardware; never…

Christian-Katzmann/app-it · 89 tokens

stats

Query or render the state of the scattered kit/tide/tg-cleanup/learned ledgers (the dwarves-kit gate/proof/telemetry corpus, tide file-move state, tg-cleanup snapshots, the learning ledger), and detect + propose backlog rows off anomalies in that state. Use when the operator asks to SEE ledger state -- "show me the…

dwarvesf/dwarves-kit · 367 tokens

grill

Interrogate a plan or decision one question at a time before capture, keeping a decision-plus-rationale ledger, then route to the right capture skill.

SpaiR/task-pipeline · 33 tokens

tfx-hub

A Korean-language skill for managing a TFX message hub, which is a local message bus for communication between coding agents. It supports starting, stopping, checking, and routing work through the hub.

tellang/triflux · 84 tokens

tfx-review

A code-review workflow that asks several command-line AI reviewers to inspect changes independently, then reports issues that at least two reviewers agree on. TDD means test-driven development, where tests are written to guide implementation, but this add-on is for reviewing code rather than defining TDD.

tellang/triflux · 83 tokens