Open Infra Skills

Open, portable agent skills for building, operating, profiling, and optimizing AI infrastructure.

This repository is intended to grow into a comprehensive, vendor-aware library for the full AI systems lifecycle: accelerator bring-up, distributed training, inference serving, kernels and compilers, data pipelines, observability, benchmarking, and cluster operations.

Why This Repository Exists

AI infrastructure work is full of environment-specific details, expensive experiments, and performance claims that are easy to mismeasure. Open Infra Skills packages repeatable engineering workflows as self-contained agent skills so that an assistant can:

• establish a reproducible baseline before changing a system;
• choose the right diagnostic layer, from application timing to system traces and kernel counters;
• preserve numerical behavior while optimizing performance;
• distinguish measured evidence from hypotheses;
• work across local machines, SSH hosts, schedulers, containers, and clouds without assuming one client operating system.

Skill Catalog

The machine-readable catalog is available in catalog.json.

Install

The repository follows the open Agent Skills directory convention. Use the Skills CLI to inspect or install it:

# List all skills in the repository.
npx skills add open-infra-skills/infra-skills --list

# Install one skill interactively.
npx skills add open-infra-skills/infra-skills --skill optimize-musa-training

# Install one skill globally for Codex without prompts.
npx skills add open-infra-skills/infra-skills \
  --skill optimize-musa-training \
  --global \
  --agent codex \
  --yes

You can also clone the repository and point a compatible agent at a skill directory directly. Each skill keeps its instructions and optional scripts, references, and agent metadata together.

Repository Layout

infra-skills/
|-- skills/
|   `-- /
|       `-- /
|           |-- SKILL.md
|           |-- agents/       # Optional agent-facing metadata
|           |-- references/