{
  "markdown": "# Science Superpowers\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Skills](https://img.shields.io/badge/Skills-16-brightgreen.svg)](#whats-inside)\n[![Agent Plugins](https://img.shields.io/badge/Agent_Plugins-v1.0.0-6E56CF.svg)](https://agent-plugins.org/)\n[![Follow on X](https://img.shields.io/badge/Follow_on_X-%40k__dense__ai-000000?logo=x)](https://x.com/k_dense_ai)\n[![LinkedIn](https://img.shields.io/badge/LinkedIn-K--Dense_Inc.-0A66C2?logo=linkedin)](https://www.linkedin.com/company/k-dense-inc)\n[![YouTube](https://img.shields.io/badge/YouTube-K--Dense_Inc.-FF0000?logo=youtube)](https://www.youtube.com/@K-Dense-Inc)\n[![Reddit](https://img.shields.io/badge/Reddit-u%2F--k--dense---FF4500?logo=reddit&logoColor=white)](https://www.reddit.com/user/-k-dense-/)\n\nScience Superpowers is a complete computational-science methodology for your research agents, built on a set of composable skills plus initial instructions that make sure your agent actually uses them. It has **zero third-party dependencies** — it runs with only your agent harness and a POSIX shell.\n\n> ⭐ **If Science Superpowers helps your research, please [star this repository](https://github.com/K-Dense-AI/science-superpowers).** A star helps other scientists and engineers find the project and tells us the methodology is worth expanding.\n>\n> **Learn more:** [Introducing Science Superpowers](https://www.k-dense.ai/blog/introducing-science-superpowers) — why we built it, the Iron Law, and the full workflow. Related essays are collected under [From the blog](#from-the-blog).\n>\n> **Stay up to date:** Follow K-Dense on [X](https://x.com/k_dense_ai), [LinkedIn](https://www.linkedin.com/company/k-dense-inc), and [YouTube](https://www.youtube.com/@K-Dense-Inc) for new skills, release announcements, and research workflow demos.\n\n> 🎬 **Prefer to watch first?** [Getting Started with Scientific Agent Skills](https://youtu.be/ZxbnDaD_FVg) covers how skills plug into your agent, and [Skills 101](https://youtu.be/lVZbHiwzMEg) walks through writing one yourself.\n\nIt is a reimplementation of [Superpowers](https://github.com/obra/superpowers) (a software-development methodology) for a different domain: doing science with data. The architecture is the same — skills that auto-trigger via a session-start bootstrap — but the workflow is the research lifecycle, and the central discipline is **pre-registration** instead of test-driven development.\n\n## Contents\n\n- [How it works](#how-it-works)\n- [The basic workflow](#the-basic-workflow)\n- [Example: what using it looks like](#example-what-using-it-looks-like)\n- [What's inside](#whats-inside)\n- [Philosophy](#philosophy)\n- [From the blog](#from-the-blog)\n- [Installation](#installation)\n- [Contributing](#contributing)\n- [License](#license)\n- [Star History](#star-history)\n\n## How it works\n\nIt starts the moment you fire up your agent. As soon as it sees you're trying to investigate something, it *doesn't* jump straight into running code on your data. Instead it steps back and helps you turn a fuzzy interest into a precise, falsifiable question.\n\nOnce the question is clear, it grounds the work in prior literature and standard methods, designs the analysis, and **pre-registers** the hypotheses, predictions, and decision rules *before looking at the outcomes*. That separation — confirmatory vs. exploratory, predictions locked before data — is what protects the work from p-hacking and HARKing (hypothesizing after results are known).\n\nThen it executes the pre-registered plan in a reproducible workspace (pinned environment, fixed seeds, immutable raw data), investigates anomalies by root cause instead of quietly dropping inconvenient data, verifies every claim against fresh reproduced evidence, and red-teams the result before reporting it.\n\nBecause the skills trigger automatically, you don't need to do anything special. Your research agent just has Science Superpowers.\n\n## The basic workflow\n\n1. **framing-research-questions** — Activates before any analysis. Turns a rough interest into a precise, falsifiable question with hypotheses, the data needed, and what would count as an answer. Saves a question document.\n2. **surveying-prior-work** — Grounds the question and chosen methods in what's already known: standard methods, known confounds, prior effect sizes.\n3. **designing-the-analysis** — Breaks the work into bite-sized analysis steps with exact datasets, variables, models/tests, power, and decision rules.\n4. **preregistering-analysis** — The Iron Law. Locks hypotheses, directional predictions, and decision rules — and the confirmatory/exploratory split — before any outcome is seen.\n5. **setting-up-reproducible-analysis** — Isolated, reproducible workspace: pinned environment, fixed seeds, immutable raw data, clean baseline.\n6. **subagent-driven-analysis** or **executing-analysis** — Carries out the pre-registered plan with review checkpoints.\n7. **investigating-anomalous-results** — Activates when results look wrong. Root-cause investigation before any adjustment.\n8. **verifying-results-before-claiming** — Evidence before claims: re-run, check assumptions, robustness, reproduce.\n9. **requesting-red-team-review** / **receiving-critical-review** — Adversarial review before you believe or report a result.\n10. **reporting-and-archiving-findings** — Reproducibility check, then write-up/preprint/iterate/shelve/discard, then archive code + data + environment.\n\n**The agent checks for relevant skills before any task.** Mandatory workflows, not suggestions.\n\n### Feasibility mode (opt-in)\n\nThe sequence above assumes the analysis *can* be run. When that is the open question — an unbenchmarked solver, a simulation that has never assembled at full size, a memory ceiling nobody has measured — paying for the full sequence first means writing plans and predictions for a study that may not exist.\n\nFor that case the agent will *offer* **establishing-feasibility-first**: a minimal end-to-end runner, three scaling probes against a budget whose kill criteria are proven to fire, then one exploratory campaign — deferring the survey, plan, and pre-registration until the measured answer is in.\n\nIt is **opt-in and opt-out by you alone**. The agent never enters the mode on its own initiative, never leaves it on its own initiative, and nothing produced inside it can be reported as confirmatory. Pre-registration is deferred, not cancelled: the exit gate hands back to the standard sequence at full strength, with the feasibility measurements as inputs to the design and the exploratory results as hypotheses rather than evidence.\n\n## Example: what using it looks like\n\nYou don't invoke anything. You just talk to your agent like normal — the skills trigger themselves.\n\n> **You:** I have last quarter's churn data. Does our new onboarding flow reduce churn?\n\nA vanilla agent would load the CSV and start slicing. With Science Superpowers, the agent steps back first:\n\n> **Agent:** Before touching the data, let me frame this precisely (`framing-research-questions`). The question is whether the new onboarding flow *causes* lower 90-day churn — but users weren't randomly assigned to it, so cohort and seasonality are confounders. Here's the falsifiable version, the data we'd need, and what would count as an answer…\n>\n> *[surveys prior internal analyses and standard methods, then designs the analysis]*\n>\n> **Agent:** I'm now **pre-registering** the hypothesis, the directional prediction (new flow → lower churn), and the decision rule **before** I look at any outcome (`preregistering-analysis`). Everything beyond this that wasn't pre-registered will be labeled exploratory.\n>\n> *[runs the pre-registered plan in a pinned, seeded, reproducible workspace; an anomaly appears]*\n>\n> **Agent:** One cohort shows implausibly low churn. Rather than dropping it, I'm root-causing it (`investigating-anomalous-results`) — it turns out to be a logging gap, not a real effect.\n>\n> *[verifies every claim against freshly reproduced output, then red-teams its own conclusion before reporting]*\n\nThe result is an analysis where the confirmatory claims are protected from p-hacking and HARKing, the anomalies were explained rather than hidden, and every number can be reproduced.\n\n## What's inside\n\n### Skills library\n\n**Framing**\n- **[framing-research-questions](skills/framing-research-questions/SKILL.md)** — Turn an interest into a falsifiable question (entry gate)\n- **[surveying-prior-work](skills/surveying-prior-work/SKILL.md)** — Ground the question and methods in existing literature\n- **[establishing-feasibility-first](skills/establishing-feasibility-first/SKILL.md)** — Opt-in exploratory/feasibility mode: prove the computation runs at scale before paying for process\n\n**Planning & pre-registration**\n- **[designing-the-analysis](skills/designing-the-analysis/SKILL.md)** — Detailed, bite-sized analysis plan\n- **[preregistering-analysis](skills/preregistering-analysis/SKILL.md)** — Lock predictions and decision rules before seeing outcomes (includes a statistical-fallacies reference and `prereg.sh`, a zero-dependency freeze/audit script that proves from git history alone that predictions preceded outputs and were never edited after the freeze)\n\n**Execution**\n- **[subagent-driven-analysis](skills/subagent-driven-analysis/SKILL.md)** — Fresh subagent per analysis step with two-stage review\n- **[executing-analysis](skills/executing-analysis/SKILL.md)** — Inline batch execution with checkpoints\n- **[dispatching-parallel-investigations](skills/dispatching-parallel-investigations/SKILL.md)** — Concurrent independent investigations\n\n**Discipline**\n- **[investigating-anomalous-results](skills/investigating-anomalous-results/SKILL.md)** — 4-phase root-cause process for surprising results\n- **[verifying-results-before-claiming](skills/verifying-results-before-claiming/SKILL.md)** — Evidence before claims\n\n**Review**\n- **[requesting-red-team-review](skills/requesting-red-team-review/SKILL.md)** — Dispatch a skeptical reviewer to attack the analysis\n- **[receiving-critical-review](skills/receiving-critical-review/SKILL.md)** — Respond to critique with rigor, not performative agreement\n\n**Workspace & reporting**\n- **[setting-up-reproducible-analysis](skills/setting-up-reproducible-analysis/SKILL.md)** — Isolated, reproducible workspace\n- **[reporting-and-archiving-findings](skills/reporting-and-archiving-findings/SKILL.md)** — Decide how to report; archive code, data, environment\n\n**Meta**\n- **[writing-science-skills](skills/writing-science-skills/SKILL.md)** — Create new skills following the testing methodology\n- **[using-science-superpowers](skills/using-science-superpowers/SKILL.md)** — Introduction to the skills system\n\n## Philosophy\n\n- **Pre-registration** — State predictions and decision rules before seeing outcomes\n- **Confirmatory vs. exploratory** — Always labeled, never blurred\n- **Reproducibility** — Pinned environments, fixed seeds, immutable raw data\n- **Evidence over claims** — Verify before declaring a finding\n- **Root cause over patching** — Investigate anomalies; don't quietly drop data\n\n## From the blog\n\nEssays from the [K-Dense blog](https://www.k-dense.ai/blog) on this methodology and the problems it is built to solve.\n\n**This project**\n- **[Introducing Science Superpowers](https://www.k-dense.ai/blog/introducing-science-superpowers)** (May 28, 2026) — Why we built it, the Iron Law, and the full workflow: pre-registration over TDD.\n- **[Your AI Assistant Reasons Like a Generalist. Science Needs a Specialist.](https://www.k-dense.ai/blog/introducing-scientific-agents)** (June 2, 2026) — Companion open-source `AGENTS.md` profiles; names Science Superpowers as the methodology layer that puts pre-registration ahead of trial and error.\n\n**Why discipline, not a smarter model**\n- **[AI Co-Scientist, Not AI Scientist: Why the Name Matters](https://www.k-dense.ai/blog/ai-co-scientist-not-ai-scientist)** (May 5, 2026) — Keep the human scientist front and center; the agent is a partner, not a replacement.\n- **[The AI Co-Scientist Is Here. The Bottleneck Is Verification.](https://www.k-dense.ai/blog/ai-co-scientist-verification-bottleneck)** (June 3, 2026) — Power is not the open question; whether the work is verifiable is.\n- **[The Model Is No Longer the Bottleneck](https://www.k-dense.ai/blog/the-model-is-no-longer-the-bottleneck)** (June 7, 2026) — Capability has moved; the remaining bottleneck is the workflow around the model.\n- **[The Week Science Models Became Real](https://www.k-dense.ai/blog/frontier-science-models-arrive)** (June 12, 2026) — Frontier models entered scientific workflows; the next bottleneck is evidence.\n- **[Reproduction, Not Generation, Is AI's Killer App for Science](https://www.k-dense.ai/blog/reproduction-not-generation-ai-for-science)** (June 16, 2026) — Agents that reproduce published findings matter more than agents that generate unchecked claims.\n- **[AI Scientists Need Lab Escape Rooms, Not More Exams](https://www.k-dense.ai/blog/science-needs-better-black-boxes)** (June 29, 2026) — Benchmarks should demand real evidence, not science theater.\n\n**How agent skills work**\n- **[Agent Skills: The Final Piece for AI-Powered Scientific Research](https://www.k-dense.ai/blog/agent-skills-final-piece-for-ai-powered-research)** (January 13, 2026) — Why composable skills close the gap between raw model intelligence and domain expertise.\n\n## Installation\n\nInstallation differs by harness. If you use more than one, install Science Superpowers separately for each.\n\n### Agent Plugins (any conformant client)\n\nThis repository is a valid [Agent Plugins](https://agent-plugins.org/) v1.0.0 package — the open, vendor-neutral plugin standard. The portable manifest is `plugin.json` at the repository root, and the sixteen skills are the immediate children of `skills/`, each with its own `SKILL.md`.\n\nAny client that implements the specification can install Science Superpowers by pointing at this repository; no harness-specific configuration is required for the skills themselves. Bootstrap hooks remain client-specific — see the sections below for the harness you use, or invoke the `using-science-superpowers` skill manually at the start of a session.\n\n### Cursor\n\nIn Cursor Agent chat, install from the plugin marketplace, or point Cursor at this repository as a plugin. The `sessionStart` hook (`hooks/hooks-cursor.json`) loads the bootstrap automatically.\n\n### Claude Code\n\nRegister a marketplace pointing at this repo (`.claude-plugin/marketplace.json`) and install the `science-superpowers` plugin. The `SessionStart` hook (`hooks/hooks.json`) loads the bootstrap.\n\n### Codex\n\nUse the committed Codex manifest at `.codex-plugin/plugin.json`.\n\n### Gemini CLI\n\nInstall as an extension; `gemini-extension.json` points the context file at `GEMINI.md`, which loads the bootstrap and the Gemini tool mapping.\n\n### OpenCode\n\nSee [.opencode/INSTALL.md](.opencode/INSTALL.md).\n\n### Pi\n\nPi natively reads the same `SKILL.md` format. Install the package with\n`pi install git:github.com/K-Dense-AI/science-superpowers`; the `package.json` `pi` key\nregisters the skills and a `before_agent_start` extension loads the bootstrap. See\n[.pi/INSTALL.md](.pi/INSTALL.md).\n\n### Google Antigravity\n\nAntigravity natively supports Agent Skills (the same `SKILL.md` format) and reads `GEMINI.md` / `AGENTS.md` / `.agent/rules/` as always-on rules at session start. Install the skills and load the bootstrap rule — see [.antigravity/INSTALL.md](.antigravity/INSTALL.md).\n\n## Contributing\n\nSee `AGENTS.md` / `CLAUDE.md` for contributor guidelines, and `skills/writing-science-skills/SKILL.md` for the complete guide to creating and testing skills.\n\n## License\n\nMIT License — see the LICENSE file. This project reimplements the architecture of [Superpowers](https://github.com/obra/superpowers) by Jesse Vincent.\n\n## Star History\n\n<a href=\"https://star-history.dera.page/#K-Dense-AI/science-superpowers\">\n <picture>\n   <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://star-history.dera.page/svg?repos=K-Dense-AI/science-superpowers&theme=dark\" />\n   <source media=\"(prefers-color-scheme: light)\" srcset=\"https://star-history.dera.page/svg?repos=K-Dense-AI/science-superpowers\" />\n   <img alt=\"Star History Chart\" src=\"https://star-history.dera.page/svg?repos=K-Dense-AI/science-superpowers\" />\n </picture>\n</a>\n",
  "bytes": 16415,
  "sha": "a46b9d5a1cd51fc56927402737149c8210c2f2573daa254b6618814db9285215",
  "repo_slug": "k-dense-ai/science-superpowers",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_k_dense_ai_science_superpowers_072f1169/readme"
}