size-ratchet

size-ratchet is a skill for Claude Code from vanillagreencom/kendex. It costs 29 tokens per session (1,369 once invoked), scanned C, original, MIT.

A file-size guard that checks whether tracked files stay within size limits for their path type. It keeps a record of existing oversized files so they cannot grow further.

In plain words
What is it for?
Use it to check files before a pull request or commit, create the first size record, or tighten that record after files shrink. It also supports configuration and debugging of the size limits.
Why use it?
It catches unwanted file growth before a change is merged and prevents old large files from getting larger. This helps keep code and documentation from slowly becoming harder to maintain.

Skill for Claude Code

Written for Claude Code: user-invocable in frontmatter. Also seen: installed under .agents/ (shared by several agents).

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/vanillagreencom/kendex/size-ratchet
Any agent
npx skills add vanillagreencom/kendex --skill size-ratchet
Clone the repo
git clone --depth 1 https://github.com/vanillagreencom/kendex

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 size-ratchet

README.md
[![agentmods](https://agentmods.dev/badge/skills/vanillagreencom/kendex/size-ratchet.svg)](https://agentmods.dev/skills/vanillagreencom/kendex/size-ratchet)
Your own site
<a href="https://agentmods.dev/skills/vanillagreencom/kendex/size-ratchet"><img src="https://agentmods.dev/badge/skills/vanillagreencom/kendex/size-ratchet.svg" alt="Measured on agentmods" height="20"></a>
Per session 29 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,369 The whole file, excluding the scripts and references it only reads on demand.
Security scan C 1 finding. 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.1 $0.00029 $0.01369
Opus 5 $0.00015 $0.00685
Sonnet 5 $0.00006 $0.00274
Haiku 4.5 $0.00003 $0.00137

Measured yesterday against content hash 44e5f05f3e36, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade C, and why

size-ratchet scanned grade C 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 yesterday.

The scan reads SKILL.md. This mod also ships 12 executable files (scripts/lib/settings.sh, tests/baseline-relocated.test.sh, tests/binary-content.test.sh, …), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

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.

Hidden instructionshighPrompt injection

Directives inside HTML comments, invisible characters or bidirectional overrides are read by the model and not by the person reviewing the file.

<!-- kendex:project-instructions:start -->
.agents/skills/size-ratchet/SKILL.md · 67 lines

How it starts

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

Project Instructions

Problems with a kendex-owned skill go through kendex report; check ownership in the file first.

Size Ratchet

No tracked file gets bigger than its threshold, and files already over it only shrink. Existing offenders are frozen in a baseline at their current sizes; everything else stays at or under its path class's threshold. Markdown is measured in bytes and code in lines. Baseline rows only go down or away while their unit stays the same. Reference and exception rules are README.md § Trusted HEAD baseline.

.agents/skills/size-ratchet/scripts/size-ratchet            # check (pre-PR / CI)
.agents/skills/size-ratchet/scripts/size-ratchet --staged   # check what a commit records (git hook)
.agents/skills/size-ratchet/scripts/size-ratchet --update   # tighten the baseline
.agents/skills/size-ratchet/scripts/size-ratchet --seed     # write the FIRST baseline

Flags, SIZE_RATCHET_* keys, and exit codes: size-ratchet --help. Verdict classes, semantics, units, the shipped class list, baseline/excludes formats, and seeding: README.md. Collection and maintenance notes: DEVELOPMENT.md.

Responding to a failure

Every size diagnostic names the file, its size, the baseline row it violated, the deciding threshold (class pattern or default), and the remedy: split at a concept seam.

Reference, repoint, raise, and unit-change behavior is one rule: README.md § Trusted HEAD baseline. A shrunk row under --staged is already lowered and staged by the run itself.

A NUL is refused, not measured. Any tracked blob carrying a NUL in its leading 8000 bytes is what git calls binary, whatever unit its class counts in and whether or not the size exclusion list covers it. The gate exits 2 naming the path and the byte's offset, in every mode, --seed and --update included. Write the escape the language spells the byte with; a real binary asset is declared binary or -diff in .gitattributes, the only exemption.

Read the full file on GitHub · 67 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. yesterday Changed · -50 lines 44e5f05f3e36
  2. 2d ago Changed · +11 lines scan A → C b4ce9ef2005f
  3. 3d ago Changed · -8 lines a8b20163fa0b
  4. 6d ago First seen · 114 lines · 29 tokens per session scan A 9a11239b017d

Subscribe to this mod's changes

size-ratchet is a skill published in the GitHub repository vanillagreencom/kendex (74 stars, last pushed today), licensed MIT. It adds 29 tokens to every session and 1,369 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it C with 1 finding (hidden instructions). 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

surf

Control Chrome browser via CLI for testing, automation, and debugging. Use when the user needs browser automation, screenshots, form filling, page inspection, network/CPU emulation, DevTools streaming, or AI queries via ChatGPT/Gemini/Perplexity/Grok/AI Studio.

w-winter/dot314 · 60 tokens

prose-review

Review prose written for others (e.g., user-facing documentation, prompts for other LLMs, reports, plans, inline comments, docstrings) for local jargon leakage, orphaned references, missing grounding, and audience or genre mismatch. Always run on prose you produce or materially edit, except for routine conversational…

w-winter/dot314 · 84 tokens

text-search

Search indexed text corpora with qmd. For indexed content, prefer qmd over grep.

w-winter/dot314 · 22 tokens

xcodebuildmcp

Build/test Xcode projects via the XcodeBuildMCP MCP server using a local CLI wrapper for pi (no MCP support). Use when the user mentions Xcode, xcodebuild, iOS builds/tests, or XcodeBuildMCP.

w-winter/dot314 · 56 tokens

agent-browser

Automates browser interactions for web testing, form filling, screenshots, and data extraction. Use when the user needs to navigate websites, interact with web pages, fill forms, take screenshots, test web applications, or extract information from web pages.

w-winter/dot314 · 51 tokens

deep-x-research

Deep, exhaustive research on a topic across X (Twitter) by driving Grok (x.com/i/grok) through surf. Use when the user wants comprehensive X research on a concept, technique, trend, tool, or creator scene; needs categorized findings with every claim traceable to post URLs; or when a single Grok query is not enough.

w-winter/dot314 · 76 tokens