Mad Science plugin
Mad Science is a Claude Code plugin, by samuhs, found on GitHub. Hypothesis-driven data science & ML experiment skills for Claude Code, Codex, Copilot, Cursor and Gemini CLI
- Source
- Community
- Author
- samuhs
- GitHub stars
- 2
- License
- MIT
- Last pushed
- Nov 11, 2026
Facts are read from the plugin's GitHub repository. Anthropic does not review community plugins added from a repository, so check the source before you install. Plugin security
Skills in Mad Science
The 14 skills this plugin adds to Claude, read from its SKILL.md files. Claude uses a skill when your request matches it, or you can pick one with /. More in the Claude skills directory.
- Critic Review/mad-science:critic-reviewReview the project docs and experiments for gaps between what is documented, what was implemented, and the state of the art.
- Developing Data Science Notebooks/mad-science:developing-data-science-notebooksDevelop production-grade Jupyter notebooks for data science research that follow state-of-the-art code practices (cell structure, modularization, reproducibility) and are designed to transition…
- Exp Review/mad-science:exp-reviewReview experiment code and Jupyter notebooks on two axes in parallel sub-agents: standards (does the code follow the repo's documented coding standards?) and quality (reproducibility, fixed seeds…
- Expectation Driven Science/mad-science:expectation-driven-scienceDevelopment guided by the scientific method and explicit expectations.
- Experiment Graph/mad-science:experiment-graphRender a read-only interactive graph of an experiment pipeline doc: dependencies, status and critical path at a glance.
- Experiment Pipeline/mad-science:experiment-pipelineBreak an experiment doc into small vertical slices (stages, phases, experiments) with goals, metrics, status and dependencies, tracked in docs/experiments-pipeline.
- Hypothesys/mad-science:hypothesysGrill the user relentlessly about a data science or ML hypothesis until it is clear, falsifiable and tied to goal metrics: premises, baseline and success criteria.
- Let It Rip/mad-science:let-it-ripImplement or fix an experiment in a Jupyter notebook from its experiment doc and pipeline, expectation-first: run every cell, review the result with /exp-review, then commit.
- Literature Research/mad-science:literature-researchInvestigate a question against high-trust primary sources and capture the findings as a Markdown file in the repo.
- Mad Science Setup/mad-science:mad-science-setupSet up a repository for the mad-science data science skills: experiment tracker folder, domain glossary, agent instructions block and .env.example.
- Notify Gchat Human Wait/mad-science:notify-gchat-human-waitSend a Google Chat card through the webhook set in .env (GCHAT_WEBHOOK_URL) when the agent is waiting for human input, with the open question and the project name.
- To Article/mad-science:to-articleUse when asked to generate, draft, or rewrite a scientific/technical article in Computer Science (conference paper, journal paper, or survey) from a topic/idea plus the repository's code…
- To Doc/mad-science:to-docTurn the current conversation into an experiment doc (hypothesis, premises, baseline, success metrics, experiment stories) and publish it to the project docs, with no new interview.
- What I Do/mad-science:what-i-doOrientation map and canonical catalogue of the mad-science data science skills.
What the Mad Science plugin installs
Read from the plugin's repository. Only its skills have been read so far; it may also ship commands, hooks or MCP servers, so check the source. What to check first.
- Skills(14)
- Instructions Claude loads when a task matches. They run nothing by themselves.
How to install the Mad Science plugin
This is a community plugin for Claude Code. Run these commands in a Claude Code session.
Add the marketplace
/plugin marketplace add samuhs/mad-scienceInstall the plugin
/plugin install mad-science@samuhs
In the Claude app
Open Plugins in the sidebar, then Add > Add marketplace, and enter samuhs/mad-science. Install Mad Science from the list that appears.
Related guides
Claude plugin validation failed? Check the package first
Most plugin validation errors are package problems, not Claude problems. The real error messages and the fixes, tested on v2.1.296.
How to create a Claude skill (SKILL.md)
A Claude skill is a folder with a SKILL.md file. Where to put it, which frontmatter fields matter and how to write a description Claude matches.
Turn off or remove a Claude plugin (and why removing a marketplace removes its plugins)
Turning off, uninstalling and removing a marketplace differ: removing a marketplace uninstalls its plugins and deletes their data. Tested on v2.1.325.
Maintain this plugin?
You can add this badge to your README to link to this page. It is optional and does not change your listing.
[](https://www.claudecoworkplugins.com/plugins/samuhs-mad-science/)Official Claude plugins
Design
Critique designs, manage a design system, write UX copy, audit accessibility and prepare developer handoff.
Operations
Manage vendors, document processes, plan capacity, handle change requests and track compliance.
Small Business
Ready-made workflows to run and grow a small business, with your approval on every step that touches money or customers.