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.