skyrim-papyrus
Compile, decompile, validate, and generate Papyrus scripts. Use when the user wants to write scripts, understand script behavior, fix script errors, or generate script templates for quests, actors, or magic effects.
Security Assessment
About skyrim-papyrus
The skyrim-papyrus skill is designed for working with Papyrus scripts used in Skyrim modding. It allows users to compile, decompile, validate, and generate Papyrus scripts efficiently. This tool solves the problem of managing and automating various Papyrus scripting tasks, which are essential for mod development, such as writing and debugging scripts, creating templates, and ensuring that scripts are properly structured and free of syntax errors. By integrating Spooky's AutoMod Toolkit, this skill automates many complex steps in Skyrim modding, simplifying the process for both beginner and experienced modders.
This skill offers multiple features aimed at streamlining the workflow of Papyrus scripting. It includes the ability to compile .psc files into .pex files, decompile .pex files into .psc for editing, validate the syntax of Papyrus scripts, and generate script templates for quests, actors, or magic effects. The toolkit uses the modern papyrus-compiler from russo-2025, ensuring fast and reliable compilation. It also supports auto-downloading necessary tools and integrating with Creation Kit for automatic header setup. The decompiler, Champollion, is included for converting compiled .pex files back into editable .psc scripts, making this toolset versatile for both creating and modifying mods.
This skill is primarily useful for mod developers working with Skyrim, particularly those who need to automate script compilation, decompilation, or template generation. It is ideal for users looking to streamline their mod development workflow, fix script errors, or generate standardized script templates quickly. Additionally, the skill is helpful for those who need to validate their scripts for correctness or decompile existing scripts to inspect or modify their content.
FAQ
How do I set up the Skyrim Papyrus headers?
You can automatically set up the Skyrim SE or VR installation and link the headers by running `dotnet run --project src/SpookysAutomod.Cli -- papyrus setup-headers --json`. Alternatively, you can specify the path manually with the `--skyrim-path` option.
What is the purpose of the 'papyrus-compiler' tool?
The 'papyrus-compiler' is used to compile .psc (Papyrus Script) files into .pex (Papyrus Executable) files. It is a modern, faster tool that replaces Bethesda's original PapyrusCompiler.exe.
Are there any additional tools required to use this skill?
The necessary tools, such as the 'papyrus-compiler' for compilation and 'Champollion' for decompilation, are automatically downloaded upon first use. No manual installation is required.
Can I use this skill for Skyrim VR?
Yes, this skill supports both Skyrim SE (Special Edition) and Skyrim VR. You can set the headers specifically for Skyrim VR using the appropriate path in the setup command.
What happens if I don’t have the Papyrus script headers?
If the Papyrus script headers are missing, script compilation will fail with 'invalid type' errors. It is recommended to run the 'setup-headers' command to ensure headers are correctly linked.
Install skyrim-papyrus
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
SpookyPirate/spookys-automod-toolkit