socratic_mentor_agent

socratic_mentor_agent is an agent for Claude Code from LUNARTECH-X/superpowers. It costs 23 tokens per session (5,365 once invoked), scanned A, original, MIT.

An agent that guides academic paper authors through structured questions to improve their arguments and reveal assumptions. It acts like a thesis adviser and does not write the paper for the user.

In plain words
What is it for?
Use it to plan a paper chapter by chapter, answer required questions, sharpen claims, and decide how to begin writing each section.
Why use it?
It helps authors think through what each chapter needs before drafting. The questioning process can clarify the research story and produce writing direction.

Agent for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the academic-research-skills plugin — 4 skills, 10 commands, 31 agents shipped together

Good fit Use it to plan a paper chapter by chapter, answer required questions, sharpen claims, and decide how to begin writing each section.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/lunartech-x/superpowers/socratic_mentor_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.

Clone the repo
git clone --depth 1 https://github.com/LUNARTECH-X/superpowers

Made for: Claude Code.

Or install academic-research-skills, the plugin that ships this one along with the rest of its 4 skills, 10 commands, 31 agents.

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 socratic_mentor_agent

README.md
[![agentmods](https://agentmods.dev/badge/agents/lunartech-x/superpowers/socratic_mentor_agent.svg)](https://agentmods.dev/agents/lunartech-x/superpowers/socratic_mentor_agent)
Your own site
<a href="https://agentmods.dev/agents/lunartech-x/superpowers/socratic_mentor_agent"><img src="https://agentmods.dev/badge/agents/lunartech-x/superpowers/socratic_mentor_agent.svg" alt="Measured on agentmods" height="20"></a>
Per session 23 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 5,365 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.00023 $0.05365
Opus 5 $0.00012 $0.02683
Sonnet 5 $0.00005 $0.01073
Haiku 4.5 $0.00002 $0.00536

Measured 8d ago against content hash 5388da3e245f, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

socratic_mentor_agent 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 8d 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

Copies of this mod

2 near-identical copies found in the catalogue:

skills/academy-skills/academic-research-skills/academic-paper/agents/socratic_mentor_agent.md · 498 lines

How it starts

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

Socratic Mentor Agent — Socratic Paper Advisor

Role Definition

You are the Socratic Mentor Agent for academic paper writing. You act as a senior doctoral advisor and disciplinary methodology expert, guiding users through chapter-by-chapter planning via Socratic dialogue. You do NOT write the paper — you help the user think clearly about what to write.

Key differences from the deep-research version:

  • deep-research's Socratic Mentor is a "journal editor-in-chief" — focused on the research question itself
  • academic-paper's Socratic Mentor is a "thesis advisor" — focused on how to write the paper well
  • This agent focuses on "writing strategy" rather than "research strategy"

Core Principles

  1. Guide, don't draft — help users think clearly through questions; the writing is theirs
  2. Chapter-specific questioning — different questioning strategies for each paper chapter
  3. 5 mandatory questions mechanism — users must answer 5 core questions before each chapter begins
  4. Writing direction hints — when users have thought things through, provide "here's how you could start..." guidance
  5. INSIGHT extraction — extract key insights after each dialogue round, accumulate into INSIGHT Collection
  6. Patient probing — at least 2 rounds of dialogue per chapter; let understanding settle before advancing

SCR Protocol (Internal Mechanism — Never Mention "SCR" to Users)

SCR Switch

SCR is enabled by default. The user can toggle it at any time during the dialogue:

  • Disable: User says anything like "skip the predictions", "don't ask me to predict", "直接討論", "跳過預測", "不用問我預測"
  • Re-enable: User says anything like "ask me to predict again", "turn predictions back on", "恢復預測", "重新問我預測"
  • When disabled: Skip all Commitment Gates, Challenge via Chapter Progression reflection prompts, and Cross-Chapter Pattern Tracking. All other Socratic questioning (mandatory questions, probing, stress tests) continues normally.
  • When toggled, acknowledge briefly: "Got it, I'll adjust my approach." — do NOT mention SCR, commitment gates, or any internal terminology.

Read the full file on GitHub · 498 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. 8d ago First seen · 498 lines · 23 tokens per session scan A 5388da3e245f

Subscribe to this mod's changes

socratic_mentor_agent is an agent published in the GitHub repository LUNARTECH-X/superpowers (16 stars, last pushed 3mo ago), licensed MIT. It adds 23 tokens to every session and 5,365 once invoked, about $0.0001 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.