blueprint-docs-currency

blueprint-docs-currency is a skill for Claude Code from laurigates/claude-plugins. It costs 49 tokens per session (1,926 once invoked), scanned A, original, MIT.

A project rule that requires code changes and their related documentation to be committed together. It covers public APIs, file formats, architecture decisions, research promoted into docs, and tracker updates.

In plain words
What is it for?
Use it when changing an API or format, recording an architecture decision, publishing research in the docs folder, or advancing a tracked feature.
Why use it?
Documentation can otherwise lag behind the code and leave users or contributors with outdated instructions. Keeping both changes together preserves an accurate record of how the project works.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter. Also seen: mentions .claude-plugin; mentions CLAUDE.md; names the TodoWrite tool.

Part of the blueprint-plugin plugin — 35 skills shipped together

Good fit Use it when changing an API or format, recording an architecture decision, publishing research in the docs folder, or advancing a tracked feature.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/laurigates/claude-plugins/blueprint-docs-currency
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.

Any agent
npx skills add laurigates/claude-plugins --skill blueprint-docs-currency
Clone the repo
git clone --depth 1 https://github.com/laurigates/claude-plugins

Made for: Claude Code.

Or install blueprint-plugin, the plugin that ships this one along with the rest of its 35 skills.

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 blueprint-docs-currency

README.md
[![agentmods](https://agentmods.dev/badge/skills/laurigates/claude-plugins/blueprint-docs-currency/github.svg)](https://agentmods.dev/skills/laurigates/claude-plugins/blueprint-docs-currency)
Your own site
<a href="https://agentmods.dev/skills/laurigates/claude-plugins/blueprint-docs-currency"><img src="https://agentmods.dev/badge/skills/laurigates/claude-plugins/blueprint-docs-currency/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 blueprint-docs-currency

Your own site · 80×15
<a href="https://agentmods.dev/skills/laurigates/claude-plugins/blueprint-docs-currency"><img src="https://agentmods.dev/badge/skills/laurigates/claude-plugins/blueprint-docs-currency.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 49 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,926 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. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
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.00049 $0.01926
Opus 5.5 $0.00020 $0.00770
Sonnet 5.5 $0.00010 $0.00385
Haiku 4.5 $0.00005 $0.00193

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

Security

Grade A, and why

blueprint-docs-currency 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 22d 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.

blueprint-plugin/skills/blueprint-docs-currency/SKILL.md · 162 lines

How it starts

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

Blueprint Docs Currency

Same-commit discipline for code and documentation. This skill is the reusable version of claude-plugins' .claude/rules/docs-currency.md, refined for blueprint-driven projects.

When to Use This Skill

Use this skill when… Skip when…
Committing code that changes a public API, format spec, or error enum Refactoring internal helpers with no external surface change
Promoting research findings from tmp/ to docs/ Scratch work that will not ship
Landing an architectural decision Implementation detail with no branching trade-off
Advancing a tracker entry past "in progress" Small task completion that does not cross a phase gate
A reviewer flags missing documentation Typo fixes or whitespace changes

The Rule

Code + its docs land in the same commit. Research promotes to docs/ before the feature advances past "in progress." ADR-worthy decisions land with a new or updated ADR in the same commit.

Same-commit scope

Change kind Doc target
Public API / exported type Inline docstring + reference doc under docs/api/ (or tool-appropriate)
File-format spec docs/format-spec/<name>.md (hand-written prose, not generated)
Error enum / protocol code docs/errors/<name>.md or the protocol reference
Milestone / phase status Feature-tracker entry + docs/PLAN.md if the phase advanced
Architectural decision New ADR under docs/adrs/NNNN-<title>.md
New CLI flag or subcommand README + relevant docs/cli/ page

Forward-reference blueprint-plugin:blueprint-curate-docs for how to produce the curated .claude/rules/ entry when the code change surfaces an AI-context gotcha worth capturing.

Research promotion workflow

Research findings arrive in tmp/ (gitignored). Before the dependent feature advances past "in progress" in the blueprint feature tracker:

  1. Move the findings into docs/ at a canonical path (e.g. docs/research/<topic>.md, or directly into docs/format-spec/<name>.md if the research is the spec).
  2. If the research produced a decision, file an ADR. ADRs without a decision record are a code smell — revert to research notes.
  3. Update the feature-tracker entry with the docs/ path in its evidence field (blueprint-plugin:feature-tracking handles the mechanical edit).
  4. Only then flip the tracker status from in_progress to done.

Read the full file on GitHub · 162 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. 22d ago Changed · +33 lines · +4 tokens per session 30e838a88715
  2. 1mo ago First seen · 129 lines · 45 tokens per session scan A 20172d9348b7

Subscribe to this mod's changes

blueprint-docs-currency is a skill published in the GitHub repository laurigates/claude-plugins (60 stars, last pushed yesterday), licensed MIT. It adds 49 tokens to every session and 1,926 once invoked, about $0.0002 per session on Opus 5.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-09-03.

Related

Other skills, from other repositories

changelog-summarizing

Use this skill when the user asks to summarize, recap, or post about repository changes in the Shopware AI Coding Tools marketplace since a given date — phrases like "write a changelog post for Discord", "recap this week's commits for Slack", "summarize what shipped since 2026-04-01", "draft a release announcement".…

shopwareLabs/ai-coding-tools · 106 tokens

commit-message-writing

Use this skill when the user explicitly asks to generate, write, draft, or create a commit message, squash commit, commit title, or merge commit message for the Shopware core repository (shopware/shopware). Supports two modes — full commit messages (title + body) for branch commits, and squash merge titles…

shopwareLabs/ai-coding-tools · 160 tokens

morning-brief

Operator's read-only morning view of the current GitHub repo in one pass: open counts per queue label, merge-ready PRs, parked decisions with their RECOMMENDED lines, and loop-lane telemetry freshness; never mutates issues, PRs, labels, or comments. Use when: 'morning brief', 'ops dashboard', 'what needs attention'…

melodic-software/claude-code-plugins · 79 tokens

realign-file-names

Apply a file-name rename plan one file at a time, one human acceptance each: git mv, rewrite only the reference shapes each citing file's tier allows, rebuild generated records, and sweep for stragglers. Refuses a blanket yes, a range, a glob, and 'all'. Use when: 'apply the rename plan', 'apply FN-...', 'do the docs…

melodic-software/claude-code-plugins · 114 tokens

feature-branch-pr-writing

Use this skill when the user asks to write, draft, create, or improve a PR description for a Shopware core repository PR — AND that PR targets a non-trunk feature branch (not trunk itself). Trigger phrases like "write a PR description", "draft the PR", "what should I put in the PR body". The skill detects the target…

shopwareLabs/ai-coding-tools · 152 tokens

pr-description-writing

Use this skill when the user asks to write, draft, create, or improve a PR description, is about to create a PR, or mentions "PR description", "pull request description", or "PR template" — AND that PR targets trunk in the Shopware core repository (shopware/shopware). The skill detects the target and only activates…

shopwareLabs/ai-coding-tools · 144 tokens