Requirements
rizsotto/Bear
Write, modify, or review a requirement file under docs/requirements -- pick the single owning file, keep the text contract-only, name IDs so they need no explanation, and verify cross-references and…
Gate test coverage with a ratchet — a committed baseline that coverage may never drop below and only ever rises.
Install Coverage Ratchet
$ npx skills add rshankras/claude-code-apple-skills --skill coverage-ratchet -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install rshankras/claude-code-apple-skills coverage-ratchet --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/rshankras/claude-code-apple-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/testing/coverage-ratchet .claude/skills/coverage-ratchet && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "coverage-ratchet" agent skill from https://github.com/rshankras/claude-code-apple-skills/tree/main/skills/testing/coverage-ratchet into .claude/skills/coverage-ratchet/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "coverage-ratchet", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/rshankras/claude-code-apple-skills/tree/main/skills/testing/coverage-ratchetType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add rshankras/claude-code-apple-skills --skill coverage-ratchet -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install rshankras/claude-code-apple-skills coverage-ratchet --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/rshankras/claude-code-apple-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/testing/coverage-ratchet .agents/skills/coverage-ratchet && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "coverage-ratchet" agent skill from https://github.com/rshankras/claude-code-apple-skills/tree/main/skills/testing/coverage-ratchet into .agents/skills/coverage-ratchet/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "coverage-ratchet", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add rshankras/claude-code-apple-skills --skill coverage-ratchet -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install rshankras/claude-code-apple-skills coverage-ratchet --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/rshankras/claude-code-apple-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/testing/coverage-ratchet .cursor/skills/coverage-ratchet && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "coverage-ratchet" agent skill from https://github.com/rshankras/claude-code-apple-skills/tree/main/skills/testing/coverage-ratchet into .cursor/skills/coverage-ratchet/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "coverage-ratchet", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/rshankras/claude-code-apple-skills.git --path skills/testing/coverage-ratchet--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add rshankras/claude-code-apple-skills --skill coverage-ratchet -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install rshankras/claude-code-apple-skills coverage-ratchet --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/rshankras/claude-code-apple-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/testing/coverage-ratchet .gemini/skills/coverage-ratchet && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "coverage-ratchet" agent skill from https://github.com/rshankras/claude-code-apple-skills/tree/main/skills/testing/coverage-ratchet into .gemini/skills/coverage-ratchet/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "coverage-ratchet", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install rshankras/claude-code-apple-skills coverage-ratchetInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add rshankras/claude-code-apple-skills --skill coverage-ratchet -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/rshankras/claude-code-apple-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/testing/coverage-ratchet .github/skills/coverage-ratchet && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "coverage-ratchet" agent skill from https://github.com/rshankras/claude-code-apple-skills/tree/main/skills/testing/coverage-ratchet into .github/skills/coverage-ratchet/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "coverage-ratchet", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add rshankras/claude-code-apple-skills --skill coverage-ratchet -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install rshankras/claude-code-apple-skills coverage-ratchet --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/rshankras/claude-code-apple-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/testing/coverage-ratchet .opencode/skills/coverage-ratchet && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "coverage-ratchet" agent skill from https://github.com/rshankras/claude-code-apple-skills/tree/main/skills/testing/coverage-ratchet into .opencode/skills/coverage-ratchet/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "coverage-ratchet", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
coverage-ratchet- GitHub stars
- 785
- Token cost
- ~1.1k tokens
- SKILL.md length
- 495 words
- Files
- 3
- Skills in repo
- 41
- Repo updated
- First seen
- Licence
- MIT
At a glance
Gate test coverage with a ratchet — a committed baseline that coverage may never drop below and only ever rises.
- Works in 3 steps: Copy templates/coverage-gate.sh into the… → Bootstrap the baseline → Commit both the script and…
- Agent-written code needs a deterministic tests were actually written check
- SKILL.md covers Why a Ratchet, Not a Target, When This Skill Activates, Setup and The Gate, plus 3 more sections
- Runs Shell scripts from its folder
What it does
Coverage Ratchet is an agent skill from rshankras/claude-code-apple-skills. Gate test coverage with a ratchet — a committed baseline that coverage may never drop below and only ever rises. Ships a coverage-gate script (xccov-based) plus an advisory CRAP report (complexity × uncovered). Use when agent-written code needs a deterministic "tests were actually written" check.
Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `templates/coverage-gate.sh` and `templates/crap-report.sh`).
It sits in Testing & QA, covering Test coverage. The repository describes itself as: Claude Code skills for Apple platform development (iOS, macOS, iPadOS) — product validation, code generation, App Store optimization, and more. The licence is MIT.
When your agent uses it
- Agent-written code needs a deterministic tests were actually written check
- Tasks that involve Test coverage
Example prompts
- “tests were actually written”
- “/coverage-ratchet”
Requirements
- A Bash shell
- Pre-approved tools (allowed-tools): Read, Write, Edit, Glob, Grep, Bash
Workflow steps
3 steps, taken from the first numbered list in SKILL.md.
- Copy templates/coverage-gate.sh into the project (e.g. Scripts/coverage-gate.sh), make it executable, and fill in the config block…
- Bootstrap the baseline
- Commit both the script and .coverage-baseline.
What it can do on your machine
Read from SKILL.md and the folder at commit 9ffb831. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
ReadWriteEditGlobGrepBash
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships script files (Shell), which the agent can run.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Coverage Ratchet loads about 1.1k tokens when it runs. Until then it costs about 79 tokens; SKILL.md has 495 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check: notes
The automated check noted patterns worth knowing about, such as sudo or a known installer.
- NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
allowed-tools: Read, Write, Edit, Glob, Grep, Bash
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from rshankras/claude-code-apple-skills at commit 9ffb831, republished under its MIT licence (© rshankras). 495 words, ~1,090 tokens.
Download SKILL.mdSave it as
.claude/skills/coverage-ratchet/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.- name
- coverage-ratchet
- description
- Gate test coverage with a ratchet — a committed baseline that coverage may never drop below and only ever rises. Ships a coverage-gate script (xccov-based) plus an advisory CRAP report (complexity × uncovered). Use when agent-written code needs a deterministic "tests were actually written" check.
- allowed-tools
- Read, Write, Edit, Glob, Grep, Bash
- last_verified
- 2026-07-24
- review_by
- 2027-07-01
Coverage Ratchet
A build/test gate proves the tests that exist pass. It says nothing about whether tests were written — a phase with no test task ships green on build success alone. The coverage ratchet closes that hole deterministically: line coverage is measured on every verify, compared against a committed baseline, and may never drop. It only rises.
Why a Ratchet, Not a Target
An absolute threshold ("80%") fails one of two ways on a real codebase: it fails day one (so it gets disabled), or it gets set below current reality (so it gates nothing). A ratchet starts from wherever the project actually is and only tightens. Nobody argues with "don't get worse."
When This Skill Activates
Use this skill when:
- A project has a test target but coverage has never been measured
- Agent-written features keep arriving with build-passing, test-free code
- Setting up the deterministic gauntlet (with
testing/fitness-functions/andswift/code-size/)
Setup
- Copy
templates/coverage-gate.shinto the project (e.g.Scripts/coverage-gate.sh), make it executable, and fill in the config block (scheme, destination, app target name). - Bootstrap the baseline:
Scripts/coverage-gate.sh --init # runs tests with coverage, writes .coverage-baseline- Commit both the script and
.coverage-baseline.
.coverage-baseline holds a single decimal fraction (e.g. 0.6231) — the app target's line coverage. Trailing whitespace ignored; nothing else in the file.
The Gate
Scripts/coverage-gate.sh # exit 0 = pass, exit 1 = coverage dropped- Runs the test suite with coverage enabled, extracts the app target's line coverage from the
xccovJSON report. - Fails if
current < baseline − 0.0025(the epsilon absorbs measurement jitter from unchanged code). - Suggests a ratchet-up when
current > baseline + 0.01: update.coverage-baselineto the new number in the same commit as the tests that earned it. That's the ratchet clicking forward. - Fails loudly on an unexpected report shape or a missing target — a broken measurement must never read as a pass.
Ratchet-up etiquette: raising the baseline is routine and encouraged; lowering it requires a written reason in the commit message (e.g. deleting a well-covered module) — treat it like widening a fitness-function allowlist.
Show full SKILL.md (178 more words)Show less
CRAP Report (Advisory)
templates/crap-report.sh combines per-function cyclomatic complexity (SwiftLint JSON output) with per-function coverage (the same xccov report) into the CRAP score — Change Risk Anti-Patterns:
CRAP(f) = complexity(f)² × (1 − coverage(f))³ + complexity(f)A complex and untested function scores explosively; simple-and-tested stays near its complexity. The report prints the top 20 — the exact functions where a test is worth the most. Advisory only, never a gate: the name-join between the two tools is heuristic.
Common Pitfalls
| Pitfall | Problem | Solution |
|---|---|---|
| Absolute threshold on existing code | Fails day one or gates nothing | Ratchet from measured reality |
| Gating total project coverage | Test-target/generated code pollutes the number | Gate the app target's own lineCoverage |
| Silent pass on tool failure | Broken measurement reads as green | Script fails loudly on unexpected JSON |
| Chasing the number with assertion-free tests | Coverage without verification | Pair with mutation spot-checks (testing/mutation-testing/) |
| Never ratcheting up | Baseline fossilizes at day-one level | Raise it in the same commit as new tests |
References
testing/mutation-testing/— do the covering tests actually assert anything (advisory)swift/code-size/— the complexity half; small functions are coverable functionstesting/fitness-functions/— architecture invariants as testsgenerators/ci-cd-setup/— CI wiring for the gate
© rshankras, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 2 other files in skills/testing/coverage-ratchet of rshankras/claude-code-apple-skills.
- SKILL.md
- templates/coverage-gate.sh
- templates/crap-report.sh
Open the folder on GitHubat commit 9ffb831
Compare with similar skills
Coverage Ratchet next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Coverage Ratchet this skillrshankras/claude-code-apple-skills | 785 | — | ~1.1k | Automated safety check: Notes | MIT | |
| Requirementsrizsotto/Bear | 6.5k | — | ~2k | Automated safety check: Pass | GPL-3.0 | |
| Crap Analysisardalis/RiverBooks | 135 | 2 repos | ~3.4k | Automated safety check: Pass | None | |
| Code Coverages3s-project/s3s | 311 | — | ~789 | Automated safety check: Pass | Apache-2.0 | |
| Project Statusbactopia/bactopia | 522 | — | ~787 | Automated safety check: Pass | MIT | |
| Check Coverageldayton/Dippy | 243 | — | ~403 | Automated safety check: Pass | MIT |
Similar skills
Crap Analysis
ardalis/RiverBooks
Analyze code coverage and CRAP (Change Risk Anti-Patterns) scores to identify high-risk code.
Code Coverage
s3s-project/s3s
Measure and grow the line coverage of the s3s crate. An agent skill from s3s-project/s3s.
Project Status
bactopia/bactopia
Show a live snapshot of the Bactopia project state — component counts, GroovyDoc coverage, nf-test coverage, and structural issues.
Check Coverage
ldayton/Dippy
Ensure comprehensive test coverage for a CLI handler. An agent skill from ldayton/Dippy.
Guarding Destructive Operations
kajisho5/ffmpeg-skill
Add and review preconditions on operations that delete, overwrite, rewrite history, or resolve a caller-supplied name to a filesystem path — refusing instead of warning, placing the guard ahead of…
More from rshankras/claude-code-apple-skills
All 41 skills in this repoAccessibility Generator
rshankras/claude-code-apple-skills
Generate accessibility infrastructure for VoiceOver, Dynamic Type, and accessibility features.
Animation Patterns
rshankras/claude-code-apple-skills
SwiftUI animation patterns including springs, transitions, PhaseAnimator, KeyframeAnimator, SF Symbol effects, scroll-driven effects, mesh gradients, text renderers, and shader effects.
App Description Writer
rshankras/claude-code-apple-skills
Generate compelling App Store descriptions that convert browsers into users.
App Icon Generator
rshankras/claude-code-apple-skills
Generates an app icon for macOS or iOS — a fast CoreGraphics placeholder and/or flat layered source art to finish in Icon Composer (the Liquid Glass / iOS 26+ standard).
App Namer
rshankras/claude-code-apple-skills
Turn an app idea into validated, App-Store-ready name candidates.
Bundles And Licensing
rshankras/claude-code-apple-skills
Revenue beyond the single-app price tag — own-app bundles, Family Sharing as a conversion lever, cross-developer bundles & suites, and institutional licensing via Group Purchases / Apple School &…
Related
Categories
Questions about Coverage Ratchet
What does Coverage Ratchet do?
Gate test coverage with a ratchet — a committed baseline that coverage may never drop below and only ever rises. Coverage Ratchet is an agent skill from rshankras/claude-code-apple-skills. Gate test coverage with a ratchet — a committed baseline that coverage may never drop below and only ever rises.
When should I use Coverage Ratchet?
Coverage Ratchet fits situations like: agent-written code needs a deterministic tests were actually written check; tasks that involve Test coverage.
How do I install Coverage Ratchet in Claude Code?
Run `npx skills add rshankras/claude-code-apple-skills --skill coverage-ratchet -a claude-code`. Or copy the skill folder (skills/testing/coverage-ratchet in rshankras/claude-code-apple-skills) into .claude/skills/coverage-ratchet in your project. Claude Code loads it when a task matches its description.
How do I install Coverage Ratchet in Codex?
Run `npx skills add rshankras/claude-code-apple-skills --skill coverage-ratchet -a codex`. Or copy the skill folder (skills/testing/coverage-ratchet in rshankras/claude-code-apple-skills) into .agents/skills/coverage-ratchet in your project. Codex loads it when a task matches its description.
Can I use Coverage Ratchet in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add rshankras/claude-code-apple-skills --skill coverage-ratchet -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/coverage-ratchet, .gemini/skills/coverage-ratchet, .github/skills/coverage-ratchet and .opencode/skills/coverage-ratchet in your project.
What does Coverage Ratchet need to run?
Going by SKILL.md and its folder, Coverage Ratchet needs a shell for the scripts in its folder. Our summary lists: A Bash shell. Its frontmatter pre-approves these tools: Read, Write, Edit, Glob, Grep, Bash.
Does Coverage Ratchet access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Coverage Ratchet safe to install?
Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.
What licence does Coverage Ratchet use?
Coverage Ratchet is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Coverage Ratchet use?
About 1.1k tokens (SKILL.md is roughly 4.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Coverage Ratchet?
Skills that share tags, products or a category with Coverage Ratchet: Requirements (rizsotto/Bear, 6.5k stars), Crap Analysis (ardalis/RiverBooks, 135 stars), Code Coverage (s3s-project/s3s, 311 stars) and Project Status (bactopia/bactopia, 522 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Coverage Ratchet?
rshankras (a GitHub user) maintains it in rshankras/claude-code-apple-skills, which has 785 GitHub stars. The repository holds 41 skills in this directory. The repository was last updated on July 24, 2026.
Source: rshankras/claude-code-apple-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.