К основному содержанию
скилл CX Codex

console-saves — скилл для Claude Code: перенос сохранений PS2

Скилл console-saves для Claude Code переносит сохранения с карт памяти PS2 в порты игр и синхронизирует их через облако. Срабатывает при запросах на бэкап или импорт сохранений PCSX2.

MIT ★ 449 обновлён 2026-10-22

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add Jakeschincariol/console-skill
/plugin install console-skill@console-skill
Открыть на GitHub

Что делает console-saves

Скилл управляет сохранениями для проектов на базе среды PS2Recomp с помощью скрипта memcard.py. Он считывает дампы карт памяти в форматах .ps2, .mcd и .bin размером 8 МБ с кодами коррекции ECC или без них, а также папочные карты PCSX2. Извлечённые данные раскладываются по структуре директорий mc0 рядом с исполняемым файлом ELF, где имя каждой папки строго соответствует серийному номеру игры.

Дампы карт памяти открываются строго только для чтения, поэтому обратно в .ps2 скилл данные не записывает. Для одиночных файлов поддерживается экспорт и импорт контейнеров .psu. Перед перезаписью файлов утилита автоматически архивирует всю директорию mc0 в zip-архив с меткой времени. Для работы требуется установленный Python 3.

Какие задачи решает

  • извлечь сохранения из образов карт памяти PCSX2
  • сконвертировать сохранения в формат папочной карты mc0
  • экспортировать отдельные слоты в файлы .psu
  • настроить синхронизацию сохранений через Dropbox или iCloud

Примеры запросов агенту

  • Покажи список сохранений на карте ~/Documents/PCSX2/memcards/Mcd001.ps2
  • Перенеси сохранение BASLUS-20312GAME из Mcd001.ps2 в папку console/disc/mc0
  • Сделай резервную копию сохранений из папки console/disc/mc0

Как установить console-saves

1Через маркетплейс плагинов

/plugin marketplace add Jakeschincariol/console-skill
/plugin install console-skill@console-skill

Команда ставит плагин console-skill целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add Jakeschincariol/console-skill --skill console-saves -a claude-code

3Вручную: положить файлы

~/.claude/skills/console-saves/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/console-saves/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о console-saves

Как установить console-saves в Claude Code?

В интерфейсе Claude Code выполните по очереди команды /plugin marketplace add Jakeschincariol/console-skill и /plugin install console-skill@console-skill.

Что делает скилл console-saves?

Он читает дампы карт памяти PlayStation 2, извлекает сохранения конкретных игр и переносит их в структуру каталогов mc0, используемую рекомпилированными портами.

Что нужно для работы console-saves?

Требуется установленный интерпретатор Python 3 для исполнения скрипта memcard.py, а также исходные файлы дампов карт или контейнеры .psu.

Исходный текст

