Supported Platforms

swm ships a standard SKILL.md that works with any agent that can execute shell commands. The file lives at .agents/skills/swm-gpu-workflow/SKILL.md in the swm repo.

Quick install (any platform)

The .agents/skills/ directory is the universal path recognized by Cursor, Codex, Copilot, Windsurf, Amp, and Devin. Clone it into your project:

# From your project root
mkdir -p .agents/skills
cp -r /path/to/swm/.agents/skills/swm-gpu-workflow .agents/skills/

Or grab it directly from GitHub:

mkdir -p .agents/skills/swm-gpu-workflow
curl -sL https://raw.githubusercontent.com/swm-gpu/swm/main/.agents/skills/swm-gpu-workflow/SKILL.md \
  -o .agents/skills/swm-gpu-workflow/SKILL.md

Cursor

Option A — Install from GitHub (easiest):

1. Open Cursor Settings (Cmd+Shift+J)
2. Navigate to Rules
3. Click Add Rule → Remote Rule (GitHub)
4. Paste: https://github.com/swm-gpu/swm

Cursor auto-imports the skill from the repo’s .agents/skills/ directory.

Option B — Copy to your project:

mkdir -p .cursor/skills/swm-gpu-workflow
curl -sL https://raw.githubusercontent.com/swm-gpu/swm/main/.agents/skills/swm-gpu-workflow/SKILL.md \
  -o .cursor/skills/swm-gpu-workflow/SKILL.md

Option C — Install globally (all projects):

mkdir -p ~/.cursor/skills/swm-gpu-workflow
curl -sL https://raw.githubusercontent.com/swm-gpu/swm/main/.agents/skills/swm-gpu-workflow/SKILL.md \
  -o ~/.cursor/skills/swm-gpu-workflow/SKILL.md

The agent auto-discovers the skill. Ask “Spin up an H100 with vLLM” and it activates.

Claude Code

Claude Code discovers skills from .claude/skills/:

mkdir -p .claude/skills/swm-gpu-workflow
curl -sL https://raw.githubusercontent.com/swm-gpu/swm/main/.agents/skills/swm-gpu-workflow/SKILL.md \
  -o .claude/skills/swm-gpu-workflow/SKILL.md

Or install globally:

mkdir -p ~/.claude/skills/swm-gpu-workflow
curl -sL https://raw.githubusercontent.com/swm-gpu/swm/main/.agents/skills/swm-gpu-workflow/SKILL.md \
  -o ~/.claude/skills/swm-gpu-workflow/SKILL.md

Claude Code also reads skills from .agents/skills/ if present.

OpenAI Codex

Codex discovers skills from .codex/skills/:

mkdir -p .codex/skills/swm-gpu-workflow
curl -sL https://raw.githubusercontent.com/swm-gpu/swm/main/.agents/skills/swm-gpu-workflow/SKILL.md \
  -o .codex/skills/swm-gpu-workflow/SKILL.md

Or install globally:

mkdir -p ~/.codex/skills/swm-gpu-workflow
curl -sL https://raw.githubusercontent.com/swm-gpu/swm/main/.agents/skills/swm-gpu-workflow/SKILL.md \
  -o ~/.codex/skills/swm-gpu-workflow/SKILL.md

GitHub Copilot

Copilot reads skills from .agents/skills/:

mkdir -p .agents/skills/swm-gpu-workflow
curl -sL https://raw.githubusercontent.com/swm-gpu/swm/main/.agents/skills/swm-gpu-workflow/SKILL.md \
  -o .agents/skills/swm-gpu-workflow/SKILL.md

Windsurf / Amp / Devin

All three read .agents/skills/ natively:

mkdir -p .agents/skills/swm-gpu-workflow
curl -sL https://raw.githubusercontent.com/swm-gpu/swm/main/.agents/skills/swm-gpu-workflow/SKILL.md \
  -o .agents/skills/swm-gpu-workflow/SKILL.md

Any other agent

The only requirements are that the agent can:

1. Read the SKILL.md instructions
2. Execute shell commands (swm ...)
3. Parse command output (plain text tables)
4. Ask the user clarifying questions

If your agent supports these capabilities, copy the SKILL.md into whatever instructions file your agent reads and it will work.

Skill discovery paths (reference)

Platform	Project-level	User-level (global)
Cursor	.cursor/skills/, .agents/skills/	~/.cursor/skills/, ~/.agents/skills/
Claude Code	.claude/skills/	~/.claude/skills/
Codex	.codex/skills/	~/.codex/skills/
Copilot	.agents/skills/	—
Windsurf	.agents/skills/	—
Amp	.agents/skills/	—
Devin	.agents/skills/	—