Mxl Hpc Slurm

This skill should be used when users need to run MaxwellLink in SLURM/HPC environments, including dependent job patterns and robust socket host/port handoff.

9 stars 5 forksOther

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add TaoELi/MaxwellLink --skill mxl-hpc-slurm
Manual install
git clone --depth 1 https://github.com/TaoELi/MaxwellLink.git /tmp/MaxwellLink
mkdir -p ~/.claude/skills
cp -r /tmp/MaxwellLink/skills/mxl-hpc-slurm ~/.claude/skills/mxl-hpc-slurm

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# SLURM/HPC workflows

## Profile source of truth
- Load HPC defaults from ``HPC_PROFILE.json`` in the current workspace when present.

## Choose socket transport
- Use UNIX sockets only when the EM solver and driver run on the same node.
- Use TCP sockets when the EM solver and drivers run on different nodes.

## Use the two-step SLURM pattern (main job + driver job)
- Make the main job start the hub and write `host` and `port` to a shared text file (e.g. `tcp_host_port_info.txt`).
- Make the driver job wait until the file exists, read the file, then run `mxl_driver --model ... --address "$HOST" --port "$PORT" ...`.
- Submit the driver job with `--dependency=after:<main_job_id>` so it starts only after the hub is scheduled and begins running.

## Prefer robust host/port discovery
- Recommended (most robust on locked-down clusters): bind the hub to all interfaces (`host=""` / `0.0.0.0`), pick a free port locally, and write a reachable hostname via `MXL_HOST` or `hostname -f`.
- Convenience helper: `maxwelllink.sockets.get_available_host_port(localhost=False, save_to_file=...)` can pick a port and write the file for you.
  - If cluster outbound networking is blocked, this helper may fail to discover an external IP; fall back to the "most robust" pattern above.

## Multi-molecule / multi-driver patterns
- For `N` molecules, launch `N` driver processes (hub assigns molecule IDs automatically as clients connect).
Read the full skill on GitHub

Details

Skill name
mxl-hpc-slurm
Path
skills/mxl-hpc-slurm/SKILL.md
License
GPL-2.0
Repo updated
17 November 2026

FAQ

What does the Mxl Hpc Slurm skill do?

This skill should be used when users need to run MaxwellLink in SLURM/HPC environments, including dependent job patterns and robust socket host/port handoff.

How do I install the Mxl Hpc Slurm skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add TaoELi/MaxwellLink --skill mxl-hpc-slurm. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Mxl Hpc Slurm popular?

It lives in TaoELi/MaxwellLink, which has 9 GitHub stars and 5 forks.

Related skills

Browse the most popular Claude skills, all other skills, or write your own with the skills generator.