Agent skill

Verify Version Alignment

by Luligu in Luligu/matterbridge

Verify that package, Docker build, test utility helper, docs update JSON files, and Docker workflow tags match the expected root version rules.

Apache-2.0Auto-check passedDevOps & Cloud

Install Verify Version Alignment

skills CLI
$ npx skills add Luligu/matterbridge --skill verify-version-alignment -a claude-code

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

GitHub CLI
$ gh skill install Luligu/matterbridge verify-version-alignment --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/Luligu/matterbridge.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/verify-version-alignment .claude/skills/verify-version-alignment && 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
verify-version-alignment
GitHub stars
983
Token cost
~1.7k tokens
SKILL.md length
573 words
Files
1
Skills in repo
6
Repo updated
First seen
Licence
Apache-2.0

At a glance

Verify that package, Docker build, test utility helper, docs update JSON files, and Docker workflow tags match the expected root version rules.

  • Tasks that involve Containers
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Verify Version Alignment is an agent skill from Luligu/matterbridge. Verify that package, Docker build, test utility helper, docs update JSON files, and Docker workflow tags match the expected root version rules. v.1.0.0

Its SKILL.md is about 1.7k 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 DevOps & Cloud, covering Containers. It works with Docker and npm. The repository describes itself as: Matterbridge plugin manager for Matter. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Containers

Example prompts

  • “/verify-version-alignment”

Requirements

  • Docker

What it can do on your machine

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

Verify Version Alignment loads about 1.7k tokens when it runs. Until then it costs about 44 tokens; SKILL.md has 573 words of instructions outside code blocks.

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

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 Luligu/matterbridge at commit 857fd9b, republished under its Apache-2.0 licence (© Luligu). 573 words, ~1,741 tokens.

