// Read and scan Skyrim save files (.ess). Use when debugging save issues, searching for orphaned scripts, checking mod footprint in saves, or investigating save bloat.
Guided workflow for creating a new Skyrim mod from scratch using AutoMod CLI. Use when the user wants to build a new mod.
Process Skyrim voice and sound files (FUZ, XWM, WAV) using AutoMod CLI.
Read, extract, create, and modify BSA/BA2 archives using AutoMod CLI.
Generate SkyUI Mod Configuration Menus using AutoMod CLI.
Inspect and modify NIF mesh files using AutoMod CLI. Use when working with meshes, textures, skeleton nodes, or fixing VR mesh issues.
Inspect an ESP/ESM plugin file and show a summary of all records
| name | skyrim-save |
| description | Read and scan Skyrim save files (.ess). Use when debugging save issues, searching for orphaned scripts, checking mod footprint in saves, or investigating save bloat. |
| paths | **/*.ess |
Use scripts/read-save.py to decompress and scan Skyrim save files. Requires Python with lz4 package (pip install lz4). All output is JSON.
Get save info (player name, level, location, plugin count):
python scripts/read-save.py info "<path-to-save.ess>"
List all plugins in the save:
python scripts/read-save.py plugins "<path-to-save.ess>"
Search for a string (script names, EditorIDs, variable names):
python scripts/read-save.py search "<save.ess>" --string "MyModScriptName"
Search for a FormID (as hex, little-endian uint32):
python scripts/read-save.py search "<save.ess>" --formid 0x0001ABCD
Search for a raw hex byte pattern:
python scripts/read-save.py search "<save.ess>" --hex "DEADBEEF"
decompressedSize across saves to detect growth over time.SSE/VR saves use LZ4 compression. General layout of the decompressed data: