claudeers.
// MCP Servers

research-superpowers

Skill-driven research workflow for Claude Code: theology, biblical archaeology, ancient history, digital humanities. Methodology-aware (hermeneutic / quantit…

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up research-superpowers (git-clone project) into my current project.
Found on https://claudeers.com/research-superpowers
Repo: https://github.com/leiverkus/research-superpowers
Homepage/docs: https://github.com/leiverkus/research-superpowers
Detected install method: git-clone → git clone https://github.com/leiverkus/research-superpowers
Category: mcp-servers. Platforms: cli, api, web, mobile.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
unknown; community-verified: false. Confirm the source before running anything.
// or clone
git clone https://github.com/leiverkus/research-superpowers

// compatibility

Platformscli, api, web, mobile
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguagePython

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

research-superpowers

A Claude Code / OpenCode plugin that turns LLM-assisted research into a disciplined, reproducible workflow.

Inspired by obra/superpowers, adapted to the research lifecycle: idea → plan → literature → ingest → analysis → draft → peer review → publication.

Built for theology, biblical archaeology, ancient history, and digital humanities — methodology-aware (hermeneutic / quantitative / mixed) so it doesn't force quantitative pre-registration onto hermeneutic work, but enforces it where it belongs.

Why

LLM-assisted research is fast but easy to get wrong:

  • Citations get hallucinated. Author–year strings drift from what the source actually says.
  • Synthesis pages get written from memory of the source, not the source itself.
  • The "I'll cite this properly later" moment never returns.
  • Pre-registration norms from quantitative psychology get jammed into hermeneutic disciplines where the hermeneutic circle is constitutive, not a methodological failure.
  • "Don't cite academia.edu as a primary source" stays as a red flag the model ignores, until a structural mechanism makes it enforceable.

research-superpowers makes the discipline structural:

  • 18 skills with checklists, SOFT-GATES, and red-flag tables for every phase
  • 7 subagents for context-isolated heavy lifting (ingest, acquire, draft, review, analysis, literature search, lint)
  • Frontmatter schema that the linter validates and your editor live-checks
  • Methodology branching — hermeneutic projects skip frozen-hypothesis pre-registration; quantitative keeps it; mixed is per sub-study
  • Audit-trail SOFT-GATES that prompt for a written override reason and log it, instead of silently blocking
  • Two recommended MCPs for verified citations and web source-class detection (optional; plugin works without them)

Who is this for

  • Researchers in theology, biblical archaeology, ancient history, digital humanities who want LLM help without losing the discipline their field expects from a manuscript.
  • Anyone running mixed-methods projects where some sub-studies need formal pre-registration and others legitimately don't.
  • Teams who want a shared schema for their research wiki, with structural checks (frontmatter validation, wikilink resolution, override-rate tracking).

If you write Python ML papers with frozen RCT hypotheses, this plugin's discipline machinery is overkill (use a simpler workflow). If you write archaeology / theology / DH papers with contested sources and iterative reading, this is for you.

Installation

New here? The full docs/installation.md walks through everything step by step — prerequisites, the three install paths, verification, troubleshooting. Allow 5–10 minutes.

Cowork user or no terminal? docs/installation-cowork.md is the click-only path — just Claude, no Python, no Git. Allow 3–5 minutes.

Familiar with Claude Code plugins? Three lines:

claude                                                          # open Claude Code anywhere
/plugin marketplace add leiverkus/research-superpowers          # register the marketplace
/plugin install research-superpowers@leiverkus-research         # install the plugin

That installs and activates it. Restart Claude Code and you'll see a "Research Superpowers" notice at session start.

Other install paths

  • Direct from GitHub (no marketplace registration):
    /plugin install https://github.com/leiverkus/research-superpowers
    
  • Local clone (for development or customisation):
    git clone https://github.com/leiverkus/research-superpowers ~/code/research-superpowers
    
    then in Claude Code:
    /plugin install ~/code/research-superpowers
    
  • OpenCode (2.x): run opencode/install.sh from the clone — it links the skills, the generated subagents and the session-start plugin into ~/.config/opencode/. Details in opencode/README.md.

Prerequisites

  • Claude Code 2.x or newer
  • Python 3.10+ with PyYAML (python3 -m pip install --user pyyaml)
  • Git

If any are missing, docs/installation.md shows how to install each.

For PDF output only (Quarto + XeLaTeX/LuaLaTeX — not needed for HTML or the wiki): the templates ship with free, OFL-licensed fonts tuned for scholarly transcription of Semitic languages — Latin transliteration (ḥ ṣ ṭ ʾ ʿ ā ī ū), polytonic Greek, and native Hebrew (RTL):

# macOS (Homebrew casks)
brew install --cask font-gentium-plus font-noto-sans font-fira-code
# Ezra SIL (Hebrew) has no cask — download from https://software.sil.org/ezra/
# and copy the .ttf into ~/Library/Fonts/
RoleFontCovers
bodyGentium PlusLatin transliteration + polytonic Greek
headingsNoto Sanstransliterated terms incl. ʾ / ʿ
codeFira Codemonospace
Hebrew (RTL)Ezra SILnative Hebrew with niqqud/cantillation

Full install + usage notes (incl. the Hebrew \foreignlanguage macro) are in the template's output/README.md.

Create your first research project

After the plugin is installed, scaffold a project from the template:

cp -r ~/.claude/plugins/cache/leiverkus-research/research-superpowers/templates/research-project-template ~/Documents/my-first-project
cd ~/Documents/my-first-project

Edit the three frontmatter lines at the top of CLAUDE.md (methodology, discipline, languages), then run claude in the project root. You're ready — head to the Quickstart for your first ingest.

Two MCP servers by the same author add structurally verified citations and source-class detection. The plugin works without them. See docs/recommended-mcps.md for setup.

30-second example

In a research project (scaffold one from templates/research-project-template/), point the project at the shared library (.research-library) and tell Claude Code:

Ingest the Finkelstein 2003 PDF.

The ingest-source skill triggers, reads the PDF fully, derives slug finkelstein-2003, extracts bibliographic data and entities (people, places, concepts), and writes:

  • knowledge/sources/finkelstein-2003.md — structured wiki page (theses, methodology, verbatim quotes with pages, mentioned entities)
  • one stub knowledge/entities/<entity>.md per new entity
  • one BibTeX entry in output/bibtex/references.bib
  • one log line in knowledge/_meta/log.md
  • runs python scripts/lint-wiki.py — exits 0

You review the diff, accept or revise, commit. Repeat per source. After ~5 sources, synthesise. After synthesis is status: stable, draft. Every claim cites a source page; every citation resolves in BibTeX; every render is checked.

Full walkthrough: docs/tutorial.md.

Skill topology

brainstorming-research → writing-research-plan → literature-review → acquire-sources ⇄ ingest-source
   → executing-research-plan → drafting-manuscript → revising-manuscript → requesting-peer-review → finishing-a-research-project
SkillPhaseWhat it does
brainstorming-researchIdeaTurns a vague interest into an approvable design doc
writing-research-planPlanDesign → research plan (methodology-aware: hermeneutic vs quantitative templates)
literature-reviewDiscoveryStrategic search across DAO + cross-platform databases, produces literature guide + BibTeX (no downloads)
acquire-sourcesAcquisitionAuto-downloads OA PDFs for the A+B set; writes a manual-download worklist for paywalled sources; re-run to reconcile
ingest-sourceIntakeOne acquired PDF → wiki source page + entities + BibTeX + log (hard-stops on a missing original)
executing-research-planExecutionRoutes tasks to subagents; methodology-aware review tiers
drafting-manuscriptDraftingStable syntheses → publishable prose with inline citations, render-checked
revising-manuscriptRevisionWorks through an existing text paragraph by paragraph; every decision goes into a revision ledger on disk, re-read before each edit; minimal edits; approved paragraphs stay frozen
requesting-peer-reviewReviewTwo-stage (constructive + adversarial) with discipline-specific checklists
finishing-a-research-projectClosing13-item closing checklist, DOI, archive

Cross-cutting (context-triggered, no phase binding):

SkillPurpose
add-to-libraryAdd one standalone PDF straight to the shared master library — verifies metadata against Crossref/OpenAlex, derives keywords cheaply from docinfo + abstract, computes the bibkey, places the PDF + appends the entry. Outside the project ingest flow
wiki-lintStructural validation (frontmatter, wikilinks, override rate) — runs scripts/lint-wiki.py
drift-reportDeterministic maintenance findings across library + all registered projects (index, scans, bloat, merge drift, bibkey collisions). Runs automatically at session start, state-triggered: fingerprints of library/bibs/wiki are compared against the last look — nothing changed, nothing runs, nothing is said
wiki-graphStructure analysis — runs scripts/wiki-to-graph.py; god nodes, bridges, clusters; exports graph.json / graph.graphml
semantic-wiki-reviewLLM content audit (contradictions, stale syntheses, generic conclusions, aggregator citations)
grant-finderDFG / ERC / VolkswagenStiftung / Henkel / Thyssen funding-landscape mapping

Subagents (agents/<name>.md) provide context isolation for heavy tasks; each declares implements: <skill-name> and never duplicates the skill's checklist.

Phase graph with hermeneutic back-edges and SOFT-GATE semantics: docs/phase-flow.md.

Documentation

FilePurpose
docs/installation.mdStep-by-step install with prerequisites, paths, troubleshooting
docs/installation-cowork.mdClick-only install path for Cowork / non-terminal users
docs/quickstart.md5 minutes from install to first ingest
docs/tutorial.mdEnd-to-end walkthrough on a realistic mini-project
docs/concepts.mdSOFT-GATE pattern, methodology branching, SOT pattern — the why
docs/recommended-mcps.mdOptional MCP setup (verified citations + source-class detection)
docs/frontmatter-schema.mdPointer to the central JSON schema
docs/phase-flow.mdGraph of phases with back-edges and SOFT-GATEs
docs/skill-contract.mdSOT pattern + inputs: / outputs: frontmatter
docs/skill-authoring.mdHow to add or change a skill
docs/skill-pressure-testing.mdHow to find out whether a HARD-STOP or SOFT-GATE actually holds — RED/GREEN scenarios in tests/pressure/
CHANGELOG.mdFull version history
CONTRIBUTING.mdHow to contribute (language convention, PR checklist)

Repository layout

research-superpowers/
├── README.md                     # this file
├── LICENSE                       # MIT
├── CHANGELOG.md
├── CONTRIBUTING.md
├── .gitignore
├── .claude-plugin/plugin.json    # plugin manifest
├── schema/
│   ├── knowledge-frontmatter.schema.json
│   └── README.md
├── hooks/                        # SessionStart hook injects the skill index
├── skills/                       # 18 SKILL.md files (the SOT for each workflow)
├── agents/                       # 7 thin-pointer subagents
├── templates/research-project-template/
│   ├── CLAUDE.md                 # frontmatter declares methodology + discipline
│   ├── schema/                   # mirror of plugin schema (for project-local lint)
│   ├── scripts/lint-wiki.py      # validates against the schema; reports override rate
│   └── .vscode/settings.json     # yaml.schemas → live frontmatter validation
├── examples/example-project/     # a small worked example
└── docs/                         # the docs listed above

Versioning

Semantic Versioning. At 0.x.y, minor versions may include breaking changes when they buy real architectural clarity (see CHANGELOG.md — v0.2 was a major architecture overhaul). Patch versions are additive. Once we reach 1.0.0, strict semver applies.

License

MIT, Patrick Leiverkus, 2026. See LICENSE.

// faq

What is research-superpowers?

Skill-driven research workflow for Claude Code: theology, biblical archaeology, ancient history, digital humanities. Methodology-aware (hermeneutic / quantitative / mixed) with SOFT-GATE audit trails and optional MCP integration.. It is open-source on GitHub.

Is research-superpowers free to use?

research-superpowers is open-source under the MIT license, so it is free to use.

What category does research-superpowers belong to?

research-superpowers is listed under mcp-servers in the Claudeers registry of Claude-compatible tools.

0 views
★ 12 stars
unclaimed
updated about 8 hours ago

// embed badge

research-superpowers on Claudeers
[![Claudeers](https://claudeers.com/api/badge/research-superpowers.svg)](https://claudeers.com/research-superpowers)

// retro hit counter

research-superpowers hit counter
[![Hits](https://claudeers.com/api/counter/research-superpowers.svg)](https://claudeers.com/research-superpowers)

// reviews

// guestbook

0/500

// related in MCP Servers

🔓

f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete…

// mcp-serversf/⟨HTML⟩★ 177,810◷ NOASSERTION[ claude ]
🔓

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io

// mcp-serversfarion1231/⟨Rust⟩★ 155,814◷ MIT[ claude ]
🔓

🪨 why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman

// mcp-serversJuliusBrussee/⟨JavaScript⟩★ 121,982◷ MIT[ claude ]
🔓

An open-source AI agent that brings the power of Gemini directly into your terminal.

// mcp-serversgoogle-gemini/⟨TypeScript⟩★ 108,744◷ Apache-2.0[ claude ]
→ see how research-superpowers connects across the ecosystem