Download SKILL.mdSave it as .claude/skills/verify-version-alignment/SKILL.md (or your agent's skills folder).
name
verify-version-alignment
description
Verify that package, Docker build, test utility helper, docs update JSON files, and Docker workflow tags match the expected root version rules. v.1.0.0

Verify that package, Docker build, test utility helper, docs update JSON files, and Docker workflow tags match the expected root version rules

Verify version alignment in this repository using package.json as the source of truth.

Execution rules:

  • Do not run repository scripts or automation scripts for this verification.
  • Perform the check manually by reading and comparing file contents directly.
  • After applying any fix, re-read the affected files from disk and report the final on-disk values.

Checks:

  • Read the root version from package.json.
  • Verify every real workspace package under packages has the same version as the root package version.
  • Ignore mock plugin manifests under packages/core/src/mock/** unless explicitly asked for them.
  • Verify all @matterbridge/* entries in the root package.json dependencies block are pinned to the root package version.
  • Verify all --build-arg CACHE_VERSION=x.y.z values in the root package.json scripts block match the root package version.
  • Verify .dockerbuild.json has a version field equal to the root package version.
  • Verify packages/jest-utils/src/jestMatterTest.ts sets getPlatformMatterbridge().matterbridgeVersion, getPlatformMatterbridge().matterbridgeLatestVersion and getPlatformMatterbridge().matterbridgeDevVersion to the root package version, and sets getPlatformMatterbridge().frontendVersion to the apps/frontend/package.json version.
  • Verify packages/vitest-utils/src/vitestMatterTest.ts sets getPlatformMatterbridge().matterbridgeVersion, getPlatformMatterbridge().matterbridgeLatestVersion and getPlatformMatterbridge().matterbridgeDevVersion to the root package version, and sets getPlatformMatterbridge().frontendVersion to the apps/frontend/package.json version.
  • Verify packages/test-utils/src/jest/matterTest.ts, packages/test-utils/src/vitest/matterTest.ts, and packages/test-utils/src/buntest/matterTest.ts set getPlatformMatterbridge().matterbridgeVersion, getPlatformMatterbridge().matterbridgeLatestVersion and getPlatformMatterbridge().matterbridgeDevVersion to the root package version, and set getPlatformMatterbridge().frontendVersion to the apps/frontend/package.json version.
  • Verify docs/main_update.json and docs/dev_update.json have latest equal to the root package version.
  • Verify docs/main_update.json and docs/dev_update.json have a dev value whose version prefix matches the root package version, preserving the existing -dev-... suffix format.
  • Verify the engines.node field in every real workspace package under packages is identical to the engines.node field in the root package.json.
  • Verify the Docker workflow release tags in docker-buildx-s6-rc.yml and docker-buildx-s6-rc-legacy.yml are coherent.
  • Verify the docker:run:hub:s6-rc:tag and docker:run:hub:s6-rc-legacy:tag scripts in package.json use the expected release tag and its -legacy suffix.
  • Treat the tag format as year.month.number, not a calendar day, for example 2026.4.3 and 2026.4.3-legacy.
  • Treat the tags as coherent only when the legacy tag is exactly the non-legacy tag plus the -legacy suffix.
  • If the arguments include a user-provided expected release tag, verify the non-legacy workflow tag matches that year.month.number value and verify the legacy workflow tag matches that same value plus the -legacy suffix.
Show full SKILL.md (209 more words)Show less

If explicitly asked to fix the alignment:

  • Update docs/main_update.json and docs/dev_update.json too.
  • Set each file's latest field to the root package version.
  • Update each file's dev field so its version prefix matches the root package version while preserving the existing -dev-... suffix.
  • Advance latestDate and devDate by 1 week from their current values, preserving the YYYY-MM-DD format.
  • Update docker:run:hub:s6-rc:tag in package.json to use the expected release tag.
  • Update docker:run:hub:s6-rc-legacy:tag in package.json to use the expected release tag with the -legacy suffix.

Output requirements:

  • Report the root package version first.
  • List every mismatch with the current value and expected value.
  • If everything matches, say that explicitly.
  • Use concise file references for every mismatch.
  • If the workflow release tags are not coherent, report both tag values and ask whether they should be aligned before making changes.
  • If the user provided an expected release tag and the workflow tags do not match it, report the expected year.month.number values and ask whether they should be updated.
  • Do not modify files unless explicitly asked to fix them.
  • If fixes were applied, include a post-fix verification section that confirms the updated values read from disk.

Suggested search targets:

© Luligu, 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 .agents/skills/verify-version-alignment of Luligu/matterbridge.

Open the folder on GitHubat commit 857fd9b

Compare with similar skills

Verify Version Alignment 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.

Verify Version Alignment compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Verify Version Alignment this skillLuligu/matterbridge983—~1.7kAutomated safety check: PassApache-2.0
Reflexo ReleaseMyriad-Dreamin/typst.ts1.2k—~1.5kAutomated safety check: PassApache-2.0
Os Eco Dep Syncjayminwest/warren473—~1.9kAutomated safety check: PassMIT
Ddevhaxtheweb/haxcms-php130—~1.6kAutomated safety check: PassApache-2.0
Data Processingaiskillstore/marketplace4301 repos~720Automated safety check: NotesMIT
Tokf Runmpecan/tokf199—~571Automated safety check: PassMIT

Similar skills

  • Reflexo Release

    Myriad-Dreamin/typst.ts

    Guide Reflexo/typst.ts release preparation and operator handoffs.

    1.2k GitHub stars~1.5k tokensUpdated 13 days ago
    DevOps & CloudAuto-check passed
  • Os Eco Dep Sync

    jayminwest/warren

    Bump warren onto the latest published @os-eco/ versions across package.json + bun.lock and the Dockerfile CLI pins, then run the gates and open a PR.

    473 GitHub stars~1.9k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Ddev

    haxtheweb/haxcms-php

    DDEV local development environment guidance for Docker-based PHP/Node projects.

    130 GitHub stars~1.6k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Data Processing

    aiskillstore/marketplace

    Process JSON with jq and YAML/TOML with yq. An agent skill from aiskillstore/marketplace.

    430 GitHub starsUsed in 1 repo~720 tokens
    DevOps & CloudAuto-check: notes
  • Tokf Run

    mpecan/tokf

    Compress verbose CLI output with tokf before returning results.

    199 GitHub stars~571 tokensUpdated 5 days ago
    DevOps & CloudAuto-check passed
  • Official

    A skill your agent uses when writing, reviewing, or optimizing Dockerfiles, even if the user just says their image is too large, their build is slow, or they need to harden a container for production.

    539 GitHub stars~3k tokensUpdated 3 days ago
    DevOps & CloudAuto-check: warnings

More from Luligu/matterbridge

  • Matterjs PR Workflow

    Luligu/matterbridge

    Sync the matter.js fork, implement and test a fix or a new feature/enhancement, format, lint, commit, push, and open a PR against matter-js/matter.js.

    983 GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed
  • Verify Agent Context

    Luligu/matterbridge

    Verify which coding agent is running and that it loaded the shared Matterbridge instructions, rules and skills from AGENTS.md and .agents/.

    983 GitHub stars~525 tokensUpdated yesterday
    Auto-check passed
  • Verify npm Alignment

    Luligu/matterbridge

    Verify that matterbridge and all Matterbridge workspace packages are aligned on the npm latest and dev tags.

    983 GitHub stars~839 tokensUpdated yesterday
    Auto-check passed
  • Verify server message endpoint context, endpoint type narrowing, plugin forwarding order, command observable emission, and Matter 1.6.0 comments on validation and state updates.

    983 GitHub stars~5.1k tokensUpdated yesterday
    Auto-check passed
  • Verify Agent Context

    Luligu/matterbridge

    Verify which coding agent is running and that it loaded the shared Matterbridge instructions, rules and skills from AGENTS.md and .agents/.

    983 GitHub stars~195 tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about Verify Version Alignment

What does Verify Version Alignment do?

Verify that package, Docker build, test utility helper, docs update JSON files, and Docker workflow tags match the expected root version rules. Verify Version Alignment is an agent skill from Luligu/matterbridge. Verify that package, Docker build, test utility helper, docs update JSON files, and Docker workflow tags match the expected root version rules.

When should I use Verify Version Alignment?

Verify Version Alignment fits situations like: tasks that involve Containers.

How do I install Verify Version Alignment in Claude Code?

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

How do I install Verify Version Alignment in Codex?

Run `npx skills add Luligu/matterbridge --skill verify-version-alignment -a codex`. Or copy the skill folder (.agents/skills/verify-version-alignment in Luligu/matterbridge) into .agents/skills/verify-version-alignment in your project. Codex loads it when a task matches its description.

Can I use Verify Version Alignment 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 Luligu/matterbridge --skill verify-version-alignment -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/verify-version-alignment, .gemini/skills/verify-version-alignment, .github/skills/verify-version-alignment and .opencode/skills/verify-version-alignment in your project.

What does Verify Version Alignment need to run?

SKILL.md names no scripts, command-line tools or credentials: Verify Version Alignment is instructions for the agent only. Our summary lists: Docker.

Does Verify Version Alignment 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 Verify Version Alignment 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 Verify Version Alignment use?

Verify Version Alignment 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 Verify Version Alignment use?

About 1.7k tokens (SKILL.md is roughly 7k 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 Verify Version Alignment?

Skills that share tags, products or a category with Verify Version Alignment: Reflexo Release (Myriad-Dreamin/typst.ts, 1.2k stars), Os Eco Dep Sync (jayminwest/warren, 473 stars), Ddev (haxtheweb/haxcms-php, 130 stars) and Data Processing (aiskillstore/marketplace, 430 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Verify Version Alignment?

Luligu (a GitHub user) maintains it in Luligu/matterbridge, which has 983 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on October 6, 2026.

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