Enforce VPK manifest updates whenever VPK files are created, moved, renamed, enabled, disabled, or deleted.

GPL-3.0Auto-check passedDevelopment

Install Vpk Manifest Hygiene

skills CLI
$ npx skills add deadlock-mod-manager/deadlock-mod-manager --skill vpk-manifest-hygiene -a claude-code

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

GitHub CLI
$ gh skill install deadlock-mod-manager/deadlock-mod-manager vpk-manifest-hygiene --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/deadlock-mod-manager/deadlock-mod-manager.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/vpk-manifest-hygiene .claude/skills/vpk-manifest-hygiene && 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
vpk-manifest-hygiene
GitHub stars
478
Token cost
~704 tokens
SKILL.md length
249 words
Files
1
Skills in repo
25
Repo updated
First seen
Licence
GPL-3.0

At a glance

Enforce VPK manifest updates whenever VPK files are created, moved, renamed, enabled, disabled, or deleted.

  • Modifying VPK-related Rust code
  • SKILL.md covers The Manifest, The Rule, Existing Patterns to Follow and Checklist for Code Review
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Touching vpkmanager

What it does

Vpk Manifest Hygiene is an agent skill from deadlock-mod-manager/deadlock-mod-manager. Enforce VPK manifest updates whenever VPK files are created, moved, renamed, enabled, disabled, or deleted. Use when modifying VPK-related Rust code, touching vpkmanager, manager.rs, mods.rs, profiles.rs, or any code that mutates the addons directory. Prevents state drift between on-disk VPKs and the .dmm.json manifest.

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

It sits in Development. It works with Rust. The repository describes itself as: A mod manager for the Valve game Deadlock. The licence is GPL-3.0.

When your agent uses it

  • Modifying VPK-related Rust code
  • Touching vpkmanager
  • Any code that mutates the addons directory

Example prompts

  • “/vpk-manifest-hygiene”

What it can do on your machine

Read from SKILL.md and the folder at commit cf1c98a. 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.

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

  • Network

    No URLs in SKILL.md.

    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

Vpk Manifest Hygiene loads about 704 tokens when it runs. Until then it costs about 86 tokens; SKILL.md has 249 words of instructions outside code blocks.

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

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 deadlock-mod-manager/deadlock-mod-manager at commit cf1c98a, republished under its GPL-3.0 licence (© deadlock-mod-manager). 249 words, ~704 tokens.