SKILL.md · MIT
---
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"
```

Other commands and flags: `info <card>` (format, ECC, free space), `ls --files`, `restore <zip> --to
mc0 [--force]`, `export --force` and `psu import --force` (replace, after a backup), `backup --keep N
--label NAME`, `sync --push | --pull`, `sync --prefer local|cloud|newest`, `sync --dry-run`, `--json`.
Exit codes: 0 ok, 1 needs attention (a conflict, a save already there, a damaged save skipped, a cloud
file not downloaded), 2 bad input (not a card, truncated, damaged directories, an unsafe name).

## What it reads and writes

| path | what |
| --- | --- |
| `*.ps2`, `*.mcd`, `*.bin` card image | read only: superblock, FAT, directories (8 MB = 8,388,608 bytes plain or 8,650,752 with ECC) |
| a PCSX2 folder card | read only; its `_pcsx2_*` metadata files are skipped |
| `<elf dir>/mc0/<SAVE>/<file>` | the port's memory card slot 1 (slot 2: `<elf dir>/mc1`) |
| `*.psu` | one save folder: written by `psu export`, read by `psu import` and `psu ls` |
| `console/saves/backups/<game>-mc0-<UTC time>.zip` | backups; the newest 20 per card are kept |
| `<elf dir>/.console-sync.json` | what the last sync saw, per mc0 and cloud folder (kept out of mc0) |
| `<cloud>/.console-conflicts/<time>-<device>/` | both versions of every conflict (`here/` and `cloud/`) |

Card format, `.psu` layout and the runtime's folder card in detail:
[reference/memcard-format.md](reference/memcard-format.md). Cloud folders per device, the sync rules
and settling conflicts: [reference/cloud-sync.md](reference/cloud-sync.md).

## The method

1. **Find your saves.** PCSX2 keeps cards in its `memcards` folder (`Mcd001.ps2`, `Mcd002.ps2`, or a
   folder per card when folder cards are on). From a real PS2, copy the card with homebrew you already
   run (uLaunchELF copies a save folder to USB as a `.psu`), or use the image file an SD-card memory
   card adapter keeps. `ls` the card: each row shows the folder, size, date, the serial in the folder
   name (`BASLUS-20312...` is SLUS-20312, USA) and the title from `icon.sys`.
2. **Match the game.** The save folder's serial must match the disc the port runs (`console/STATE.md`
   or `/console-reverse`'s `iso.py boot`). Another region's save usually will not load.
3. **Close the port.** Never write into mc0 while the game runs.
4. **Bring it over.** `export <card> --to <elf dir>/mc0 [--only SAVE]`, or `psu import <x.psu> --to
   <elf dir>/mc0`. Both refuse to replace a save that is already there; `--force` replaces it after
   zipping the whole mc0 into `console/saves/backups/`.
5. **Back up.** `backup <elf dir>/mc0` before every session that matters, and before any change by hand.
   `restore <zip> --to mc0` puts one back (it backs up what is there first and needs `--force` to
   replace a non-empty mc0).
6. **Sync (optional).** `sync <elf dir>/mc0 --cloud <a folder your cloud app syncs>`. First run on the
   device with the saves; then on every other device. Use one cloud folder per game. Read the summary:
   a conflict means both sides changed since the last sync; nothing was overwritten, both versions are
   in `.console-conflicts`, and `--prefer local|cloud|newest` settles it.
7. **Playtest.** Start the port and load the save (/console-tester). Write one line in
   `console/STATE.md`: which save, from where, backup name.

## Guard rails

- **Bring your own game.** Saves go with a game you own and dumped yourself. Never download ISOs, ELFs
  or BIOS files, never help find them, never ask for them.
- **Nothing from the game gets published.** The disc, ELF, IRX modules and recompiled C++ stay on your
  machine. Your saves are yours: keep the cloud folder private, never a public share link.
- **Back up before every change.** `export --force`, `psu import --force`, `restore --force` and any
  `sync` that writes into mc0 make a zip first. Do the same before editing saves by hand.
- **Formatting deletes mc0.** In the port, a game's "format memory card" option removes the whole mc0
  folder (`sceMcFormat` and `sceMcUnformat` call `remove_all` on it). Back up before letting a game
  format a card.
- **Card images are read only.** This tool never writes a `.ps2` or `.mcd`.
- **Not affiliated with Sony.** PlayStation is a trademark of Sony Interactive Entertainment.

## Hands off to

- /console-tester to boot the port and check the save loads.
- /console-backend when the game cannot save or load in the port (`Kernel/Stubs/MemoryCard.cpp`, the
  `sceMc*` handlers, and `ps2xIOP/src/modules/mcserv.cpp` for games that talk to MCSERV over RPC).
- /console-anywhere to run the same port on another device; then `sync` there.

© Jake Schincariol · MIT · Jakeschincariol/console-skill

Похожие скиллы

Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
c-files daxaur Скилл c-files для Claude Code учит агента работать с облачными хранилищами через rclone: копировать, синхронизировать, монтировать и проверять файлы. Задачи — бэкапы и перенос данных. CX Codex +1 ★ 179звёзд репо WireCat Google Drive WireCatLabs MCP-сервер WireCat Google Drive для подключения Google Drive к AI-кодерам. Импортирует документы и таблицы в локальные снимки Markdown, ищет по содержимому и синхронизирует изменения. CX Codex +1 ★ 1звёзд репо session-backup MSApps-Mobile Плагин session-backup собирает файлы Claude Cowork и отправляет архивы в Google Drive. Запускайте копирование вручную или настройте ежедневный запуск. ★ 11звёзд репо google-drive-automation sanjay3290 Скилл google-drive-automation для Claude Code ищет, скачивает и меняет файлы в Google Drive. Он подключается к задачам по управлению файлами и папками через скрипты. CX Codex +1 917установок cli-backup-sync cheaper-inference Скилл cli-backup-sync для работы с бэкапами Anthropic из терминала: инкрементальные снимки, синхронизация с облаком, расписания и восстановление из архивов. CX Codex +1 1 300установок atxp-memory atxp-dev Скилл atxp-memory синхронизирует markdown-файлы памяти агента с сервером ATXP и выполняет быстрый локальный поиск по ним без обращения к сети. CX Codex +1 736установок

Из того же набора12

Весь набор →
console-skill Плагин console-skill для Claude Code помогает переносить принадлежащие вам игры PlayStation 2 на ПК через PS2Recomp. Одиннадцать скиллов ведут порт от анализа кода до сборки и тестирования. ★ 449звёзд репо console-physics Скилл console-physics для Claude Code ищет физические константы в ELF игры и печатает патчи для PCSX2 и PS2Recomp. Запускается для скорости, гравитации, прыжка, сцепления и FPS. CX Codex +1 ★ 449звёзд репо console-levels Скилл console-levels для Claude Code находит на извлечённом диске PS2 архивы уровней, распаковывает их в отдельные файлы и собирает обратно после правок. Запускается на просьбу «распакуй этот архив». CX Codex +1 ★ 449звёзд репо console-anywhere Скилл console-anywhere для Claude Code готовит сборку PS2Recomp для выбранного устройства и собирает папку для игрока. Запускается по просьбе собрать порт для Steam Deck, Android, Mac или другого поддерживаемого устройства. CX Codex +1 ★ 449звёзд репо console-sound Скилл console-sound для Claude Code извлекает аудиодорожки из файлов PS2 и добавляет в них собственные записи. Он работает с форматами VAG и SPU2 ADPCM, преобразуя их в WAV для редактирования. CX Codex +1 ★ 449звёзд репо console-controller Скилл console-controller для Claude Code подключает геймпады, клавиатуру и touch-управление к PS2Recomp. Меняет раскладку, стики и ввод для двух игроков. CX Codex +1 ★ 449звёзд репо console-tester Скилл console-tester для Claude Code автоматизирует плейтестинг портов PS2. Запускает ELF через ps2EntryRunner, отслеживает сбои, разбирает логи по адресам и сравнивает дампы с PCSX2. CX Codex +1 ★ 449звёзд репо console-backend Скилл console-backend для Claude Code разбирает логи PS2Recomp и ранжирует проблемы backend. Он подключается после остановки игры или команды про syscall, IOP и stub. CX Codex +1 ★ 449звёзд репо

Ещё в каталоге

Спонсоры проекта

Компании, которые помогают держать аналитику открытой