CiteCheck AGENTS.md

CiteCheck AGENTS.md is an instructions file for Codex, OpenCode from color4-alt/CiteCheck. It costs 499 tokens per session, scanned A, original, MIT.

Development and testing rules for CiteCheck, a tool that checks citations and references in LaTeX files and PDFs. They define required checks and expected results for the project's sample paper.

In plain words
What is it for?
Use them when changing CiteCheck's source or PDF parsing, citation detection, reference-format checks, or semantic verification, then run the prescribed demo tests.
Why use it?
They make sure changes are tested against a known set of citation and formatting problems before being committed. The expected counts help reveal regressions in parsing or checking.

Instructions file for CodexOpenCode

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 instructions/color4-alt/citecheck/agents-md
Clone the repo
git clone --depth 1 https://github.com/color4-alt/CiteCheck

Made for: Codex, OpenCode.

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 CiteCheck AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/color4-alt/citecheck/agents-md.svg)](https://agentmods.dev/instructions/color4-alt/citecheck/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/color4-alt/citecheck/agents-md"><img src="https://agentmods.dev/badge/instructions/color4-alt/citecheck/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 499 This file is loaded in full into every session.
When invoked 499 The same file — it is already loaded in full.
Security scan A 0 findings. 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 $0.00499 $0.00499
Opus 5 $0.00249 $0.00249
Sonnet 5 $0.00100 $0.00100
Haiku 4.5 $0.00050 $0.00050

Measured 5d ago against content hash d2fed4be7b99, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

CiteCheck AGENTS.md 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 5d 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.

AGENTS.md · 52 lines

What it actually says

@./skills/citecheck/SKILL.md @./references/api-reference.md @./references/format-check-rules.md @./references/thematic-scoring-prompt.md @./references/semantic-matching-prompt.md

CiteCheck — Development & Testing Rules

Pre-Push Testing Requirement

Every feature change MUST be validated against the demo test fixtures before committing.

The latex_paper/ directory (sibling to CiteCheck/) contains intentionally flawed references used as the canonical integration test:

# From inside CiteCheck/
cd CiteCheck

# 1. Test LaTeX source parsing
citecheck ../latex_paper/main.tex --skip-verification --skip-semantic -o /tmp/test_latex.md

# Expected baseline:
#   - 19 references parsed
#   - 18 citation markers detected
#   - 7 format issues (preprints, wrong entry type, missing author, future year)
#   - Uncited list: only [3] touvron2023llama

# 2. Test PDF fallback parsing
citecheck ../latex_paper/main.pdf --skip-verification --skip-semantic -o /tmp/test_pdf.md

# Expected baseline:
#   - 18 references parsed (PDF loses incomplete entry metadata)
#   - 18 citation markers detected
#   - 0 format issues (PDF parser has limited format checking)

Regression Checklist

  • LaTeX test produces expected reference count (±0)
  • LaTeX test produces expected citation marker count (±0)
  • Uncited references list shows ONLY truly uncited entries (e.g., touvron2023llama)
  • PDF test runs without crashing
  • pytest tests/test_parser.py passes (8/8)
  • python -m citecheck --help works

Known Improvements (Post-0.1.0)

  • arXiv year parsing (pdf_parser.py): arXiv IDs like arXiv:2004.05150 are no longer mistaken for publication years.
  • Crossref false-match filtering (verifier.py): Low-similarity matches are now rejected; large year mismatches (>2 years) are flagged separately from small mismatches.

If any baseline metric shifts unexpectedly, investigate before pushing.

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. 5d ago First seen · 52 lines · 499 tokens per session scan A d2fed4be7b99

Subscribe to this mod's changes

CiteCheck AGENTS.md is an instructions file published in the GitHub repository color4-alt/CiteCheck (59 stars, last pushed 3mo ago), licensed MIT. It adds 499 tokens to every session, about $0.0025 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-08-30.

Related

Other instructions, from other repositories

med-paper-assistant AGENTS.md

AGENTS.md instructions for u9401066/med-paper-assistant, covering agents.md - vs code copilot agent 指引, 核心價值:逐步多輪演進, 運行模式, 檔案保護(normal/research) and 專案規則.

u9401066/med-paper-assistant · 5,565 tokens

scientific-writing CLAUDE.md

Instructions for koljaschoepe/scientific-writing, covering scientific writing framework, schnellstart, workflow, befehle and regeln für generierte texte.

koljaschoepe/scientific-writing · 1,163 tokens

sourceright AGENTS.md

AGENTS.md instructions for edithatogo/sourceright, covering sourceright codex instructions, codev - ai agent instructions, project overview, available protocols and file resolution (how codev finds protocols and templates).

edithatogo/sourceright · 2,484 tokens

scitex-python CLAUDE.md

Claude Code instructions for scitex-ai/scitex-python, covering workflow orchestration, 1. plan mode default, 2. subagent strategy, 3. self-improvement loop and 4. verification before done.

scitex-ai/scitex-python · 601 tokens

avoid-overkill AGENTS.md

AGENTS.md instructions for 6Kmfi6HP/avoid-overkill: This repository packages a reusable Agent Skill and plugin manifests.

6Kmfi6HP/avoid-overkill · 125 tokens

academic-writer-skills AGENTS.md

AGENTS.md instructions for muhammad1438/academic-writer-skills, covering academic writer skills — multi-agent workflow guide, skill dependency map, pipeline patterns, pattern 1: full research paper and pattern 2: grant application pipeline.

muhammad1438/academic-writer-skills · 2,504 tokens