using-bgs-papyrus
Use when the user wants to compile Papyrus PSC to PEX, decompile PEX to PSC, detect Creation Kit Papyrus toolchains, or inspect Papyrus capabilities for Skyrim, Fallout 4, or Starfield. Triggers - "compile PSC", "decompile PEX", "PapyrusCompiler", "bgs-papyrus", "Starfield Guard syntax".
Install / Use
npx skills add hashgraph-online/awesome-codex-plugins --skill using-bgs-papyrusInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
Tags
Our assessment of using-bgs-papyrus
using-bgs-papyrus scores 88/100 on our quality scale, 1564th of 2,790 Automation skills we index.
Its SKILL.md is 5.8 KB long, well organised into 10 sections with 9 code examples: a solid amount of guidance for an agent.
With 1,075 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so using-bgs-papyrus is actively maintained.
- Our last check on 2026-10-31 found the source still online.
- It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-07. Automated pattern scan on 2026-10-07. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
using-bgs-papyrus compared with similar skills
All 4 of these similar skills score higher than using-bgs-papyrus; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| using-bgs-papyrus (this skill)by hashgraph-online | 88 | 1.1k | 53d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.7k | 7d ago | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.6k | 2d ago | MCP Server |
Frequently asked questions
- How do I install using-bgs-papyrus?
- Run
npx skills add hashgraph-online/awesome-codex-plugins --skill using-bgs-papyrus. The install tabs above show the steps for each supported agent. - Which AI agents does using-bgs-papyrus work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is using-bgs-papyrus safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is using-bgs-papyrus still maintained?
- The repository was last updated about 2 months ago, so using-bgs-papyrus is actively maintained.
Skill content
View source on GitHubname: using-bgs-papyrus description: Use when the user wants to compile Papyrus PSC to PEX, decompile PEX to PSC, detect Creation Kit Papyrus toolchains, or inspect Papyrus capabilities for Skyrim, Fallout 4, or Starfield. Triggers - "compile PSC", "decompile PEX", "PapyrusCompiler", "bgs-papyrus", "Starfield Guard syntax".
Using bgs-papyrus
bgs-papyrus is the agent-native CLI for Papyrus compile and decompile work. It detects official Creation Kit compilers, compiles .psc to .pex, decompiles .pex to .psc through Champollion, and returns JSON envelopes for agent workflows.
Use this skill for:
- compiling Papyrus source to bytecode for Skyrim LE, Skyrim SE/AE, Fallout 4, or Starfield;
- decompiling Papyrus bytecode to source for inspection or patching;
- detecting whether the official Creation Kit compiler and Champollion are available;
- handling Starfield Guard syntax produced by Champollion.
Do not use this skill for plugin record edits, load-order edits, or BA2/BSA packing. Route those through the xEdit, load-order, or archive skills.
Prerequisites — detect first
Always query the live CLI before choosing a backend or game path:
bgs-papyrus capabilities --json
bgs-papyrus detect-toolchain --json --game starfield
The official Creation Kit must be installed by the user from Steam. Bethesda's PapyrusCompiler.exe is not bundled with this plugin and must not be copied into the repo or plugin tree. bgs-papyrus detects and drives the installed compiler.
Champollion is used for decompile. bgs-papyrus detects Champollion; it does not download it automatically. Install Champollion.exe at:
~/.bgs-modding-superpowers/tools/champollion/Champollion.exe
or the user can set BGS_PAPYRUS_CHAMPOLLION to an existing executable.
One PowerShell install shape for Champollion v1.3.2 from Orvid/Champollion releases:
$root = "$HOME\.bgs-modding-superpowers\tools\champollion"; New-Item -ItemType Directory -Force -Path $root | Out-Null; $zip = Join-Path $root "Champollion.v1.3.2.zip"; Invoke-WebRequest "https://github.com/Orvid/Champollion/releases/download/v1.3.2/Champollion.v1.3.2.zip" -OutFile $zip; Expand-Archive -Force $zip $root
Human manuals:
- English:
tools/bgs-papyrus/USER-GUIDE.en.md - Chinese:
tools/bgs-papyrus/USER-GUIDE.zh-cn.md
Hard rules
- Never write compiled
.pexoutput into the game'sDatafolder or any Stock-Game tree. - Game-ready compiled output belongs in an MO2 mod overlay:
<MO2_Root>/mods/<mod-name>/Scripts/. - Use
--jsonfor agent workflows and branch on the envelope, not human text. - Detect the toolchain before compile/decompile. Do not guess that a compiler path exists.
- Starfield compile should use the official CK compiler for Guard syntax. Caprica and russo are non-Guard fallbacks.
Commands
Check bgs-papyrus --help and <subcommand> --help for the current option surface. The examples below are templates.
capabilities
Discover supported games, subcommands, backends, flags files, and Starfield syntax behavior.
bgs-papyrus capabilities --json
detect-toolchain [--game G]
Find installed official CK compilers and the Champollion decompiler.
bgs-papyrus detect-toolchain --json --game fallout4
bgs-papyrus detect-toolchain --json
Supported game arguments are skyrimle, skyrimse, fallout4, and starfield. Fallout 3, Fallout: New Vegas, and Oblivion do not use Papyrus and are out of scope.
compile <src> --game G
Compile one .psc file, or use --all for a directory.
bgs-papyrus compile "D:\work\Scripts\Source\MyQuestScript.psc" --json --game starfield --out "D:\work\compiled" --import "D:\work\Scripts\Source"
Useful options:
--out <dir>: output directory.--import <dir>: source import directory; repeat for multiple roots.--backend ck|caprica|russo|auto: compiler backend.--flags <file>: explicit flags file.--optimize,--release,--final,--all: compile options.
For final game use, copy the resulting .pex into an MO2 overlay:
<MO2_Root>/mods/<mod-name>/Scripts/
Never write the result to <game>/Data/Scripts/ directly.
decompile <src> --game G
Decompile one .pex file, or use --recursive for a directory.
bgs-papyrus decompile "D:\mods\Example\Scripts\MyQuestScript.pex" --json --game starfield --out "D:\work\decompiled"
Useful options:
--out <dir>: output directory.--recursive: decompile a directory tree.--threaded: use Champollion threaded mode where supported.--sf-syntax-fix/--no-sf-syntax-fix: enable or disable Starfield syntax post-processing.
Starfield specifics
The official Starfield CK compiler handles Guard syntax natively. Champollion v1.3.2 guesses some Guard syntax in a form that the CK does not accept, so bgs-papyrus applies a validated Starfield syntax post-process during decompile:
Guard ... EndGuard -> LockGuard ... EndLockGuard
TryGuard ... EndGuard -> TryLockGuard ... EndTryLockGuard
This Guard rewrite was checked by recompiling the decompiled output through the real Starfield CK compiler.
Known limitation: Champollion v1.3.2 has unrelated decompile bugs, such as remote-event casts, that can stop complex vanilla scripts from recompiling cleanly. Treat decompiled output as a strong starting point and manually fix compiler-rejected constructs. The Guard post-processor is validated; this limitation is upstream Champollion.
Safe workflow pattern
- Run
bgs-papyrus capabilities --json. - Run
bgs-papyrus detect-toolchain --json --game <game>. - Compile or decompile with
--json. - For compile output, stage final
.pexfiles only under<MO2_Root>/mods/<mod-name>/Scripts/. - For decompile output intended for reuse, recompile it through the official CK compiler before claiming it is publishable.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Claude-Code-Game-Studios
39.7kTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
Scrapling
103.6k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
