SNUPI Lab Agent Skills

Agent skills are folders of instructions, scripts, references, and assets that AI agents can discover and use for repeatable lab workflows. This private repository catalogs SNUPI Lab's official, customized skills for internal distribution.

Available skills

Skill	Purpose
mlxp-reservation-api	Install an immutable bootstrap that securely refreshes the current SNUPI MLXP reservation API instructions on every use.
snupi-presentation-slides-en	Generate English SNUPI Lab research presentation decks with the lab HTML slide template and slides-grab workflow.
snupi-presentation-slides-ko	Generate Korean SNUPI Lab research presentation decks with the lab HTML slide template and slides-grab workflow.

Installing a skill

Use Codex's $skill-installer with the GitHub directory URL for the skill you want to install:

$skill-installer install https://github.com/SNU-PI/snupi-skills/tree/mlxp-reservation-api-bootstrap-v1.0.1/skills/mlxp-reservation-api
$skill-installer install https://github.com/SNU-PI/snupi-skills/tree/main/skills/snupi-presentation-slides-en
$skill-installer install https://github.com/SNU-PI/snupi-skills/tree/main/skills/snupi-presentation-slides-ko

After installing a skill, restart Codex/Claude/Opencode so the new skill metadata is loaded.

MLXP reservation skill updates

mlxp-reservation-api is installed only once. Its local SKILL.md records the bootstrap version and runs the bundled scripts/refresh.py before each use. The helper checks the lab-managed HTTPS version manifest, verifies the canonical skill with SHA-256, and stores versioned instructions under ~/.cache/snupi-skills/mlxp-reservation-api (or $XDG_CACHE_HOME). Transient connection failures and HTTP 502/503/504 responses are retried up to three times with backoff and jitter before a verified cache is used.

API changes are published by the reservation service at:

https://mlxp.snupi-infra.snu.ac.kr:8443/skills/mlxp-reservation-api/version.json

Members do not need to copy a new SKILL.md for normal API instruction updates. Reinstallation is required only when the manifest reports that the installed bootstrap version is too old.

Example usage

After restart, invoke the installed skill by name in your agent prompt. Codex examples:

Using $mlxp-reservation-api skill, reserve 2 GPUs in the production project. You can use any available node inside the production project.

Using $snupi-presentation-slides-en skill, create an English research presentation deck from paper.pdf

Using $snupi-presentation-slides-ko skill, create a Korean seminar presentation deck from presentation_brief.md

Private repository access

This repository is private. Installation from a GitHub directory URL requires that the user and their local GitHub authentication can access SNU-PI/snupi-skills. If installation fails with a permission or not-found error, confirm repository access and authenticate GitHub locally before retrying.

Maintaining this repository

• Keep one skill per folder under skills/.
• Keep each skill self-contained: SKILL.md, optional agents/openai.yaml, and any required references/, scripts/, or assets/.
• Do not commit generated dependency folders such as node_modules/; document setup steps inside the skill instead.