update-docs

Instructions for updating the Jolt project’s Rust documentation after code changes. They describe how to compare commits, inspect changed Rust files, review the documentation outline, and decide which changes need documentation updates.

In plain words
What is it for?
Use them when preparing documentation after a commit, checking for changed APIs or features, and updating the appropriate pages in the project’s book.
Why use it?
They provide a consistent way to keep the documentation aligned with user-visible behavior and public interfaces. They also help avoid unnecessary edits for internal refactors or fixes that do not change documented behavior.

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/a16z/jolt/update-docs
Any agent
npx skills add a16z/jolt --skill update-docs
Clone the repo
git clone --depth 1 https://github.com/a16z/jolt

Made for: Claude Code, Codex.

Per session 17 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 776 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.00017 $0.00776
Opus 5 $0.00009 $0.00388
Sonnet 5 $0.00003 $0.00155
Haiku 4.5 $0.00002 $0.00078

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

Security

Grade A, and why

update-docs 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.

.claude/skills/update-docs/SKILL.md · 90 lines

How it starts

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

You are updating the Jolt documentation in book/ based on code changes since a base commit.

The base commit is: $ARGUMENTS

If no base commit was provided, ask the user for one before proceeding.

Step 1: Gather the diff

Run:

git diff $ARGUMENTS..HEAD -- '*.rs'

Also get a summary of changed files:

git diff --stat $ARGUMENTS..HEAD -- '*.rs'

Read the diff carefully. Focus on understanding:

  • What functionality changed or was added
  • Whether public APIs changed (new types, renamed functions, changed signatures)
  • Whether new features, protocols, or subsystems were introduced
  • Whether existing behavior was modified in user-visible ways

Step 2: Read the docs outline

Read book/src/SUMMARY.md to understand the current documentation structure and what topics are already covered.

Step 3: Triage — decide what needs updating

Not every code change requires a docs update. Apply this decision framework:

Changes that DO NOT need docs updates:

  • Internal refactors that don't change behavior or APIs
  • Performance optimizations (unless they change usage patterns or add new features like new CLI flags)
  • Bug fixes (unless they change documented behavior)
  • Test changes
  • CI/CD changes
  • Dependency bumps
  • Code style / formatting changes
  • Changes to internal implementation details that aren't documented

Changes that DO need docs updates:

  • New user-facing features (new CLI commands, new macros, new configuration options)
  • Changes to the proving/verification API that users interact with
  • New architectural components that are significant enough to document
  • Changes to existing documented behavior
  • New optimizations or techniques that are novel and worth explaining in "How it works"
  • Removed or deprecated features that are currently documented

Changes that may warrant a NEW doc page:

  • A major new subsystem or feature (e.g., a new commitment scheme, a new lookup argument)
  • A new user-facing workflow (e.g., a new way to profile, a new SDK feature)

Read the full file on GitHub · 90 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 · 90 lines · 17 tokens per session scan A dd0e1b3992ee

Subscribe to this mod's changes

update-docs is a skill published in the GitHub repository a16z/jolt (1,020 stars, last pushed 2d ago), licensed Apache-2.0. It adds 17 tokens to every session and 776 once invoked, about $0.0001 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

linea-dependency-maintenance

Safely plan and execute dependency maintenance for JavaScript/TypeScript (npm, pnpm) and GitHub Actions, including npm lockfiles, pnpm workspaces, catalogs, overrides, SHA-pinned action versions, release-age policies, audits, CI validation, Dependabot boundaries, PRs, and GitHub tracking issues. Use whenever the user…

Consensys/doc.linea · 113 tokens

pr-content-review

Review docs.linea.build content for editorial compliance (voice, terminology, naming, formatting, frontmatter) before opening or merging a pull request. Use before submitting a PR, when reviewing someone else's draft, or when asked to audit existing pages.

Consensys/doc.linea · 53 tokens

starknet-js

Use when writing or debugging JavaScript/TypeScript that interacts with Starknet through the starknet.js SDK — building Call objects or calldata, encoding/decoding Cairo types (felt252, u256, structs, arrays, spans, ByteArray, Option/Result/custom enums), or working with contracts, accounts, providers, transactions…

starknet-io/starknet.js · 79 tokens

EMILIA Trust Verification

Verify the authenticity of AI-agent authorization receipts and human-device signoffs. Use this whenever a user shares a "trust receipt", an "authorization receipt", a "signoff", or WebAuthn/passkey approval evidence and asks whether it is valid, genuine, or tampered with. Pairs with the public EMILIA Protocol MCP…

emiliaprotocol/emilia-protocol · 94 tokens

Cryptographic Analysis & Assessment

SSL/TLS auditing, cipher suite analysis, hash algorithm identification, encryption implementation review, and cryptographic weakness detection in code.

Masriyan/Claude-Code-CyberSecurity-Skill · 30 tokens

author-doc-page

Scaffold or draft a new docs.linea.build page to editorial standards. Use when creating a new page, writing a first draft, or helping a contributor who isn't a professional writer produce content that meets the documentation team's expectations.

Consensys/doc.linea · 49 tokens