hpc-runtime-doctor agent skill by HeshamFS

At a glance

Before you install

Read from the skill's files at the directory's October 22, 2026 snapshot: what ships with it, what its code reads, and the terms it is published under.

• Bundled scripts: 1 script file (1 Python). Your agent may run them, so read them first.
• Tool permissions requested: Read, Bash, Write, Grep, Glob (the allowed-tools field of SKILL.md).
• License: Apache-2.0, an open-source or open-content license.

Install hpc-runtime-doctor

The skills CLI works with Claude Code, Codex, Cursor and other agents; the other routes copy the folder by hand.

npx skills add https://github.com/HeshamFS/materials-simulation-skills/tree/main/skills/hpc-deployment/hpc-runtime-doctor

tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/HeshamFS/materials-simulation-skills.git "$tmp/repo"
mkdir -p .claude/skills
cp -R "$tmp/repo/"skills/hpc-deployment/hpc-runtime-doctor .claude/skills/
rm -rf "$tmp"

tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/HeshamFS/materials-simulation-skills.git "$tmp/repo"
mkdir -p .agents/skills
cp -R "$tmp/repo/"skills/hpc-deployment/hpc-runtime-doctor .agents/skills/
rm -rf "$tmp"

For a user-level install, copy the folder to ~/.claude/skills/ (Claude Code) or ~/.agents/skills/ (Codex). Inside Codex, $skill-installer can also fetch a skill from GitHub. New to skills? Read How to install agent skills in Claude Code, Codex and Cursor.

HeshamFS/materials-simulation-skills is third-party code. Read SKILL.md and any bundled scripts before you install it.

How the author describes it

Diagnose HPC runtime and scheduler problems for materials simulations, including MPI/OpenMP/GPU layout, modules, CUDA/Kokkos hints, scratch paths, walltime, job arrays, restart strategy, scheduler portability, and resource mismatch. Use when an ALREADY-SUBMITTED job failed, ran slowly, got killed, or behaved differently on a cluster than on a workstation. To author or vet a NEW submission script before running, use slurm-job-script-generator instead.

From the description field of SKILL.md. Agents read this line to decide when to load the skill.

Sections in SKILL.md

• Goal
• Requirements
• Inputs to Gather
• Decision Guidance
• Script Outputs
• Workflow
• Error Handling
• Limitations
• Verification checklist
• Common pitfalls & rationalizations
• Security
• Input Validation
• File Access
• Tool Restrictions
• Safety Measures
• References

Files in the skill folder

• CHANGELOG.md
• SKILL.md
• evals/evals.json
• references/hpc_runtime_patterns.md
• scripts/hpc_runtime_doctor.py

Suede Skill Check: 85/100 · B

hpc-runtime-doctor passes the required frontmatter check and all seven graded checks, which cover the SKILL.md format, a declared license and a commit in the last year. Those checks earn 56 of the score’s points; the rest come from description quality, instruction depth, bundled files, maintenance and curated-list citations. How the score works.

Where this skill is cited

HeshamFS/materials-simulation-skills appears in 2 curated lists: BehiSecc/awesome-claude-skills, VoltAgent/awesome-agent-skills.

More science and research skills

All science and research skills

More from HeshamFS/materials-simulation-skills

All 24 skills in HeshamFS/materials-simulation-skills