Heropedia

Heropedia Plugin for Claude Code

Consult 324+ hand-crafted expert personas — Warren Buffett, Steve Jobs, Charlie Munger, Linus Torvalds, and more — directly from any Claude Code session.

This plugin bundles:

• `heropedia` skill — triggers on phrases like *"ask to..."*, *"consult "*, *"channel "*. Fetches the canonical persona prompt from Heropedia MCP before answering, so the reply is truly through that expert's lens (not an impression of it).
• `.mcp.json` — registers https://www.heropedia.org/mcp as an MCP server so Claude Code can call getList, getListByHero, getListByRole, and getDetail.

The plugin does not ship any data. All 324+ personas live at heropedia.org and are fetched on demand.

Skills

This plugin bundles two skills that share the same MCP server:

• `heropedia` — single-turn "ask an expert" lens. Triggers on phrases like *"ask Warren Buffett to look at my deck"*, *"as Steve Jobs, review this page"*, *"consult Charlie Munger"*. Fetches the canonical persona prompt and replies in one turn through that lens. Best for a quick second opinion.
• `heropedia-office-hour` — five-phase structured multi-turn session hosted by any hero. Triggers on *"let hold office hours"*, *"office hour with "*, *"office hour on "*. The hero opens, asks 5–6 forcing questions one at a time (from a curated ## Office Hour Questions section if the persona has one, otherwise distilled on the fly), takes a direct position on your real problem, then gives you a diagnosis, a one-week action, and a red-flag warning. Saves local notes to ~/.heropedia/office-hours/. Best when you want to be pushed, not just answered.

Both skills refuse to invent personas — they always fetch canonical prompts from heropedia before speaking.

One office-hour skill, four agents

skills/heropedia-office-hour/SKILL.md is a single file in the open Agent Skills format. The same file runs in:

Re-running the install command upgrades the skill to the latest version.

Install

Pick your AI. Every path targets the same endpoint (https://www.heropedia.org/mcp).

Anthropic — Claude Code (recommended)

claude plugin marketplace add https://github.com/SiliconRoshiBill/heropedia-plugin

claude plugin install heropedia@heropedia

Auto-registers the MCP server as plugin:heropedia:heropedia. Open a new session and you're wired up.

Anthropic — Claude Desktop

Add to claude_desktop_config.json:

{

"mcpServers": { "heropedia": { "command": "npx", "args": ["-y", "mcp-remote", "https://www.heropedia.org/mcp"] } } }

OpenAI — ChatGPT (web / macOS / Windows apps)

Available on Plus, Pro, Business, Enterprise, and Edu plans (not Free / Team).

1. Settings → *Connectors* → Advanced → toggle *Developer mode* on.
2. Settings → *Connectors* → *Add custom connector*.
3. Paste MCP URL: https://www.heropedia.org/mcp
4. Auth: *No authentication*. Save.
5. Enable the *Heropedia* connector for chats where you want it.

Business/Enterprise workspaces: a workspace admin adds the connector under Workspace Settings → Connectors → New app.

OpenAI — Codex (CLI)

curl -sSL https://raw.githubusercontent.com/SiliconRoshiBill/heropedia-plugin/main/codex/install-codex.sh | bash

Add --with-agents to also install the workflow-enforcing AGENTS.md, and --with-skills to install (or upgrade) the office-hour skill into ~/.codex/skills/:

curl -sSL https://raw.githubusercontent.com/SiliconRoshiBill/heropedia-plugin/main/codex/install-codex.sh | bash -s -- --with-agents --with-skills

To let the office hour save notes to ~/.heropedia/office-hours/, start Codex with codex --add-dir ~/.heropedia.

Or manually add to ~/.codex/config.toml:

[mcp_servers.heropedia]

url = "https://www.heropedia.org/mcp"

OpenAI — Agents SDK

Python (openai-agents-python):

from agents import Agent, Runner

from agents.mcp import MCPServerStreamableHttp

async with MCPServerStreamableHttp( params={"url": "https://www.heropedia.org/mcp"}, name="heropedia", ) as server: agent = Agent( name="ConsultantAgent", instructions=( "When the user asks to consult a specific expert, call " "getListByHero to find the entry, then getDetail to fetch " "the canonical prompt. Apply that persona — do not paraphrase." ), mcp_servers=[server], ) result = await Runner.run(agent, "Ask Warren Buffett to review my pricing page.") print(result.final_output)

TypeScript (@openai/agents):

import { Agent, Runner } from "@openai/agents";

import { MCPServerStreamableHttp } from "@openai/agents/mcp";

const heropedia = new MCPServerStreamableHttp({ url: "https://www.heropedia.org/mcp", name: "heropedia", });

const agent = new Agent({ name: "ConsultantAgent", instructions: "When the user asks to consult a specific expert, call getListByHero " + "to find the entry, then getDetail to fetch the canonical prompt. " + "Apply that persona — do not paraphrase.", mcpServers: [heropedia], });

const result = await Runner.run(agent, "Ask Warren Buffett to review my pricing page."); console.log(result.finalOutput);

Google — Gemini CLI

This repo is a Gemini CLI extension: gemini-extension.json registers the MCP server, and both skills under skills/ are picked up automatically.

gemini extensions install https://github.com/SiliconRoshiBill/heropedia-plugin   # upgrade later: gemini extensions update heropedia

gemini --include-directories ~/.heropedia # lets the office hour save notes

MCP only — paste this into your Gemini config instead:

{

"mcpServers": { "heropedia": { "httpUrl": "https://www.heropedia.org/mcp" } } }

Google — Antigravity

Register the MCP server in ~/.gemini/antigravity/mcp_config.json:

{

"mcpServers": { "heropedia": { "serverUrl": "https://www.heropedia.org/mcp" } } }

Install the office-hour skill to ~/.gemini/config/skills/, the global skills folder that every Antigravity flavor (IDE, CLI, agent) reads:

mkdir -p ~/.gemini/config/skills/heropedia-office-hour

curl -sSL https://raw.githubusercontent.com/SiliconRoshiBill/heropedia-plugin/main/skills/heropedia-office-hour/SKILL.md \ -o ~/.gemini/config/skills/heropedia-office-hour/SKILL.md

Re-run the curl line to upgrade.

Cursor

Add to your Cursor MCP config file:

{

"mcpServers": { "heropedia": { "url": "https://www.heropedia.org/mcp" } } }

Any HTTP MCP client

Direct JSON-RPC 2.0 POST to https://www.heropedia.org/mcp. See heropedia.org/mcp-guide for examples.

Try it

Once installed, just ask:

"Ask Warren Buffett to review my SaaS pricing page."

"As Steve Jobs, tear apart this landing page."

"Consult Charlie Munger on this go/no-go decision."

"What would Linus Torvalds say about this refactor?"

"Get a product critic to look at this feature spec."

Claude will:

1. Recognize the persona intent.
2. Call mcp__heropedia__getListByHero to find the entry.
3. Call mcp__heropedia__getDetail to fetch the canonical prompt.
4. Answer through that persona's lens.

If a name maps to multiple roles (e.g. Warren Buffett as investor vs. business analyst), Claude asks which lens fits your task before answering.

What's inside

heropedia-plugin/

├── .claude-plugin/ │ ├── plugin.json # plugin manifest │ └── marketplace.json # marketplace listing (installable via claude plugin marketplace add) ├── .mcp.json # MCP server registration ├── skills/ │ ├── heropedia/ │ │ └── SKILL.md # single-turn "ask an expert" skill │ └── heropedia-office-hour/ │ └── SKILL.md # five-phase multi-turn office-hour skill ├── scripts/ │ ├── validate-skill.sh # structural lint for office-hour SKILL.md │ └── test-scenarios.md # manual QA scenarios ├── codex/ # Codex CLI installer (MCP, AGENTS.md, skills) ├── gemini-extension.json # Gemini CLI extension descriptor (MCP + skills/) └── README.md

Requirements

• Claude Code (any recent version).
• Internet access — the MCP server is hosted at https://www.heropedia.org/mcp.
• Nothing else. No API key. No account. Public endpoint, IP-rate-limited (300 req/min list, 60 req/min detail).

The MCP endpoint

Public HTTP MCP server at https://www.heropedia.org/mcp speaking MCP 2025-06-18 Streamable HTTP. Four read-only tools:

Returns lightweight metadata ({id, hero_name, role_name, description}) from LIST tools; only getDetail returns the full persona prompt.

User guide with install snippets, examples, and FAQ: heropedia.org/mcp-guide

Uninstall

claude plugin uninstall heropedia

License

MIT. See LICENSE.

The persona content at heropedia.org is separately MIT-licensed in the SiliconRoshiBill/heropedia content repo.

Contribute a new hero

Anyone with a GitHub account can. Submit at heropedia.org/submit. The community votes on the best versions.