Skip to content

william-dawson/hpc-rikyu

v0.1.1

Facility-specific HPC workflow skills for RIKYU (RIKEN AI4S / GB200). Install the hpc base plugin first for MCP tools.

rikyu-configuring

Use when the user wants to set up, configure, or troubleshoot RIKYU (RIKEN AI4S / GB200) β€” SSH access, the embedding endpoint for docs search (RAG), or the ~/.hpc-agent/rikyu.json file. Also use when rikyu tools fail with connection or embedding errors.

rikyu-demo

Interactive demo of RIKYU (RIKEN AI4S / GB200) β€” walks through configuration, facility info, live cluster status, docs search, filesystem access, and a real job end to end.

rikyu-monitoring-jobs

Use when the user asks about the status, progress, output, history, or failure of jobs on RIKYU (RIKEN AI4S / GB200), or about queue and node availability. Also use this any time you (the agent) need to check on or wait for a job you submitted, even without a fresh user request.

rikyu-reference

Use to answer questions about RIKYU (RIKEN AI4S / GB200) itself β€” hardware, partitions, storage, software, policies, or where to get help. Ground answers in the bundled guide and live tool output rather than prior knowledge.

rikyu-remote-command

Use when the user wants to run one or more shell commands on RIKYU (RIKEN AI4S / GB200)'s login node, or when another workflow needs run_command_on_cluster for a live check not covered by a safer typed tool. Requires an exact command preview and explicit user permission before execution.

rikyu-reproducing

Use when the user asks to make a result on RIKYU (RIKEN AI4S / GB200) reproducible, shareable, or turned into a notebook/script β€” or proactively suggest it after a chunk of exploratory job/file work that produced something worth preserving. Builds a Jupyter notebook that replays the real workflow via hpc_agent_core.client, not a hand-copied SSH script.

rikyu-submitting-jobs

Use when the user wants to run, submit, or launch a job on RIKYU (RIKEN AI4S / GB200). Covers partition/queue selection, JobSpec construction, submission, and known gotchas specific to this facility.