A skill your agent uses 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…

Apache-2.0Auto-check passed

Install Using Bgs Papyrus

skills CLI
$ npx skills add hashgraph-online/awesome-codex-plugins --skill using-bgs-papyrus -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install hashgraph-online/awesome-codex-plugins using-bgs-papyrus --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/BB-84C/bgs-modding-superpowers/skills/using-bgs-papyrus .claude/skills/using-bgs-papyrus && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
using-bgs-papyrus
GitHub stars
1.2k
Token cost
~1.5k tokens
SKILL.md length
585 words
Files
1
Skills in repo
686
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses 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…

  • Works in 5 steps: Run bgs-papyrus capabilities --json. → Run bgs-papyrus detect-toolchain --json… → Compile or decompile with --json. → …
  • The user wants to compile Papyrus PSC to PEX
  • SKILL.md covers Prerequisites — detect first, Hard rules, Commands and Starfield specifics, plus 1 more section
  • Reaches github.com

What it does

Using Bgs Papyrus is an agent skill from hashgraph-online/awesome-codex-plugins. 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".

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: A curated list of awesome OpenAI Codex / ChatGPT plugins, skills, and resources. The 1 Codex Marketplace. See live plugins at: https://hol.org/plugins/best-codex-plugins. The licence is Apache-2.0.

When your agent uses it

  • The user wants to compile Papyrus PSC to PEX
  • Decompile PEX to PSC
  • Detect Creation Kit Papyrus toolchains
  • Inspect Papyrus capabilities for Skyrim

Example prompts

  • “compile PSC”
  • “decompile PEX”
  • “PapyrusCompiler”
  • “/using-bgs-papyrus”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Run bgs-papyrus capabilities --json.
  2. Run bgs-papyrus detect-toolchain --json --game .
  3. Compile or decompile with --json.
  4. For compile output, stage final .pex files only under /mods//Scripts/.
  5. For decompile output intended for reuse, recompile it through the official CK compiler before claiming it is publishable.

What it can do on your machine

Read from SKILL.md and the folder at commit 78497e5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are powershell).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Using Bgs Papyrus loads about 1.5k tokens when it runs. Until then it costs about 77 tokens; SKILL.md has 585 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~77
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from hashgraph-online/awesome-codex-plugins at commit 78497e5, republished under its Apache-2.0 licence (© hashgraph-online). 585 words, ~1,492 tokens.

