hpc

Yale SOM HPC — Claude Code Marketplace

This repo is a Claude Code plugin marketplace of skills for the Yale SOM HPC cluster (hpc.som.yale.edu). Once installed, Claude Code loads the right skill on demand when you ask it to do something on the cluster — submit a job, request a GPU, set up a project, query WRDS, diagnose a wasteful run, etc.

The skills are written for two pillars:

1. Be polite. The HPC is a shared resources. Other people are running jobs right now on the same nodes, GPUs, and GPFS metadata servers.
2. Be skillful. Get your research done swiftly, beautifully, and correctly.

What's in the hpc plugin

Skill	Purpose
overview	Mental model, partition layout, two-pillar manifesto.
connecting-securely	SSH keys, config, agents, Jupyter tunnels.
managing-jobs	sbatch, arrays, dependencies, right-sizing loop.
using-gpus	When to request GPUs and how to verify they're used.
using-the-filesystem	GPFS, project space, scratch, atomic writes.
installing-software	Modules, uv, static binaries, Apptainer.
starting-a-new-project	Reproducible project layout.
running-python	uv, Slurm, thread control, resumable tasks.
parallel-python	Worker sizing, spawn-vs-fork, nested-parallelism warning.
accelerating-python	DuckDB, Polars, Numba, when to add parallelism.
running-r	renv, Rscript Slurm jobs, BLAS thread control.
running-stata	Batch do-files, scratch temp, license courtesy.
working-with-large-data	Parquet, columnar formats, query engines.
acquiring-data	WRDS, REST APIs, scraping, connection pooling, request-hash caches.
self-diagnosing-resource-use	sacct, seff, post-job right-sizing.

Install

You need Claude Code installed. Skills are loaded by Claude Code's plugin system; nothing runs on the cluster until you ask Claude to do something there.

Pick the path that matches how you use Claude Code.

Claude Code CLI (terminal)

Available in every Claude Code session on your laptop. Inside Claude Code:

/plugin marketplace add yale-som-hpc/claude-code-marketplace
/plugin install hpc@yale-som-hpc

Update later with /plugin marketplace update yale-som-hpc.

Claude Code in VS Code or Cursor

VS Code and Cursor (Cursor is VS Code-based) have a graphical plugin manager. In the Claude Code prompt box, type:

/plugins

That opens the Manage plugins panel. Switch to the Marketplaces tab, click Add marketplace, and paste:

yale-som-hpc/claude-code-marketplace

Then go back to the Plugins tab and install hpc. Configuration syncs with the CLI, so the same /plugin marketplace add ... command also works inside the VS Code chat box if you prefer typing.

Claude Code in JetBrains IDEs / Claude Desktop app

These surfaces do not have a graphical plugin manager. Open a terminal (the JetBrains integrated terminal is fine) and use the CLI install path above. Once installed via CLI, the plugin works in every Claude Code session — including the JetBrains and desktop apps — because plugin state is shared per-user.

Claude Code on the web (claude.ai/code)

The web app does not have a marketplace UI. Use the per-project install below; the web app picks up .claude/settings.json from any repo it opens.

Per-project (committed to a repo)

If you want the skills available only inside a specific repo, or you want every collaborator on a project to get them automatically, commit the marketplace reference into the repo. Add a .claude/settings.json like:

{
  "extraKnownMarketplaces": {
    "yale-som-hpc": {
      "source": {
        "source": "github",
        "repo": "yale-som-hpc/claude-code-marketplace"
      }
    }
  },
  "enabledPlugins": {
    "hpc@yale-som-hpc": true
  }
}

Commit .claude/settings.json. Anyone who runs Claude Code in the project — CLI, VS Code, Cursor, web — will have the hpc plugin enabled automatically the first time they trust the marketplace.

Verify

Inside Claude Code:

/plugin