Agent skill

Compare Version Modules

by opanel-mc in opanel-mc/opanel

Compare two server-platform adaptation modules of the same platform but different Minecraft/game versions (e.g.

GPL-3.0Auto-check passed

Install Compare Version Modules

skills CLI
$ npx skills add opanel-mc/opanel --skill compare-version-modules -a claude-code

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

GitHub CLI
$ gh skill install opanel-mc/opanel compare-version-modules --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/opanel-mc/opanel.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/compare-version-modules .claude/skills/compare-version-modules && 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
compare-version-modules
GitHub stars
305
Token cost
~823 tokens
SKILL.md length
341 words
Files
2 (incl. scripts)
Skills in repo
2
Repo updated
First seen
Licence
GPL-3.0

At a glance

Compare two server-platform adaptation modules of the same platform but different Minecraft/game versions (e.g.

  • Works in 5 steps: Run scripts/compare.sh / / from the repo… → Read the diff. Each ===== ===== block is… → Group the findings for the user, e.g. → …
  • The user asks to 对比/比较/diff two version modules
  • SKILL.md covers Quick start, Convention it relies on, Workflow and Notes
  • Runs Shell scripts from its folder; calls bash

What it does

Compare Version Modules is an agent skill from opanel-mc/opanel. Compare two server-platform adaptation modules of the same platform but different Minecraft/game versions (e.g. forge-1.21.5 vs forge-1.21.8), surfacing only the real API / 写法 differences by normalizing away package-name and version-string noise. Use when the user asks to 对比/比较/diff two version modules, find what changed between two <platform-<version directories (forge/neoforge/fabric/spigot/folia), or understand how to port an adaptation from one game version to the next.

Its SKILL.md is about 820 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/compare.sh`).

The repository describes itself as: A Minecraft server management panel for Paper / Folia / Leaves / Fabric / Forge / NeoForge / Pumpkin servers. The licence is GPL-3.0.

When your agent uses it

  • The user asks to 对比/比较/diff two version modules
  • Find what changed between two <platform-<version directories (forge/neoforge/fabric/spigot/folia)
  • Understand how to port an adaptation from one game version to the next

Example prompts

  • “/compare-version-modules”

Requirements

  • A Bash shell

Workflow steps

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

  1. Run scripts/compare.sh / / from the repo root.
  2. Read the diff. Each ===== ===== block is one changed file.
  3. Group the findings for the user, e.g.
  4. Note knock-on changes: a constructor signature change in one file usually
  5. Skip files reported only as version-string/package differences; the script

What it can do on your machine

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

    Ships 1 file in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • bash

    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

Compare Version Modules loads about 823 tokens when it runs. Until then it costs about 127 tokens; SKILL.md has 341 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from opanel-mc/opanel at commit 3a61e1a, republished under its GPL-3.0 licence (© opanel-mc). 341 words, ~823 tokens.

Download SKILL.mdSave it as .claude/skills/compare-version-modules/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
compare-version-modules
description
Compare two server-platform adaptation modules of the same platform but different Minecraft/game versions (e.g. forge-1.21.5 vs forge-1.21.8), surfacing only the real API / 写法 differences by normalizing away package-name and version-string noise. Use when the user asks to 对比/比较/diff two version modules, find what changed between two `<platform>-<version>` directories (forge/neoforge/fabric/spigot/folia), or understand how to port an adaptation from one game version to the next.
metadata.internal
true

Compare version modules

Adaptation modules for different game versions of the same platform do the same job with slightly different code. This skill isolates the meaningful deltas (API renames, signature changes, new imports, build-config bumps) from the mechanical noise (package names and version numbers that differ in every file).

Quick start

Run the bundled script with the two module directory paths. Modules now live under their platform folder (fabric/, forge/, neoforge/, bukkit/), so pass the platform-prefixed path:

bash
bash <skill-dir>/scripts/compare.sh forge/forge-1.21.5 forge/forge-1.21.8

(The script derives the package token from the directory's basename, so the platform-folder prefix does not affect normalization.)

It pairs files across the two modules, normalizes each module's package token, directory name, and version string into shared placeholders, then prints a per-file diff plus a summary line. Files that are identical after normalization are omitted; files present in only one module are flagged ONLY IN ....

Convention it relies on

Directory <platform>/<platform>-<version> ↔ java package net.opanel.<platform>_<ver>, where the package token is the module directory's basename with - and . turned into _:

  • forge-1.21.5 → forge_1_21_5
  • spigot-1.16.1 → spigot_1_16_1
  • neoforge-1.21.3 → neoforge_1_21_3

This holds for forge / neoforge / fabric / spigot / folia in this repo.

Workflow

  1. Run scripts/compare.sh <platform>/<older> <platform>/<newer> from the repo root.
  2. Read the diff. Each ===== <path> ===== block is one changed file.
  3. Group the findings for the user, e.g.:
    • Build config — gradle.properties (version range, loader version), build.gradle (new repos/deps), pack.mcmeta (pack_format).
    • API changes — renamed/moved imports, changed method signatures, replaced types (e.g. GameProfile → NameAndId).
    • New behavior — added listeners, fields, null guards, newly-implemented interfaces.
  4. Note knock-on changes: a constructor signature change in one file usually forces edits at every call site — call those out together.
  5. Skip files reported only as version-string/package differences; the script already removed those, so anything left is a genuine difference worth reporting.

Notes

  • The right bound of minecraft_version_range (the next version) is a real difference, not noise, so it is intentionally shown.
  • If a module pair lives outside the repo root, pass full/relative paths: compare.sh path/to/forge-1.21.8 path/to/forge-1.21.9 (any path works; only the basename matters).
  • The script reads files only; it never edits. Safe to run anytime.

© opanel-mc, 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

SKILL.md and 1 other file (scripts) in .agents/skills/compare-version-modules of opanel-mc/opanel.

  • SKILL.md
  • scripts/compare.sh

Open the folder on GitHubat commit 3a61e1a

Compare with similar skills

Compare Version Modules 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.

Compare Version Modules compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Compare Version Modules this skillopanel-mc/opanel305—~823Automated safety check: PassGPL-3.0
Agent Adaptive Coordinatorruvnet/ruflo74k2 repos~4kAutomated safety check: PassMIT
Es Modulesthedaviddias/Front-End-Checklist74k—~482Automated safety check: PassMIT
Create Agent Adapterpaperclipai/paperclip99k—~8kAutomated safety check: PassMIT
Splitting Oversized ModulesPostHog/posthog40k—~2.2kAutomated safety check: PassCustom licence
Abp Moduleabpframework/abp14k—~1.6kAutomated safety check: PassLGPL-3.0

Similar skills

  • Agent skill for adaptive-coordinator - invoke with $agent-adaptive-coordinator

    74k GitHub starsUsed in 2 repos~4k tokens
    Data & AnalyticsAuto-check passed
  • Es Modules

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing scripts, client components, bundles, or runtime behavior related to Use ES modules (import/export).

    74k GitHub stars~482 tokensUpdated 4 days ago
    Auto-check passed
  • Create Agent Adapter

    paperclipai/paperclip

    Create or modify Paperclip agent adapters across server, UI, and CLI surfaces.

    99k GitHub stars~8k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Official

    Split an oversized Python module (a thousand-plus-line logic.py, models.py, api.py, or its test file) into a package of one module per concern, mechanically and provably without changing behavior.

    40k GitHub stars~2.2k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Abp Module

    abpframework/abp

    ABP reusable Module solution template - EF Core + MongoDB dual support, virtual methods for extensibility, DbTablePrefix, module options pattern, entity extension, separate connection string.

    14k GitHub stars~1.6k tokensUpdated today
    DatabasesAuto-check passed
  • Extract Module

    JetBrains/intellij-community

    Official

    Extract optional plugin dependencies into IntelliJ content modules.

    21k GitHub stars~5.2k tokensUpdated today
    MobileAuto-check passed

More from opanel-mc/opanel

  • Opanel Extension Dev

    opanel-mc/opanel

    指导 OPanel 扩展的创建、实现、审查、调试与兼容性迁移。Use when a task mentions OPanel extension development, extension.json, @Extension lifecycle methods, OPanelAPI, extension backend routes, extension sidebar page…

    305 GitHub stars~1.9k tokensUpdated today
    Auto-check passed

Questions about Compare Version Modules

What does Compare Version Modules do?

Compare two server-platform adaptation modules of the same platform but different Minecraft/game versions (e.g. Compare Version Modules is an agent skill from opanel-mc/opanel.g.

When should I use Compare Version Modules?

Compare Version Modules fits situations like: the user asks to 对比/比较/diff two version modules; find what changed between two <platform-<version directories (forge/neoforge/fabric/spigot/folia); understand how to port an adaptation from one game version to the next.

How do I install Compare Version Modules in Claude Code?

Run `npx skills add opanel-mc/opanel --skill compare-version-modules -a claude-code`. Or copy the skill folder (.agents/skills/compare-version-modules in opanel-mc/opanel) into .claude/skills/compare-version-modules in your project. Claude Code loads it when a task matches its description.

How do I install Compare Version Modules in Codex?

Run `npx skills add opanel-mc/opanel --skill compare-version-modules -a codex`. Or copy the skill folder (.agents/skills/compare-version-modules in opanel-mc/opanel) into .agents/skills/compare-version-modules in your project. Codex loads it when a task matches its description.

Can I use Compare Version Modules 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 opanel-mc/opanel --skill compare-version-modules -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/compare-version-modules, .gemini/skills/compare-version-modules, .github/skills/compare-version-modules and .opencode/skills/compare-version-modules in your project.

What does Compare Version Modules need to run?

Going by SKILL.md and its folder, Compare Version Modules needs a shell for the scripts in its folder and the command-line tools its instructions call (bash). Our summary lists: A Bash shell.

Does Compare Version Modules 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 Compare Version Modules 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Compare Version Modules use?

Compare Version Modules 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 Compare Version Modules use?

About 823 tokens (SKILL.md is roughly 3.3k 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 Compare Version Modules?

Skills that share tags, products or a category with Compare Version Modules: Agent Adaptive Coordinator (ruvnet/ruflo, 74k stars), Es Modules (thedaviddias/Front-End-Checklist, 74k stars), Create Agent Adapter (paperclipai/paperclip, 99k stars) and Splitting Oversized Modules (PostHog/posthog, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Compare Version Modules?

opanel-mc (a GitHub organization) maintains it in opanel-mc/opanel, which has 305 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 10, 2026.

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