Download SKILL.mdSave it as .claude/skills/vpk-manifest-hygiene/SKILL.md (or your agent's skills folder).
name
vpk-manifest-hygiene
description
Enforce VPK manifest updates whenever VPK files are created, moved, renamed, enabled, disabled, or deleted. Use when modifying VPK-related Rust code, touching vpk_manager, manager.rs, mods.rs, profiles.rs, or any code that mutates the addons directory. Prevents state drift between on-disk VPKs and the .dmm.json manifest.
disable-model-invocation
true

VPK Manifest Hygiene

Every mutation to VPK files on disk must be followed by a corresponding update to the ProfileVpkManifest (.dmm.json). Skipping this causes state drift: the manifest no longer reflects reality, leading to ghost mods, missing mods, and broken enable/disable cycles.

The Manifest

  • File: .dmm.json inside the profile's addons directory
  • Struct: ProfileVpkManifest in apps/desktop/src-tauri/src/mod_manager/vpk_manifest.rs
  • Tracks per-mod: enabled, current_vpks, disabled_vpks, original_vpk_names, order

The Rule

If you touch VPKs on disk, you must update and save the manifest in the same operation.

Concretely, any code path that does one of the following must call the corresponding manifest method and then manifest.save():

Disk operationManifest call
Install / enable VPKsmanifest.mark_enabled(mod_id, current_vpks, original_vpk_names, order)
Disable VPKs (prefix-rename)manifest.mark_disabled(mod_id, disabled_vpks, original_vpk_names)
Uninstall / delete VPKsmanifest.remove_mod(mod_id)
Reorder VPKsUpdate order via mark_enabled for affected mods
Replace / swap VPK filesmark_enabled or mark_disabled depending on final state

Existing Patterns to Follow

Look at the current call sites for reference:

  • manager.rs — enable_mod, disable_mod, uninstall_mod, reorder_mods, replace_vpk_files
  • mods.rs — persist_analyzed_mod, swap_mod_options, switch_download_variant
  • profiles.rs — import_profile

Every one of these loads the manifest, mutates it, and saves it atomically (write-to-tmp then rename). Follow the same pattern.

Checklist for Code Review

When reviewing or writing code that touches VPK files:

  • Manifest is loaded before disk mutations begin
  • Every disk mutation has a matching manifest update
  • manifest.save() is called after all mutations complete
  • Error paths do not leave the manifest out of sync (save before early returns if partial work was done)
  • No new VPK disk operations were added without manifest calls

© deadlock-mod-manager, GPL-3.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 .agents/skills/vpk-manifest-hygiene of deadlock-mod-manager/deadlock-mod-manager.

Open the folder on GitHubat commit cf1c98a

Compare with similar skills

Vpk Manifest Hygiene 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.

Vpk Manifest Hygiene compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Vpk Manifest Hygiene this skilldeadlock-mod-manager/deadlock-mod-manager478—~704Automated safety check: PassGPL-3.0
Migrate Core Code to Submodulestinyhumansai/openhuman42k—~2.6kAutomated safety check: PassGPL-3.0
OpenLogi macOS Permissions TriageAprilNEA/OpenLogi23k—~2.5kAutomated safety check: NotesApache-2.0
Rust Best Practicesfarm-fe/farm5.6k3 repos~1.1kAutomated safety check: PassMIT
RTK Rust Design Patternsrtk-ai/rtk83k—~1.9kAutomated safety check: PassApache-2.0
Release Skillsnexmoe/eve4213 repos~3.3kAutomated safety check: PassNone

Similar skills

  • Migrate Core Code to Submodules

    tinyhumansai/openhuman

    Plans and carries out moving non-host-specific code and its tests from the OpenHuman core into vendored tiny submodule libraries, then releases the submodule and re-pins the host.

    42k GitHub stars~2.6k tokensUpdated today
    DevelopmentAuto-check passed
  • Decides whether an OpenLogi device problem on macOS is a privacy-permission (TCC) problem, using agent log lines, and says which identity needs which grant.

    23k GitHub stars~2.5k tokensUpdated today
    DevelopmentAuto-check: notes
  • Guide for writing idiomatic Rust code based on Apollo GraphQL's best practices handbook.

    5.6k GitHub starsUsed in 3 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Describes seven Rust design patterns for the RTK CLI filter modules, with when to use each, RTK examples, and notes on when a pattern is overkill.

    83k GitHub stars~1.9k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Release Skills

    nexmoe/eve

    Universal release workflow. An agent skill from nexmoe/eve.

    421 GitHub starsUsed in 3 repos~3.3k tokens
    DevelopmentAuto-check passed
  • Pnpm Engine

    teambit/bit

    Work on the pnpm Rust engine (@pnpm/napi, the pacquet crates) that bit install runs through.

    18k GitHub stars~1.9k tokensUpdated today
    DevelopmentAuto-check passed

More from deadlock-mod-manager/deadlock-mod-manager

All 25 skills in this repo
  • Skill Creator

    deadlock-mod-manager/deadlock-mod-manager

    Create new agent skills following the Agent Skills specification.

    478 GitHub starsUsed in 1 repo~2.9k tokens
    Auto-check passed
  • Create Auth Skill

    deadlock-mod-manager/deadlock-mod-manager

    Scaffold and implement authentication in TypeScript/JavaScript apps using Better Auth.

    478 GitHub starsUsed in 4 repos~3.4k tokens
    Auto-check passed
  • Opensrc

    deadlock-mod-manager/deadlock-mod-manager

    Fetch source code for npm, PyPI, or crates.io packages and GitHub/GitLab repos to provide AI agents with implementation context beyond types and docs.

    478 GitHub stars~910 tokensUpdated yesterday
    Auto-check passed
  • Security Review

    deadlock-mod-manager/deadlock-mod-manager

    Security code review for Tauri/Rust/TypeScript desktop apps and Hono/oRPC APIs.

    478 GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed
  • Babysit

    deadlock-mod-manager/deadlock-mod-manager

    Stay on one pull request until it is merge-ready, fixing the highest-priority blocker and telling the user when it is green.

    478 GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed
  • Changeset

    deadlock-mod-manager/deadlock-mod-manager

    Generate a changeset file describing the current PR's changes.

    478 GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about Vpk Manifest Hygiene

What does Vpk Manifest Hygiene do?

Enforce VPK manifest updates whenever VPK files are created, moved, renamed, enabled, disabled, or deleted. Vpk Manifest Hygiene is an agent skill from deadlock-mod-manager/deadlock-mod-manager. Enforce VPK manifest updates whenever VPK files are created, moved, renamed, enabled, disabled, or deleted.

When should I use Vpk Manifest Hygiene?

Vpk Manifest Hygiene fits situations like: modifying VPK-related Rust code; touching vpkmanager; any code that mutates the addons directory.

How do I install Vpk Manifest Hygiene in Claude Code?

Run `npx skills add deadlock-mod-manager/deadlock-mod-manager --skill vpk-manifest-hygiene -a claude-code`. Or copy the skill folder (.agents/skills/vpk-manifest-hygiene in deadlock-mod-manager/deadlock-mod-manager) into .claude/skills/vpk-manifest-hygiene in your project. Claude Code loads it when a task matches its description.

How do I install Vpk Manifest Hygiene in Codex?

Run `npx skills add deadlock-mod-manager/deadlock-mod-manager --skill vpk-manifest-hygiene -a codex`. Or copy the skill folder (.agents/skills/vpk-manifest-hygiene in deadlock-mod-manager/deadlock-mod-manager) into .agents/skills/vpk-manifest-hygiene in your project. Codex loads it when a task matches its description.

Can I use Vpk Manifest Hygiene 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 deadlock-mod-manager/deadlock-mod-manager --skill vpk-manifest-hygiene -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/vpk-manifest-hygiene, .gemini/skills/vpk-manifest-hygiene, .github/skills/vpk-manifest-hygiene and .opencode/skills/vpk-manifest-hygiene in your project.

What does Vpk Manifest Hygiene need to run?

SKILL.md names no scripts, command-line tools or credentials: Vpk Manifest Hygiene is instructions for the agent only.

Does Vpk Manifest Hygiene access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Vpk Manifest Hygiene 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 Vpk Manifest Hygiene use?

Vpk Manifest Hygiene is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Vpk Manifest Hygiene use?

About 704 tokens (SKILL.md is roughly 2.8k 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 Vpk Manifest Hygiene?

Skills that share tags, products or a category with Vpk Manifest Hygiene: Migrate Core Code to Submodules (tinyhumansai/openhuman, 42k stars), OpenLogi macOS Permissions Triage (AprilNEA/OpenLogi, 23k stars), Rust Best Practices (farm-fe/farm, 5.6k stars) and RTK Rust Design Patterns (rtk-ai/rtk, 83k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Vpk Manifest Hygiene?

deadlock-mod-manager (a GitHub organization) maintains it in deadlock-mod-manager/deadlock-mod-manager, which has 478 GitHub stars. The repository holds 25 skills in this directory. The repository was last updated on October 10, 2026.

Source: deadlock-mod-manager/deadlock-mod-manager on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.