Skip to content

Phd Skills

PhD Research Skills for Claude Code: paper reproduction, experiment design, paper review, result comparison and more.

Install

$claude plugin install phd-skills@phd-skills

Install command taken from the project's README or registry entry. Always review code before running it.

phd-skills

Catch AI mistakes before they cost weeks of compute. Reproduce papers from arxiv. Debug runs evidence-first. Compare experiments at the right epoch. Launch with discipline.

Built by Fatih Cagatay Akyon (2000+ citations, 5 patents) after 300+ Claude Code sessions, tens of critical AI mistakes caught the hard way, and thousands of hours of PhD research. Every guardrail in this plugin traces to a real mistake.


Paper search and acquisition use Paper Search CLI, installed with uv and Python 3.10+. See paper search setup. Other skills do not require it.

Why This Plugin Exists

Claude Code is powerful, but it makes research-specific mistakes that cost weeks of compute:

  • It typed "done?" as "dont?" and launched an unwanted upload of thousands of files
  • It analyzed my full dataset when I asked for a specific 4k/2k/2k split
  • It claimed a test covered a bug it had never actually verified
  • It never once looked at a figure it generated, just trusted the numbers
  • It restarted a 50-hour training job without diffing the config against the reference run, lost three days
  • It claimed an experiment was diverging based on a non-converged proxy metric, killed it before downstream eval would have shown the truth
  • It ran rm -rf on a path it had hallucinated from memory, lost local checkpoints

Other plugins give you more commands. This plugin gives you guardrails.


Install

claude plugin marketplace add fcakyon/phd-skills
claude plugin install phd-skills@phd-skills

The plugin works correctly the moment it is installed. Optional: run /phd-skills:setup for a 30-second tour of what was auto-detected and to opt into extras (notifications, allowlist, LaTeX).


Usage

Open Claude Code in your project directory, then:

  • /phd-skills:reproduce arxiv 2508.12345 reproduce a paper from arxiv URL through replication runs
  • "why is my loss diverging?" the debug skill auto-triggers, runs evidence-first probes
  • "compare run alpha to baseline" the compare skill auto-triggers, aligns at the same epoch
  • "launch the new training run" the launch skill auto-triggers, runs the pre-flight checklist
  • /loop 30m check experiment logs, notify me if metrics beat the baseline or if loss starts to diverge

Notifications (task completion, background agents) forward to ntfy / Slack / email after /phd-skills:setup.


What You Get

Commands

Similar plugs

The 1st Collaborative AI Design Agent Workspace. Local-first and open source. Create prototypes, websites, apps, dashboards, presentations, images, and videos with your team…

Editorial diagram design for Claude Code, Codex, GitHub Copilot, Cursor, Factory Droid, and Pi. 44 diagram types. Self-contained HTML + SVG. No shadows. No Mermaid slop.

Explore related