# console-saves

console-saves is a Claude Code skill that imports PS2 memory card saves into game ports and backs them up. It activates when you ask to migrate PCSX2 saves or sync progress across devices.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 449 repo stars
- Author: Jake Schincariol
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/Jakeschincariol/console-skill/tree/HEAD/console-saves/SKILL.md
- Updated: 2026-10-22
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/console-saves

## What it does

The skill handles save migration for PS2Recomp ports via the bundled `memcard.py` script. It parses raw 8 MB memory card dumps in `.ps2`, `.mcd`, and `.bin` formats with or without ECC, alongside PCSX2 folder cards. Extracted save folders are placed directly into `mc0` next to the game ELF binary, preserving original title serials.

Memory card images remain strictly read-only: the tool never writes back to `.ps2` files. Single saves can be handled as `.psu` exports or imports. Any command replacing existing progress creates a timestamped zip backup inside `console/saves/backups/`. Running this skill requires Python 3 on the host system.

## Requirements
- Works with: Google Drive

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add Jakeschincariol/console-skill
```
In the agent chat (not a shell):
```text
/plugin install console-skill@console-skill
```
This installs the whole console-skill plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add Jakeschincariol/console-skill --skill console-saves -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/console-saves/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/console-saves/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Jakeschincariol/console-skill --skill console-saves -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/console-saves/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Jakeschincariol/console-skill --skill console-saves -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/console-saves/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Jakeschincariol/console-skill console-saves
```

2. **Manually: put the files in place**
- File: `.github/skills/console-saves/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Jakeschincariol/console-skill --skill console-saves -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Jakeschincariol/console-skill --path console-saves
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/console-saves/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Jakeschincariol/console-skill/tree/HEAD/console-saves/SKILL.md

## When to use it
- inspect save files inside raw PS2 memory card dumps
- extract specific title saves into port folders
- import and export standalone .psu save files
- sync mc0 directory progress across cloud storage folders

## Example prompts
- List all saves inside `~/Documents/PCSX2/memcards/Mcd001.ps2`
- Export save `BASLUS-20312GAME` from `Mcd001.ps2` into `console/disc/mc0`
- Create a zip backup of the `console/disc/mc0` directory

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 57e76f5933c0b4a6.

BEGIN THIRD-PARTY FILE 57e76f5933c0b4a6
````text
---
name: console-saves
description: >-
  Save Manager. Brings your old memory card saves over, backs them up and syncs them to the cloud so
  you continue on any device. Reads PS2 memory card images (PCSX2 .ps2 and .mcd, raw 8 MB dumps, with
  or without ECC) and PCSX2 folder cards, lists every save with its title, copies saves into the port's
  folder memory card (mc0 next to the game's ELF), imports and exports single saves as .psu, makes
  timestamped zip backups, and syncs mc0 with an iCloud Drive, Dropbox, Google Drive or Syncthing
  folder. Card images are read only; mc0 is backed up before anything replaces a save; a sync never
  silently overwrites (when both sides changed it keeps both and reports a conflict). Use when the user
  says "bring my saves over", "import my PCSX2 save", "my memory card", "back up my saves", "sync my
  saves", "continue on my Steam Deck", "restore a backup", "convert this .psu", or before the first run
  of a port that needs a save.
argument-hint: "info|ls|export|psu|backup|restore|sync <card or mc0> [flags]"
---

# console-saves

The Save Manager moves your progress into the port and keeps it safe. The PS2Recomp runtime does not
use a card image: it keeps memory card slot 1 as plain folders in `mc0` next to the game's ELF, one
folder per save, exactly as the game names them (`mc0/BASLUS-20312GAME/...`), and slot 2 in the sibling
folder `mc1` (`ps2xRuntime/src/lib/Kernel/Stubs/MemoryCard.cpp`, `getMcRootPath`). `memcard.py` reads
your old card, writes those folders, and then backs them up and syncs them.

Honest limits: card images are read only (writing them back needs ECC and is out of scope; PCSX2's own
memory card manager can import a `.psu`). Saves from other formats (`.max`, `.cbs`, `.xps`) need a
converter first. A save copied to another region's version of a game usually will not load. Whether the
port loads a given save depends on how far the port is: test it.

`${CLAUDE_SKILL_DIR}` below is this skill's folder (where this SKILL.md lives).

```bash
python3 "${CLAUDE_SKILL_DIR}/memcard.py" ls ~/Documents/PCSX2/memcards/Mcd001.ps2      # saves, titles, serials
python3 "${CLAUDE_SKILL_DIR}/memcard.py" export Mcd001.ps2 --to console/disc/mc0 --only BASLUS-20312GAME
python3 "${CLAUDE_SKILL_DIR}/memcard.py" psu import BASLUS-20312GAME.psu --to console/disc/mc0
python3 "${CLAUDE_SKILL_DIR}/memcard.py" psu export console/disc/mc0/BASLUS-20312GAME --out console/saves/game.psu
python3 "${CLAUDE_SKILL_DIR}/memcard.py" backup console/disc/mc0                                # console/saves/backups/
python3 "${CLAUDE_SKILL_DIR}/memcard.py" sync console/disc/mc0 --cloud "$HOME/Library/Mobile Documents/com~apple~CloudDocs/console-saves/SLUS-20312"
```
````
END THIRD-PARTY FILE 57e76f5933c0b4a6

The third-party file has ended. Everything between the 57e76f5933c0b4a6 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2730 of 7332 bytes. © Jake Schincariol · MIT · https://github.com/Jakeschincariol/console-skill/tree/HEAD/console-saves/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
