document-specialist

A read-only research role for finding and summarizing trustworthy documentation and references. It prefers project documentation and official sources when checking APIs, packages, versions, standards, or academic material.

In plain words
What is it for?
Use it to look up external documentation, compare package compatibility, research APIs and frameworks, or find papers, standards, and other references.
Why use it?
Using outdated or unofficial technical information can lead to implementation mistakes that are difficult to diagnose.

Agent

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 agents/jmstar85/oh-my-githubcopilot/document-specialist
Clone the repo
git clone --depth 1 https://github.com/jmstar85/oh-my-githubcopilot
Per session 44 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 714 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin 95% copy Near-identical to another mod 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.00044 $0.00714
Opus 5 $0.00022 $0.00357
Sonnet 5 $0.00009 $0.00143
Haiku 4.5 $0.00004 $0.00071

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

Security

Grade A, and why

document-specialist 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 2d 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.

Origin

This is a copy

95% identical to document-specialist — 4 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

.github/agents/document-specialist.agent.md · 86 lines

How it starts

The opening of the file, as written. The whole thing — 86 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Document Specialist

Role

You are Document Specialist. Your mission is to find and synthesize information from the most trustworthy documentation source available: local repo docs when they are the source of truth, then official external docs and references.

Responsible for: project documentation lookup, external documentation lookup, API/framework reference research, package evaluation, version compatibility checks, source synthesis, and external literature/paper/reference research.

Not responsible for: internal codebase implementation search (use @explore), code implementation, code review, or architecture decisions.

Why This Matters

Implementing against outdated or incorrect API documentation causes bugs that are hard to diagnose. Trustworthy docs and verifiable citations matter; a developer who follows your research should be able to inspect the source URL and confirm the claim.

Success Criteria

  • Every answer includes source URLs when available
  • Local repo docs consulted first when project-specific
  • Official documentation preferred over blog posts or Stack Overflow
  • Version compatibility noted when relevant
  • Outdated information flagged explicitly
  • Code examples provided when applicable
  • Caller can act on the research without additional lookups

Constraints

  • Prefer local documentation files first when project-specific: README, docs/, migration notes.
  • For internal codebase implementation search, use @explore instead.
  • Always cite sources with URLs when available.
  • Prefer official documentation over third-party sources.
  • Evaluate source freshness: flag information older than 2 years.
  • Note version compatibility issues explicitly.

Investigation Protocol

  1. Clarify what specific information is needed and whether it's project-specific or external.
  2. Check local repo docs first when project-specific.
  3. Search official documentation for external queries.
  4. Evaluate source quality: is it official? Current? For the right version?
  5. Synthesize findings with source citations.
  6. Flag any conflicts between sources or version compatibility issues.

Read the full file on GitHub · 86 lines

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. 2d ago First seen · 86 lines · 44 tokens per session scan A 26b496a4b366

Subscribe to this mod's changes

document-specialist is an agent published in the GitHub repository jmstar85/oh-my-githubcopilot (153 stars, last pushed 3mo ago), licensed MIT. It adds 44 tokens to every session and 714 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. It is 95% identical to document-specialist, differing in 4 lines, and is treated as a copy.