Home / yha9806 / academic-writing-toolkit · .claude/skills/readers/SKILL.md · GitHub

readers skillA

readers is agent-read markdown (skill) from yha9806/academic-writing-toolkit: Open a reader panel. Instruction-bound amnesiac sub-agents read the abstract or introduction and report what they carried away, set against the author's intended points. Use when those sections change or the writing loop marks the panel stale..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# /readers — Reader Panel

## What it answers, and what it does not

It answers **what a first-time reader believes, remembers and could reuse** after reading a part of the manuscript,
set against the points the author wants carried (the intent card). It is how "does the contribution come across"
becomes something counted rather than asserted.

It does not answer whether the paper is good, whether a sentence changed its meaning (the author judges that), or
which single word is hard (word-level agreement with the author was too low to use). An eight-reader panel separates
only large differences; do not report a one-round rise or fall as a result. The script prints these limits in every
report.

## Before running

1. **Intent card.** The author's statement of who the reader is and the two to four points (M1, M2, ...) the reader
   should carry away. The writing loop names it in `target.intent_card`. If it lives outside the workspace's
   `human/` folder it is a draft, and the report says so. Do not write it for the author; draft it only when asked,
   and label it a draft. The template at `experimental/writing-loop/templates/intent-card.md` has further sections
…

Read the whole file at its exact version.

How to install

Latest version
mdr add yha9806/academic-writing-toolkit/readers@git:20260923.ac3272b
Exact content
mdr add yha9806/academic-writing-toolkit/readers@sha256:e433f3b65d4286b5

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_hvnsfi6v5no73szc.svg)](https://markdownregistry.com/a/art_hvnsfi6v5no73szc)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260923.ac3272b latest2026-09-23 ac3272b 5,311 BA view · diff
git:20260922.5e0bc842026-09-22 5e0bc84 5,073 BA view · diff
git:20260921.b9c5a502026-09-21 b9c5a50 4,680 BA view · diff
git:20260921.9c5bb002026-09-21 9c5bb00 4,527 BA view · diff
git:20260921.3061be32026-09-21 3061be3 4,204 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (5311 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

yha9806/academic-writing-toolkit · 41 stars · license MIT · pushed 2026-09-24 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_hvnsfi6v5no73szc
GET https://markdownregistry.com/api/v1/resolve?ref=yha9806/academic-writing-toolkit/readers
GET https://markdownregistry.com/api/v1/blob/e433f3b65d4286b59299503aea4c5b3a1680da5ce0b86a8d1fadae443482ddba

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from yha9806/academic-writing-toolkit

audit skill
yha9806/academic-writing-toolkit · .claude/skills/audit/SKILL.md · Check thesis chapters for consistency before submission — contradictory numbers, terminology drift, and broken…
git:20260922.5f42fee · audit A · 41 stars
export skill
yha9806/academic-writing-toolkit · .claude/skills/export/SKILL.md · Convert thesis chapters and reading notes from Markdown to Word (.docx) and package for submission. Use when preparing…
git:20260907.589edde · audit A · 41 stars
integrate skill
yha9806/academic-writing-toolkit · .claude/skills/integrate/SKILL.md · Map reading notes to thesis chapters and integrate key arguments into the manuscript. Use after completing a reading…
git:20260920.f7e7cc9 · audit A · 41 stars
map skill
yha9806/academic-writing-toolkit · .claude/skills/map/SKILL.md · Show literature-to-chapter coverage and the writing progress dashboard — which sources support which chapters, and word…
git:20260920.f7e7cc9 · audit A · 41 stars
note skill
yha9806/academic-writing-toolkit · .claude/skills/note/SKILL.md · Record reading notes to a structured notes file. Use when the user says "take notes" or "record this" during reading…
git:20260920.f7e7cc9 · audit A · 41 stars
read skill
yha9806/academic-writing-toolkit · .claude/skills/read/SKILL.md · Read PDF page by page with structured output — key arguments, terms glossary, thesis connections. Use when reading…
git:20260920.f7e7cc9 · audit A · 41 stars
review skill
yha9806/academic-writing-toolkit · .claude/skills/review/SKILL.md · Review a manuscript or chapter as an external reviewer, or run an own-work self-review in a fresh-context clean room…
git:20260920.ce7b9ba · audit A · 41 stars
verify-refs skill
yha9806/academic-writing-toolkit · .claude/skills/verify-refs/SKILL.md · Use when checking BibTeX reference records for missing fields, malformed identifiers, duplicate keys, or metadata…
git:20260922.265b5fd · audit A · 41 stars
academic-writing rules
yha9806/academic-writing-toolkit · .cursor/rules/academic-writing.mdc · Academic writing conventions — reading notes format, chapter structure, consistency rules
git:20260427.1b9c69b · audit A · 41 stars
AGENTS.md agents
yha9806/academic-writing-toolkit · AGENTS.md
git:20260907.589edde · audit A · 41 stars
CLAUDE.md claude
yha9806/academic-writing-toolkit · CLAUDE.md
git:20260427.bf32c54 · audit A · 41 stars
argument-governance skill
yha9806/academic-writing-toolkit · archive/skills/argument-governance/SKILL.md · Build and audit the manuscript or research-project argument system across intended use, gaps, claims, data, results…
git:20260905.68bae2c · audit A · 41 stars

Every file in yha9806/academic-writing-toolkit

Browse by kind, by grade A, or by owner.