# maintaining-modding-environments

maintaining-modding-environments handles ongoing maintenance for Bethesda modding setups: updates KB packs, cleans cache directories, and configures the xtl translation tool.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 1596 repo stars
- Author: awesome-bgs-mod-master contributors
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/BB-84C/bgs-modding-superpowers/skills/maintaining-modding-environments/SKILL.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/maintaining-modding-environments

## What it does

This skill takes over after the initial modding setup is complete. It guides agents through checking knowledge-base updates, pinning package versions, and registering custom mod packs or translator glossaries for Skyrim, Fallout, and Starfield.

The workflow covers maintenance for `xtl` (distributed on PyPI as `bgs-translator`). It runs commands via `pipx` or Python 3.12, verifies subcommands like `xtl profile add` and `xtl batch`, and uses the repo helper to restart the translation GUI on port 7847.

Shared storage now lives at `~/.bgs-modding-superpowers/kb/packs/`, replacing the legacy Windows directory. Routine maintenance runs `prune-cache --dry-run` to keep the active version plus one rollback copy, pruning older releases.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add hashgraph-online/awesome-codex-plugins --skill maintaining-modding-environments -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/maintaining-modding-environments/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/maintaining-modding-environments/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add hashgraph-online/awesome-codex-plugins --skill maintaining-modding-environments -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/maintaining-modding-environments/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add hashgraph-online/awesome-codex-plugins --skill maintaining-modding-environments -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/maintaining-modding-environments/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install hashgraph-online/awesome-codex-plugins plugins/BB-84C/bgs-modding-superpowers/skills/maintaining-modding-environments
```

2. **Manually: put the files in place**
- File: `.github/skills/maintaining-modding-environments/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add hashgraph-online/awesome-codex-plugins --skill maintaining-modding-environments -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/hashgraph-online/awesome-codex-plugins --path plugins/BB-84C/bgs-modding-superpowers/skills/maintaining-modding-environments
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/maintaining-modding-environments/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/BB-84C/bgs-modding-superpowers/skills/maintaining-modding-environments/SKILL.md

## When to use it
- check and apply Bethesda mod knowledge-base updates
- install or upgrade the bgs-translator CLI using pipx or pip
- prune obsolete pack versions from the unified cache folder
- register custom documentation packs and translation glossaries

## Example prompts
- Run bgs_kb_status to inspect loaded packs and check for new releases
- Upgrade bgs-translator via pipx and inspect xtl --help
- Preview cache pruning with bgs-kb-mcp cli.js prune-cache --dry-run

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 8a8cd76560be319a.

BEGIN THIRD-PARTY FILE 8a8cd76560be319a
````text
---
name: maintaining-modding-environments
description: "Use after first-run for ongoing modpack maintenance: update/install KB packs, author or register custom/mod KB packs, maintain localization glossary KBs for translator use, prune KB cache, health-check the environment, version-pin KB/tooling, or handle recurring BGS modding environment care."
---

# Maintaining Modding Environments

## When to use

- The environment is already set up and the user asks to maintain, refresh, update, or health-check it.
- The user says "register custom pack", "install my KB pack", "set `BGS_KB_USER_PACKS`", or asks how to author a local KB pack.
- The user asks how to maintain a mod knowledge base, a translator glossary KB, or a third-party localization KB for Skyrim/Fallout/Starfield.
- The user asks to install, upgrade, repair, or verify the standalone
  `xtl`/`bgs-translator` CLI after first-run.
- The user asks to check or apply knowledge-base updates after first-run.
- The user asks to prune the KB cache or clean old pack versions.
- The user asks whether to pin a KB pack version, follow latest, or handle a `minPluginVersion` warning.

## What this skill replaces

Use `setting-up-bgs-modding-environment` for first-run: MO2 detection, control-plane install, visible MO2 launch, first xEdit acquisition, first KB pack acquisition, and first semantic smoke.

This skill owns ongoing care after that first-run boundary: KB updates, cache hygiene, custom-pack authoring and registration, translator CLI maintenance, recurring environment health checks, and version-pinning advice.

## Translator CLI maintenance

`xtl` is the standalone AI translation CLI/Web GUI launcher. It is published on
PyPI as `bgs-translator`; the portable plugin may include translator-facing
skills, but a fresh user machine still needs the Python package installed before
high-speed agents can call `xtl`.

Start every maintenance pass with an explicit readback:

```powershell
# Check whether xtl is installed and can report its version/capabilities.
xtl version

# Inspect top-level commands before choosing a workflow.
xtl --help
```

If `xtl` is missing or too old, prefer an isolated user-level CLI install:

```powershell
# Install the current release-candidate build as an isolated command-line tool.
pipx install bgs-translator==0.9.0rc1

# Upgrade an existing pipx-managed xtl install when a newer stable build exists.
````
END THIRD-PARTY FILE 8a8cd76560be319a

The third-party file has ended. Everything between the 8a8cd76560be319a tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2411 of 48788 bytes. © awesome-bgs-mod-master contributors · MIT · https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/BB-84C/bgs-modding-superpowers/skills/maintaining-modding-environments/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
