explainer

explainer is an agent for Claude Code from rjmurillo/ai-agents. It costs 59 tokens per session (1,725 once invoked), scanned A, original, MIT.

A documentation specialist for writing product requirements, explanations, and technical specifications that junior developers can understand.

In plain words
What is it for?
Creating PRDs, explainers, technical specifications, templates, and clearer issue or feature documentation.
Why use it?
It helps turn unclear or jargon-heavy ideas into requirements with explicit user stories and acceptance criteria.

Agent for Claude Code

Written for Claude Code: argument-hint in frontmatter. Also seen: reads .claude/ paths.

Part of the project-toolkit plugin — 125 skills, 25 commands, 33 agents, 5 hooks shipped together

Good fit Creating PRDs, explainers, technical specifications, templates, and clearer issue or feature documentation.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/rjmurillo/ai-agents/explainer
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.

Clone the repo
git clone --depth 1 https://github.com/rjmurillo/ai-agents

Made for: Claude Code.

Or install project-toolkit, the plugin that ships this one along with the rest of its 125 skills, 25 commands, 33 agents, 5 hooks.

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 explainer

README.md
[![agentmods](https://agentmods.dev/badge/agents/rjmurillo/ai-agents/explainer/github.svg)](https://agentmods.dev/agents/rjmurillo/ai-agents/explainer)
Your own site
<a href="https://agentmods.dev/agents/rjmurillo/ai-agents/explainer"><img src="https://agentmods.dev/badge/agents/rjmurillo/ai-agents/explainer/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.

agentmods 80×15 button for explainer

Your own site · 80×15
<a href="https://agentmods.dev/agents/rjmurillo/ai-agents/explainer"><img src="https://agentmods.dev/badge/agents/rjmurillo/ai-agents/explainer.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 59 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,725 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
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.1 $0.00059 $0.01725
Opus 5.5 $0.00024 $0.00690
Sonnet 5.5 $0.00012 $0.00345
Haiku 4.5 $0.00006 $0.00172

Measured 4d ago against content hash 7f96ab37f1b1, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

explainer 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 4d 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.

.claude/agents/explainer.md · 151 lines

How it starts

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

Explainer Agent

You write documentation so a junior developer understands it without asking questions. Produce output when the context is clear enough. Ask questions only when essential information is missing.

Prose Self-Check

Before emitting any prose artifact (PRD, explainer, spec narrative, PR or issue body), run the prose-self-check skill (.claude/skills/prose-self-check/SKILL.md). It runs a four-layer AI-vernacular audit: weight structural and semantic findings above lexical, and do not flag low-signal words on presence alone.

When to Produce Directly vs Ask First

Situation Behavior
Standard feature with known patterns (2FA, forgot password, rate limiting) Produce directly using best-practice defaults. Note assumptions.
Documentation of existing behavior Produce directly. The behavior is knowable from code or prompt context.
Concept explanation (auth vs authz, REST vs RPC) Produce directly with concrete analogies.
Ambiguous vague request (make the dashboard faster) Push back first. Define measurable targets before writing.
Novel feature with multiple stakeholders Ask clarifying questions first.
User explicitly asks "what should I consider" Ask and enumerate options.

Default to producing output. Asking questions when direct output is possible is over-engineering. Flag assumptions inline rather than gating on clarifications.

When You Do Ask Questions

Before you ask, resolve what you can with cheap read-only checks (search the code, read it, check memory and existing docs). Ask only about what stays unresolved after looking. There is no fixed time budget; bound it by "read-only and cheap." When you ask, name the specific candidates you found: "I found flows X and Y. Which one?" beats "What flow?"

Use this enumerated list. Adapt to context:

  1. Problem: What user problem does this solve?
  2. User: Who is the primary user?
  3. Functionality: What actions should they perform?
  4. User stories: In "As a [user], I want [action] so that [benefit]" format
  5. Acceptance criteria: How do we know it works?
  6. Non-goals: What should it NOT do?

Read the full file on GitHub · 151 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. 4d ago Changed · +1 lines 7f96ab37f1b1
  2. 9d ago Changed 8fd9d27b2ea6
  3. 17d ago Changed 643574147fc1
  4. 20d ago Changed · +12 lines 9ada445c697e
  5. 24d ago Changed ed64a9fed639
  6. 1mo ago Changed · -1 lines 388cbd0c40be
  7. 1mo ago First seen · 139 lines · 59 tokens per session scan A ce937234dc56

Subscribe to this mod's changes

explainer is an agent published in the GitHub repository rjmurillo/ai-agents (48 stars, last pushed today), licensed MIT. It adds 59 tokens to every session and 1,725 once invoked, about $0.0002 per session on Opus 5.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 agents, from other repositories

devops-architect

DevOps and CI gate expert for the ClosedLoop plugin monorepo. Reviews build toolchain correctness (ruff, pyright, uv), plugin versioning discipline (semver per plugin.json), hook lifecycle contracts, pre-push CHANGELOG enforcement, marketplace registration, and cross-plugin coordinated version bumps. Triggers on…

closedloop-ai/claude-plugins · 95 tokens

nw-platform-architect-reviewer

Use for review and critique tasks - Platform design, CI/CD pipeline, infrastructure, observability, deployment readiness, and production handoff review specialist. Runs on Haiku for cost efficiency.

nWave-ai/nWave · 44 tokens

10-Challenger

Standalone adversarial review wrapper. Runs challenger-review-subagent, then runs the shared Per-Finding Decision Protocol so the user can Apply selected fixes and hand off to the next step. For orchestrated workflows, the subagent is auto-invoked by parent agents.

jonathan-vella/apex-accelerator · 60 tokens

reviewer

Review changes against spec, plan, code quality heuristics, and repo rules. Supports local (ADOS pipeline) and remote (PR/MR) modes.

juliusz-cwiakalski/agentic-delivery-os · 34 tokens

review-feedback-applier

Classify and apply accepted review feedback from PR/MR.

juliusz-cwiakalski/agentic-delivery-os · 17 tokens

github-actions-expert

GitHub Actions specialist focused on secure CI/CD workflows, action pinning, OIDC authentication, permissions least privilege, and supply-chain security.

fabioc-aloha/Alex_Skill_Mall · 33 tokens