Skip to content
Get packs

Cheat State Migrator

Upgrades a cheat-on-content state file to the latest schema version, step by step, with backup.

Source Download skill
Repository
XBuilderLAB/cheat-on-content
Stars
7,443
Licence
MIT
Files
1 file

What it does

This skill helps users of the cheat-on-content project move their saved progress file (.cheat-state.json) to the newest format after an update. The agent reads a version list, works out which upgrade steps are needed, shows a dry-run plan, backs up the file, applies each step described in plain-language migration notes, and verifies the result. If a step fails, it stops at the last good version rather than rolling back.

Great for

  • Existing cheat-on-content users whose state file is on an older schema version
  • Maintainers testing migration chains between schema versions

Skip it if

  • Users with no existing cheat-on-content state file, since there is nothing to migrate (cheat-init writes the latest format directly)
  • Anyone wanting to downgrade: the skill refuses downgrades because schema changes are one-way

Try asking

  • “迁移”
  • “我的 state 是老版本，帮我升级”
  • “schema 版本不对，看看要怎么升”
  • “migrate my cheat state to the latest version”
Step-by-step guide: how to use Cheat State MigratorInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    cheat-migrate.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip cheat-migrate.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip cheat-migrate.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Let the dry-run run first and read the plan before answering yes
  • Keep the generated .cheat-state.json.backup file until you have confirmed the upgraded state works
  • Do not run it in the middle of other cheat skills such as cheat-bump or cheat-predict

What's inside

  • SKILL.md

Redistributed unmodified from XBuilderLAB/cheat-on-content under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.