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.
npx agentmods add instructions/zimoliao/scholaraio/agents-mdgit clone --depth 1 https://github.com/ZimoLiao/scholaraioWhat 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 | $0.02046 | $0.02046 |
| Opus 5 | $0.01023 | $0.01023 |
| Sonnet 5 | $0.00409 | $0.00409 |
| Haiku 4.5 | $0.00205 | $0.00205 |
Grade A, and why
scholaraio 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 yesterday.
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.
How it starts
The opening of the file, as written. The whole thing — 141 lines — stays where its author put it; the contents beside it link to each section on GitHub.
ScholarAIO - Agent Entry
This is the repository entry document for coding agents. It is intentionally short:
- keep durable project facts and hard constraints here
- move multi-step procedures into skills
- move deep reference material into the indexed
docs/knowledge base
What ScholarAIO Is
ScholarAIO is an All-in-One academic harness for agents. Researchers work through a coding agent to search literature, inspect evidence, organize persistent project context, produce reviewable research outputs, and use bounded scientific-tool adapters without ScholarAIO replacing the agent's native reasoning or orchestration.
The Python package is scholaraio. Real work should usually happen through the ScholarAIO CLI and project skills, not by bypassing runtime helpers with ad hoc file edits.
How To Work In This Repo
- Prefer a matching project skill in
.claude/skills/when the user request clearly maps to one. - Use the
scholaraioCLI to do real work instead of only describing what should be done. - Load information progressively. Prefer metadata or abstracts first, then conclusions or full text only when needed.
- Treat paper conclusions as claims, not facts. Compare evidence, point out limitations, and distinguish supported results from author interpretation.
- Keep user-facing drafts, reports, exports, and research outputs under
workspace/, not the repository root orscholaraio/. - Do not casually rewrite or delete runtime data. When touching runtime layout, use
Config, migration helpers, and tested accessors. - When changing runtime layout, compatibility behavior, agent entry docs, or skill discovery, update tests and aligned docs in the same change.
- After code or doc changes, run the relevant checks and at least one real smoke path when feasible.
Start Here
Read these in roughly this order:
README.mdfor the product overview and top-level structure.STRATEGY.mdbefore changing product scope or adding an external integration.docs/DESIGN.mdfor the repository knowledge map.docs/getting-started/agent-setup.mdfor repo-open vs plugin or cross-project setup.docs/guide/cli-reference.mdfor the current user-facing CLI surface.docs/guide/agent-reference.mdfor deeper agent, runtime, and skill organization details.docs/internal/PLANS.mdanddocs/internal/exec-plans/completed/scholaraio-upgrade-plan.mdbefore changing runtime layout, migration, or compatibility behavior.
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.
- yesterday First seen · 141 lines · 2,046 tokens per session scan A 9eb5501516f7
scholaraio AGENTS.md is an instructions file published in the GitHub repository ZimoLiao/scholaraio (566 stars, last pushed yesterday), licensed MIT. It adds 2,046 tokens to every session, about $0.0102 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.
Other instructions, from other repositories
PyAutoArray CLAUDE.md
Instructions for PyAutoLabs/PyAutoArray: The canonical, agent-agnostic instructions live in AGENTS.md. Claude Code loads them via the import below; if your tool does not process @-imports, open AGENTS.md in this directory and read it directly. @AGENTS.md.
math-anchor CLAUDE.md
Claude Code instructions for tetracoralla/math-anchor, a project described as: Math Anchor — safe exact and scientific math, units, and dimensional analysis for humans and Agents (macOS + MCP/Codex plugin).
OpenSDL CLAUDE.md
Instructions for fl-sean03/OpenSDL, a project described as: A modular Python foundation for reproducible computational and autonomous laboratories. Alpha; the reference profile is simulator-only.
wisp-science AGENTS.md
AGENTS.md instructions for xuzhougeng/wisp-science, covering agents.md, project orientation, repository layout, engineering rules and verification commands.
MoleCode AGENTS.md
Instructions for AtomFlow-AI/MoleCode, covering agents.md — molecode, what this repo is, use the molecode skill, molecode-first rule and cli quick start.
ami-mcp CLAUDE.md
Claude Code instructions for kratsg/ami-mcp, covering ami-mcp — contributor guide, architecture, project layout, tool registration pattern and tools/mymodule.py.