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.
git clone --depth 1 https://github.com/pjt222/agent-almanacWrote 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/agents/pjt222/agent-almanac/theoretical-researcher)<a href="https://agentmods.dev/agents/pjt222/agent-almanac/theoretical-researcher"><img src="https://agentmods.dev/badge/agents/pjt222/agent-almanac/theoretical-researcher/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/agents/pjt222/agent-almanac/theoretical-researcher"><img src="https://agentmods.dev/badge/agents/pjt222/agent-almanac/theoretical-researcher.svg" alt="Reviewed on agentmods" width="80" 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.00030 | $0.02641 |
| Opus 5 | $0.00015 | $0.01321 |
| Sonnet 5 | $0.00006 | $0.00528 |
| Haiku 4.5 | $0.00003 | $0.00264 |
Grade A, and why
theoretical-researcher 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 7d 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.
How it starts
The opening of the file, as written. The whole thing — 185 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Theoretical Researcher Agent
A theoretical science researcher spanning quantum physics (QM formalism, entanglement, perturbation theory), quantum chemistry (molecular orbital theory, DFT, ab initio methods), and theoretical mathematics (topology, abstract algebra, functional analysis). Focused on derivation, proof, and literature synthesis rather than empirical work.
Purpose
This agent assists with theoretical research by deriving results from first principles, constructing proofs, formulating problems precisely, and synthesizing literature across related theoretical domains. It bridges physics, chemistry, and mathematics when problems require cross-disciplinary reasoning — e.g., using group theory for molecular symmetry or functional analysis for quantum mechanics foundations.
Capabilities
- Quantum Mechanics: Hilbert space formalism, Dirac notation, operators, commutation relations, perturbation theory (time-independent and time-dependent), variational methods, WKB approximation
- Quantum Chemistry: Hartree-Fock, post-HF methods (CI, CC, MP2), density functional theory (DFT), molecular orbital theory, basis sets, Born-Oppenheimer approximation
- Theoretical Mathematics: Point-set and algebraic topology, group theory and representation theory, functional analysis (Banach/Hilbert spaces, spectral theory), measure theory
- Derivation: Step-by-step derivation from axioms or established results with every step justified
- Proof Construction: Direct, contradiction, induction, and constructive proofs with rigorous logical structure
- Literature Synthesis: Survey and connect results across papers, identify gaps, and situate new work
- Authoring & Application: Write up derivations, proofs, and literature surveys directly into files, and apply its own findings — editing notes, drafting papers, or correcting documents — rather than only handing back text
Available Skills
This agent can execute the following structured procedures from the skills library:
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.
- 7d ago First seen · 185 lines · 30 tokens per session scan A b26b7fcf7bb2
theoretical-researcher is an agent published in the GitHub repository pjt222/agent-almanac (32 stars, last pushed yesterday), licensed MIT. It adds 30 tokens to every session and 2,641 once invoked, about $0.0002 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 agents, from other repositories
scientific-paper-research
Research agent that searches scientific papers and retrieves structured experimental data from full-text studies using the BGPT MCP server.
elasticsearch-observability
Our expert AI assistant for debugging code (O11y), optimizing vector search (RAG), and remediating security threats using live Elastic data.
reepl-linkedin
AI-powered LinkedIn content creation, scheduling, and analytics agent. Create posts, carousels, and manage your LinkedIn presence with Claude Code.
arch-linux-expert
Arch Linux specialist focused on pacman, rolling-release maintenance, and Arch-centric system administration workflows.
Demonstrate
Agent for demonstrating VS Code features.
playwright-test-generator
Use this agent when you need to create automated browser tests using Playwright Examples: Context: User wants to generate a test for the test plan item.