Getting it into your agent
It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.
git clone --depth 1 https://github.com/Lzy599775/agent-auto-sci-skillsnpx agentmods add commands/lzy599775/agent-auto-sci-skills/ars-mark-readWrote 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.
[](https://agentmods.dev/commands/lzy599775/agent-auto-sci-skills/ars-mark-read)<a href="https://agentmods.dev/commands/lzy599775/agent-auto-sci-skills/ars-mark-read"><img src="https://agentmods.dev/badge/commands/lzy599775/agent-auto-sci-skills/ars-mark-read.svg" alt="Measured on agentmods" height="20"></a>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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00016 | $0.00483 |
| Opus 5 | $0.00008 | $0.00242 |
| Sonnet 5 | $0.00003 | $0.00097 |
| Haiku 4.5 | $0.00002 | $0.00048 |
Grade A, and why
ars-mark-read 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 3d 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.
What it actually says
Acknowledge that the user has personally read the source(s) backing the named citation key(s), so the next finalizer pass can promote <!--ref:slug LOW-WARN--> to <!--ref:slug ok--> for each acknowledged slug. Per v3.6.8 spec §3.6, the signal is stored in a session-scoped peer file <passport-stem>_human_read_log.yaml next to the active Material Passport; literature_corpus[] is adapter-owned and is NEVER mutated to carry human_read_source.
The dispatching agent substitutes <path> below with the active Material Passport path from session context before executing (the quoting is preserved so paths containing spaces remain a single argument). The CLI handles validation (citation_key must exist in literature_corpus[]; on miss emit [ARS-MARK-READ ERROR: citation_key '<slug>' not in literature_corpus[]] and refuse to write), 4 fail-fast environment checks (no active passport / passport not found / parent unreadable / read-log unwritable), and append-only write per §3.6 firm rule 3.
Optional read-scope attestation (#513, declaration-only — pass through whatever the user states, never infer): --scope {full_text,sections,abstract_only,toc_only,unknown} records how much of the source was read; --locator "<text>" (repeatable, requires --scope sections) names the read sections/pages; --note "<text>" free text (requires --scope). Without --scope, no read_scope is recorded and downstream treats the mark as unknown (pre-#513 behavior). A partial-coverage attestation means the finalizer promotes LOW-WARN → ok only for anchors falling within declared coverage — see the Read-scope-aware promotion paragraph in pipeline_orchestrator_agent.md.
Implementation:
python3 scripts/ars_mark_read.py $ARGUMENTS --passport-path "<path>"
Mode reference: docs/design/2026-04-30-ars-v3.6.8-trust-provenance-and-drift-transparency-spec.md §3.6 + Step 7.
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.
- 3d ago First seen · 18 lines · 16 tokens per session scan A 94f595fec191
ars-mark-read is a command published in the GitHub repository Lzy599775/agent-auto-sci-skills (2 stars, last pushed 12d ago), licensed MIT. It adds 16 tokens to every session and 483 once invoked, about $0.0001 per session on Opus 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.
Other commands, from other repositories
ars-plan
ARS academic-paper plan mode — Socratic chapter-by-chapter planning.
memory-forget
Command "memory-forget" from waittim/MemoryCustodian, covering memory-forget and review the preview, then apply its plan id.
setup-code-intelligence
Check code-intelligence prerequisites (ripgrep + a language server) and print install hints.
ars-cache-invalidate
ARS /ars-cache-invalidate — drop cached verification entries for a citation key.
ars-abstract
ARS academic-paper abstract-only mode — bilingual abstract + keywords.
ab-test-design
You are a senior Data Science & AI/ML specialist. The user needs help with ab test design in the context of data pipelines, model training, evaluation, mlops and analytical reporting.