mdvs: Skill for Claude Code

.claude/skills/book/SKILL.md

book is a skill for Claude Code from edochi/mdvs. It costs 32 tokens per session (941 once invoked), scanned B, original, MIT.

A set of rules for maintaining an mdBook documentation site. It defines where pages live, how the page list controls structure, and how to write accurate, runnable examples from the repository's example fixture.

In plain words
What is it for?
Use it when adding or moving book pages, writing command examples, or checking documented flags and errors against the source of truth.
Why use it?
It prevents documentation from using made-up output, broken commands, or examples that do not match the project's documented behavior.

Skill for Claude Code

Written for Claude Code: installed under .claude/.

This is edochi/mdvs's own configuration. It tells Claude Code how to work on mdvs 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 mdvs configures →

Reuse

Borrowing it

Nothing to install: this file belongs to edochi/mdvs. 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/edochi/mdvs/main/.claude/skills/book/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/edochi/mdvs

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 book

README.md
[![agentmods](https://agentmods.dev/badge/skills/edochi/mdvs/book/github.svg)](https://agentmods.dev/skills/edochi/mdvs/book)
Your own site
<a href="https://agentmods.dev/skills/edochi/mdvs/book"><img src="https://agentmods.dev/badge/skills/edochi/mdvs/book/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 book

Your own site · 80×15
<a href="https://agentmods.dev/skills/edochi/mdvs/book"><img src="https://agentmods.dev/badge/skills/edochi/mdvs/book.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 32 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 941 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 1 finding. 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.00032 $0.00941
Opus 5.5 $0.00013 $0.00376
Sonnet 5.5 $0.00006 $0.00188
Haiku 4.5 $0.00003 $0.00094

Measured 10d ago against content hash 0b71a958df13, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade B, and why

book scanned grade B 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 10d 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.

Unrestricted tool accessmediumExcessive agency

A wildcard tool grant or "run any command" leaves no least-privilege boundary at all.

2. Re-run any commands whose output may have changed.
.claude/skills/book/SKILL.md · 128 lines

How it starts

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

mdBook Documentation Conventions

Location

The book lives in book/ at the repo root. book/src/SUMMARY.md is the source of truth for page structure — always check it before adding or moving pages.

Running example

All pages use example_kb/ (the Prismatiq Lab fixture) for examples. Never use a hypothetical vault. Refer to the fixture's characters, fields, and edge cases by name when illustrating concepts.

Key reference: example_kb/.plan.md documents every file, field, and edge case in the fixture.

Content rules

Every command output must be real

  1. Run the command against example_kb before writing.
  2. Capture the actual output.
  3. Paste it into the book. Trim if long, but never invent lines.
  4. If a command's output changes (new fields, format tweaks), re-run and update the book.

Every code block must be copy-pasteable

  • Shell examples must work if the reader clones the repo and runs them from the repo root.
  • Use example_kb as the path argument, not . or a made-up directory.
  • Quote arguments correctly for common shells (bash/zsh).

Accuracy over completeness

  • Check docs/spec/commands/ for the authoritative behavior, flags, and error conditions.
  • Rewrite for users — the specs are for implementors. Drop internal details (Arrow types, struct names, pipeline steps).
  • If unsure whether a behavior is correct, run it and verify before writing.

Tone

  • User-facing. The reader has never seen the codebase. No internal architecture, no struct names, no module paths.
  • Direct. Lead with what the command does, not how it works internally.
  • Concise. Short paragraphs, bullet points, tables. Long prose blocks lose readers.
  • No emojis unless explicitly requested.

Page structure

Command pages (commands/*.md)

# command-name

<One-sentence description of what the command does.>

## Usage

\`\`\`bash
mdvs <command> [args] [flags]
\`\`\`

## Flags

<Table: flag, default, description>

## What it does

<Brief explanation — 2-4 paragraphs max. What the user needs to know, not how it works internally.>

## Examples

<2-4 examples with real output from example_kb. Start simple, build to complex.>

Read the full file on GitHub · 128 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. 10d ago First seen · 128 lines · 32 tokens per session scan B 0b71a958df13

Subscribe to this mod's changes

book is a skill published in the GitHub repository edochi/mdvs (27 stars, last pushed 11d ago), licensed MIT. It adds 32 tokens to every session and 941 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it B with 1 finding (unrestricted tool access). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-10-05.