cold-read
Skill2 starsChanged 25 days agoApache-2.0View on GitHub
Load for /vellum:cold-read, after every major editorial program, and before export. The cold-read skill owns the cover-to-cover cold-read protocol: the reader charter, the rolling ledger, the append-only issue log, and the batching/orchestration model. It finds the accumulating-memory defect classes (clock drift, cross-chapter state contradictions, prop custody, promise bookkeeping, knowledge-state slips) that no scanner, chapter reviewer, or continuity query can see.
6 other projects use a version of this.
Adopted by
Most recently taken up by
- Thakay/agent-skillstheir own version, first seen Nov 1, 2026
- Ovich/charrettetheir own version, first seen Nov 1, 2026
- me2resh/cold-readtheir own version, first seen Oct 25, 2026
- Ovich/swarmstormtheir own version, first seen Oct 25, 2026
- scottlivingston/claude-skillstheir own version, first seen Oct 25, 2026
- kevmoo/kevmoo_skillstheir own version, first seen Oct 13, 2026
Used with
Projects with it also use pr-review.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
MicrosoftSkillpr-review
Verify the technical accuracy of a vscode-docs pull request against the VS Code source code in microsoft/vscode. Use when reviewing a docs PR for factual correctness: setting names, command IDs, default values, API shapes, keybindings, versioned availability, and described behavior.
Also in 3 projects that use this
Other versions6 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 6
- kevmoo/kevmoo_skills★ 23same name
- Ovich/charrette★ 14same name
- Ovich/swarmstorm★ 14same name
- scottlivingston/claude-skills★ 1same name
- me2resh/cold-read★ 0same name
- Thakay/agent-skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository33 other files it gives its agents.
- character-simSkill
- creative-researchSkill
- creative-writing-craftSkill
- creative-writing-modesSkill
- creative-writing-museSkill
- demolitionSkill
- exportSkill
- gatesSkill
- grill-with-docsSkill
- information-hierarchySkill
- intent-modelingSkill
- kb-integritySkill
- kb-managementSkill
- knowledge-layersSkill
- llm-writingSkill
- md-validationSkill
- project-setupSkill
- qi-layerSkill
- reader-simSkill
- reflectSkill
- series-bibleSkill
- seriesSkill
- shared-daoSkill
- story-ledgersSkill
- story-memorySkill
- story-planningSkill
- story-reviewSkill
- structured-artifactSkill
- style-guardrailsSkill
- voiceSkill
- writing-principlesSkill
- writing-staffingSkill
- zoom-outSkill
The file
Files
Cold Read
The cold-read skill owns the cover-to-cover cold-read protocol — a single reader, reading the whole manuscript in order, carrying a rolling ledger, and logging every defect that survives the per-chapter QA. It exists because a class of defect is invisible to every memoryless pass: a linter sees a line, a chapter reviewer sees a chapter, a continuity query sees a query — none of them accumulate reader-state. Clock drift, cross-chapter state contradictions, prop custody, promise bookkeeping at book scale, knowledge-state slips, and audit coverage bias are all accumulating-memory defects. The cold read is the only pass that catches them.
What this skill is
- A protocol, not a single prompt. It runs on four files (charter, ledger, issues, batch reports) that together make a multi-sitting read behave like one continuous reader.
- Assessment-only by default (rule zero): the read measures; it does not edit the thing it measures. AUTO-FIX is opt-in, narrowly scoped, logged.
- Batched for sustainability and context-window safety: 8–11 chapters per sitting, the ledger the only inter-sitting state.
- A self-contained reference: it restates the severity taxonomy, the issue format, the batching model, and the orchestration pattern so the agent and the muse can run it without loading other skills. Cross-references to
gates/,kb-integrity/, andstory-ledgers/are pointers only.
The document set
| File | Role |
work/cold-reads/<YYYY-MM>/charter.md | Who the reader is, the rules, the batch plan, the severity taxonomy, autonomy tiers. Written once. |
work/cold-reads/<YYYY-MM>/reader_ledger.md | The reader's accumulated memory: NEXT marker, position/clock, promise register, knowledge map, prop custody, do-not-re-explain, PROTECT, tripwires, grades. Updated every batch. |
work/cold-reads/<YYYY-MM>/issues.md | Append-only issue log, one line per issue, fixed format. |
work/cold-reads/<YYYY-MM>/batches/batch_X.md | Per-batch report: what works, grades, seam assessment, "would a paying reader keep going?" |
Load the resource needed
resources/charter.md— the reader persona ("devoted genre reader who just finished the previous book, with a line-editor's ear; experience first, diagnosis second"), rule zero, the batch plan, the severity taxonomy, AUTO-FIX vs PROPOSE tiers, voice cards, tripwires, PROTECT, deliverables.resources/reader-ledger.md— the rolling ledger: NEXT marker with WATCH list, position/clock table, promise register (HOT/WARM/COLD), character knowledge map, prop custody, do-not-re-explain register, PROTECT, tripwires, open threads, grades table. "A stale ledger is an amnesiac reader."resources/issue-format.md— the fixed line formatCR-### | ch:line | SEV | CAT | "quote" | reader-moment | fix direction | SCOPE, the severity/category vocab, the severity→shared-schema mapping, and the rules (reader-moment mandatory, append-only, continuous numbering).resources/batching.md— 8–11 chapter batches cut at natural milestones, the per-sitting resume recipe (charter + ledger + last ~40 issues → continue from NEXT), the per-batch procedure, the batch report contents, the orchestration model, and when to run.
Who runs it
- Muse sets up
work/cold-reads/<YYYY-MM>/fromtemplates/cold-read/(via/vellum:cold-read), seeds the ledger, and spawns@cold-readerper batch. @cold-readerexecutes one batch: reads charter + ledger + last ~40 issues, continues from NEXT, reads only the batch's chapters, returns (a) append-ready issue lines, (b) ledger section updates, (c) the batch report. Assessment-only; no peeking at outline or editorial notes during a batch.- For 15+ chapters muse MAY use the digest pattern from
fiction/agents/review-coordinator.md(MIT) — spawn per-batch readers, aggregate from summaries, cache per-batch reports on disk.
How it fits the gates
Cold-read findings are advisory by default; BLOCKER-class findings block export until resolved or dismissed-with-author-signoff (the same discipline as story-ledgers/ exemptions). MAJOR/MODERATE need a triage note. The export readiness checklist (gates/resources/readiness.md) cross-checks the cold-read issues.md for open BLOCKERs.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