Download SKILL.mdSave it as .claude/skills/using-bgs-papyrus/SKILL.md (or your agent's skills folder).
name
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:

powershell
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:

text
~/.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:

powershell
$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 .pex output into the game's Data folder or any Stock-Game tree.
  • Game-ready compiled output belongs in an MO2 mod overlay: <MO2_Root>/mods/<mod-name>/Scripts/.
  • Use --json for 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.

powershell
bgs-papyrus capabilities --json
detect-toolchain [--game G]

Find installed official CK compilers and the Champollion decompiler.

powershell
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.

Show full SKILL.md (250 more words)Show less
compile <src> --game G

Compile one .psc file, or use --all for a directory.

powershell
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:

text
<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.

powershell
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:

text
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

  1. Run bgs-papyrus capabilities --json.
  2. Run bgs-papyrus detect-toolchain --json --game <game>.
  3. Compile or decompile with --json.
  4. For compile output, stage final .pex files only under <MO2_Root>/mods/<mod-name>/Scripts/.
  5. For decompile output intended for reuse, recompile it through the official CK compiler before claiming it is publishable.

© hashgraph-online, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/BB-84C/bgs-modding-superpowers/skills/using-bgs-papyrus of hashgraph-online/awesome-codex-plugins.

Open the folder on GitHubat commit 78497e5

Compare with similar skills

Using Bgs Papyrus next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Using Bgs Papyrus compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Using Bgs Papyrus this skillhashgraph-online/awesome-codex-plugins1.2k—~1.5kAutomated safety check: PassApache-2.0
Compile Knowledgesickn33/agentic-awesome-skills47k1 repos~2.3kAutomated safety check: PassMIT
Compileratopile/atopile4k—~1kAutomated safety check: PassMIT
Paddle Design CompilerPaddlePaddle/Paddle24k—~3.6kAutomated safety check: PassApache-2.0
Compileccplugins/awesome-claude-code-plugins968—~1.3kAutomated safety check: NotesApache-2.0
Compile Latexbrycewang-stanford/Auto-Empirical-Research-Skills4.5k—~361Automated safety check: NotesCustom licence

Similar skills

  • Compile Knowledge

    sickn33/agentic-awesome-skills

    Compile durable, non-obvious findings into an interlinked markdown knowledge store — atomic files, [[wiki-links]], a maintained index — so an agent gets smarter across sessions instead of relearning…

    47k GitHub starsUsed in 1 repo~2.3k tokens
    Auto-check passed
  • Compiler

    atopile/atopile

    How the atopile compiler builds and links TypeGraphs from .ato (ANTLR front-end → AST → TypeGraph → Linker → DeferredExecutor), plus the key invariants and test entrypoints.

    4k GitHub stars~1k tokensUpdated 3 mo ago
    Frontend & DesignAuto-check passed
  • Paddle Design Compiler

    PaddlePaddle/Paddle

    A skill your agent uses when working with Paddle 3.0 compiler full pipeline: SOT (Symbolic Opcode Translator) for bytecode-level dy2st graph capture, PIR (Paddle IR) for SSA-based intermediate…

    24k GitHub stars~3.6k tokensUpdated 8 days ago
    AI & LLM EngineeringAuto-check passed
  • Compile

    ccplugins/awesome-claude-code-plugins

    Compile an Anthropic-style skill — a directory with a SKILL.md and optional references/ — into a deterministic, runnable workflow via the rote CLI.

    968 GitHub stars~1.3k tokensUpdated 1 mo ago
    Backend & APIsAuto-check: notes
  • Compile Latex

    brycewang-stanford/Auto-Empirical-Research-Skills

    Compile a LaTeX manuscript with pdflatex (3 passes + bibtex).

    4.5k GitHub stars~361 tokensUpdated 3 days ago
    Documents & OfficeAuto-check: notes
  • Compiler

    ARA-Labs/Agent-Native-Research-Artifact

    Universal ARA Compiler. An agent skill from ARA-Labs/Agent-Native-Research-Artifact.

    692 GitHub stars~6.4k tokensUpdated yesterday
    Documents & OfficeAuto-check passed

More from hashgraph-online/awesome-codex-plugins

All 686 skills in this repo
  • Anime Reaction Gif

    hashgraph-online/awesome-codex-plugins

    Create original anime-style reaction stickers as looping GIFs and MP4 previews, using generated character pose sheets and timed key poses.

    1.2k GitHub stars~922 tokensUpdated today
    Auto-check passed
  • Calibredb

    hashgraph-online/awesome-codex-plugins

    Manage and query Calibre libraries with the calibredb CLI (local paths or Calibre Content server URLs).

    1.2k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Rust API Test Harness

    hashgraph-online/awesome-codex-plugins

    A skill your agent uses when adding, changing, testing, or debugging Rust HTTP APIs and services, especially when Codex needs black-box integration tests, random-port app startup, real database test…

    1.2k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Art

    hashgraph-online/awesome-codex-plugins

    Make a studio's game look like something at build time — a cover from a real frame of the game (free), painted covers, backdrops, textures and character plates from image models through the…

    1.2k GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Game Balance Economy

    hashgraph-online/awesome-codex-plugins

    Balance game difficulty, resources, rewards, probability, progression, economies, and dominant strategies.

    1.2k GitHub stars~618 tokensUpdated today
    Auto-check passed
  • Manuscript Engagement Analytics

    hashgraph-online/awesome-codex-plugins

    Analyze nonfiction manuscripts for reader engagement signals, including heading-level word counts, slow starts, long slogs, weak takeaway titles, value pacing, beta-reader comment dropoff, and…

    1.2k GitHub stars~875 tokensUpdated today
    Auto-check passed

Questions about Using Bgs Papyrus

What does Using Bgs Papyrus do?

A skill your agent uses 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…. Using Bgs Papyrus is an agent skill from hashgraph-online/awesome-codex-plugins. 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.

When should I use Using Bgs Papyrus?

Using Bgs Papyrus fits situations like: the user wants to compile Papyrus PSC to PEX; decompile PEX to PSC; detect Creation Kit Papyrus toolchains; inspect Papyrus capabilities for Skyrim.

How do I install Using Bgs Papyrus in Claude Code?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill using-bgs-papyrus -a claude-code`. Or copy the skill folder (plugins/BB-84C/bgs-modding-superpowers/skills/using-bgs-papyrus in hashgraph-online/awesome-codex-plugins) into .claude/skills/using-bgs-papyrus in your project. Claude Code loads it when a task matches its description.

How do I install Using Bgs Papyrus in Codex?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill using-bgs-papyrus -a codex`. Or copy the skill folder (plugins/BB-84C/bgs-modding-superpowers/skills/using-bgs-papyrus in hashgraph-online/awesome-codex-plugins) into .agents/skills/using-bgs-papyrus in your project. Codex loads it when a task matches its description.

Can I use Using Bgs Papyrus in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hashgraph-online/awesome-codex-plugins --skill using-bgs-papyrus -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/using-bgs-papyrus, .gemini/skills/using-bgs-papyrus, .github/skills/using-bgs-papyrus and .opencode/skills/using-bgs-papyrus in your project.

What does Using Bgs Papyrus need to run?

SKILL.md names no scripts, command-line tools or credentials: Using Bgs Papyrus is instructions for the agent only.

Does Using Bgs Papyrus access the network?

SKILL.md names 1 domain. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Using Bgs Papyrus safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Using Bgs Papyrus use?

Using Bgs Papyrus is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Using Bgs Papyrus use?

About 1.5k tokens (SKILL.md is roughly 6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Using Bgs Papyrus?

Skills that share tags, products or a category with Using Bgs Papyrus: Compile Knowledge (sickn33/agentic-awesome-skills, 47k stars), Compiler (atopile/atopile, 4k stars), Paddle Design Compiler (PaddlePaddle/Paddle, 24k stars) and Compile (ccplugins/awesome-claude-code-plugins, 968 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Using Bgs Papyrus?

hashgraph-online (a GitHub organization) maintains it in hashgraph-online/awesome-codex-plugins, which has 1,242 GitHub stars. The repository holds 686 skills in this directory. The repository was last updated on October 8, 2026.

Source: hashgraph-online/awesome-codex-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.