Przejdź do treści
Biblioteka skilli
Programowanie · Automatyzacja

plugin-version

/plugin-version

Podbija wersje wtyczek w monorepo OpenSaaS Stack po każdej zmianie w Codex-plugins lub .Codex-plugin, bezpośrednio w plugin.json i marketplace.json, przed commitem.

Repozytorium
stack ↗
Licencja
MIT
Ostatnia zmiana repozytorium
26.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Podbija wersje wtyczek w monorepo OpenSaaS Stack po każdej zmianie w Codex-plugins lub .Codex-plugin, bezpośrednio w plugin.json i marketplace.json, przed commitem.

Oryginalny opis (EN)

Bump plugin versions in the OpenSaaS Stack monorepo. Invoke whenever any file under Codex-plugins/* or .Codex-plugin/ is modified — skills, commands, agents, or marketplace config. Plugin versions must be bumped before committing so users who install the plugin get the updated version. Note: this is separate from pr-changeset, which handles npm packages — plugin versions are managed directly in plugin.json and marketplace.json.

Jak działa

  1. Files This Skill Manages
  2. Versioning Rules
  3. Instructions
  4. Examples
  5. Common Mistakes to Avoid
  6. Workflow
  7. Troubleshooting
  8. Important Notes
Sekcje z nagłówków SKILL.md, w oryginale · 254 linii, 1 277 słów
Podgląd SKILL.md
---
name: plugin-version
description: Bump plugin versions in the OpenSaaS Stack monorepo. Invoke whenever any file under Codex-plugins/* or .Codex-plugin/ is modified — skills, commands, agents, or marketplace config. Plugin versions must be bumped before committing so users who install the plugin get the updated version. Note: this is separate from pr-changeset, which handles npm packages — plugin versions are managed directly in plugin.json and marketplace.json.
allowed-tools: Read, Edit, Bash, Grep, Glob
---

# Plugin Version Skill

This skill bumps version numbers for Codex plugins and the marketplace manifest. Plugin versions live directly in JSON files (not changesets) — bumping them is what signals to the marketplace that something changed and triggers users to get the update.

## Files This Skill Manages

| Changed directory                    | Files to update                                                                                                                                             |
| ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Codex-plugins/opensaas-stack/`     | `Codex-plugins/opensaas-stack/.Codex-plugin/plugin.json` (version) AND `.Codex-plugin/marketplace.json` (plugins[name="opensaas-stack"].version)         |
| `Codex-plugins/opensaas-migration/` | `Codex-plugins/opensaas-migration/.Codex-plugin/plugin.json` (version) AND `.Codex-plugin/marketplace.json` (plugins[name="opensaas-migration"].version) |
| `.Codex-plugin/` root files only    | `.Codex-plugin/marketplace.json` (metadata.version only)                                                                                                   |

## Versioning Rules

### Patch (bug fixes only)

- **Use for**: Bug fixes, typo corrections, documentation fixes, minor wording improvements in skill descriptions
- **Bump**: `x.y.Z` → `x.y.Z+1`
- **Description**: Maximum 2 lines

### Minor (features or enhancements)

- **Use for**: New skills, new commands, new agents, new MCP tools, enhancements to existing capabilities
- **Bump**: `x.Y.z` → `x.Y+1.0` (reset patch to 0)
- **Description**: Describe the new capability

### Major (breaking changes)

- **Use for**: Removed skills/commands/tools, changed invocation patterns, incompatible changes
- **ONLY when explicitly requested by the user**
- **Bump**: `X.y.z` → `X+1.0.0` (reset minor and patch to 0)

## Instructions

### Step 1: Identify Changed Plugin Directories

Run git commands to detect which plugin areas changed:

```bash
git diff --name-only HEAD
# or for staged changes:
git diff --name-only --cached
# or for all changes relative to main:
git diff --name-only origin/main...HEAD
```

Look for paths starting with:

- `Codex-plugins/opensaas-stack/` → opensaas-stack plugin changed
- `Codex-plugins/opensaas-migration/` → opensaas-migration plugin changed
- `.Codex-plugin/` → marketplace root changed (check if any file other than version fields changed)

### Step 2: Determine Version Bump Type

For each changed plugin:

- **Is this a bug fix or correction?** → Use `patch`
- **Is this a new skill, command, agent, or capability?** → Use `minor`
- **Does this remove or rename something users depend on?** → Use `major` only if user explicitly requested it; otherwise ask

### Step 3: Read Current Versions

For each affected plugin, read the current version:

```
Read: Codex-plugins/<plugin-name>/.Codex-plugin/plugin.json
```

The version is in the top-level `"version"` field.

For the marketplace:

```
Read: .Codex-plugin/marketplace.json
```

The marketplace metadata version is at `metadata.version`. Each plugin's marketplace entry version is at `plugins[i].version` where `plugins[i].name` matches the plugin name.

### Step 4: Calculate New Version

Given the current version string `"x.y.z"`:

- **patch**: increment z → `"x.y.(z+1)"`
  - `"0.2.0"` → `"0.2.1"`
  - `"1.3.4"` → `"1.3.5"`
- **minor**: increment y, reset z to 0 → `"x.(y+1).0"`
  - `"0.2.0"` → `"0.3.0"`
  - `"1.3.4"` → `"1.4.0"`
- **major**: increment x, reset y and z to 0 → `"(x+1).0.0"`
  - `"0.2.0"` → `"1.0.0"`
  - `"1.3.4"` → `"2.0.0"`

### Step 5: Edit the JSON Files

For each changed plugin, make two targeted edits using the Edit tool.

**Edit 1 — The plugin's own plugin.json:**

Find the `"version"` field near the top of the file and replace just that value.

Example in `Codex-plugins/opensaas-stack/.Codex-plugin/plugin.json`:

```
"version": "0.2.0",
```

→

```
"version": "0.2.1",
```

**Edit 2 — The matching entry in marketplace.json:**

The `plugins` array in `.Codex-plugin/marketplace.json` has one object per plugin. Find the object where `"name"` matches the plugin name and edit its `"version"` field.

Example: find the block for `"name": "opensaas-stack"` and edit:

```
      "version": "0.2.0",
```

→

```
      "version": "0.2.1",
```

**Edit 3 (conditional) — Marketplace metadata.version:**

Only bump `metadata.version` if files in the `.Codex-plugin/` root directory were directly changed (e.g., `MARKETPLACE.md`, new fields added to `marketplace.json` structure, owner/metadata fields edited). Do NOT bump it just because plugin versions changed.

### Step 6: Verify the Edits

After editing, read back the affected files to confirm:

- The version field shows the new version
- No other fields were accidentally changed
- Both plugin.json and the matching marketplace.json entry show the same new version number

## Examples

### Example 1: Patch — Fix a typo in a skill description

Changed files: `Codex-plugins/opensaas-stack/skills/some-skill/SKILL.md`

Current version: `"0.2.0"` → New version: `"0.2.1"`

Edit `Codex-plugins/opensaas-stack/.Codex-plugin/plugin.json`:

- `"version": "0.2.0"` → `"version": "0.2.1"`

Edit `.Codex-plugin/marketplace.json` (in the `opensaas-stack` plugins entry):

- `"version": "0.2.0"` → `"version": "0.2.1"`

Do NOT change `metadata.version` — the marketplace structure itself did not change.

### Example 2: Minor — Add a new skill to opensaas-migration

Changed files: `Codex-plugins/opensaas-migration/skills/new-skill/SKILL.md` (new file)

Current version: `"0.2.0"` → New version: `"0.3.0"`

Edit `Codex-plugins/opensaas-migration/.Codex-plugin/plugin.json`:

- `"version": "0.2.0"` → `"version": "0.3.0"`

Edit `.Codex-plugin/marketplace.json` (in the `opensaas-migration` plugins entry):

- `"version": "0.2.0"` → `"version": "0.3.0"`

### Example 3: Changes to both plugins

Changed files include both `Codex-plugins/opensaas-stack/...` and `Codex-plugins/opensaas-migration/...`

Determine bump type independently for each plugin based on the nature of its changes. They can be bumped to different versions.

Edit `Codex-plugins/opensaas-stack/.Codex-plugin/plugin.json` with its new version.
Edit `Codex-plugins/opensaas-migration/.Codex-plugin/plugin.json` with its new version.
Edit `.Codex-plugin/marketplace.json` twice — once for each plugin's entry.

### Example 4: Marketplace-only change

Changed files: `.Codex-plugin/marketplace.json` (added a new top-level field) or `.Codex-plugin/MARKETPLACE.md`

The marketplace structure itself changed, so bump `metadata.version`.

Current: `"version": "1.1.0"` → New: `"version": "1.1.1"` (patch)

Edit `.Codex-plugin/marketplace.json` `metadata.version` field only.
Do NOT change any plugin.json files — no plugin logic changed.

## Common Mistakes to Avoid

1. **Don't bump metadata.version just because plugin versions changed**
   - Plugin version entries in marketplace.json are synced from plugin.json
   - Only bump metadata.version when the marketplace file's own structure changed

2. **Don't forget the marketplace.json plugin entry**
   - When you bump a plugin.json, always also update the matching entry in marketplace.json
   - The two must stay in sync

3. **Don't use major unless explicitly requested**
   - New skills and commands are minor, not major
   - Ask the user if you think a major bump is warranted

4. **Don't reset patch to 0 on a patch bump**
   - patch: `0.2.3` → `0.2.4` (not `0.2.0`)
   - minor: `0.2.3` → `0.3.0` (reset patch)
   - major: `0.2.3` → `1.0.0` (reset both)

5. **Don't edit unrelated fields**
   - Use Edit tool with precise old_string/new_string targeting just the version line
   - Verify after editing that only the version changed

6. **Don't create changeset files**
   - This skill edits JSON files directly
   - Plugin versions are NOT managed by the npm changeset system

## Workflow

When working on plugin changes:

1. Make your plugin code changes
2. Before committing, invoke this skill to bump versions
3. Verify the JSON files show the correct new versions
4. Commit all changed files together (plugin code + plugin.json + marketplace.json)

## Troubleshooting

**Q: Both plugins changed but for very different reasons — do I use the same bump type?**
A: No. Evaluate each plugin independently. One might be a patch and the other a minor bump.

**Q: I added a new skill AND fixed a bug in the same plugin. Which bump type?**
A: Use minor (the higher of the two).

**Q: How do I know if marketplace metadata.version should be bumped?**
A: Ask: "Did I change marketplace.json itself beyond just updating plugin version entries?" If you edited owner, metadata.description, added new top-level fields, or changed MARKETPLACE.md — yes. If you only updated plugin version numbers — no.

**Q: What if I only changed README.md inside a plugin directory?**
A: Still bump the plugin version (patch). Documentation is part of the plugin release.

**Q: Should this skill be used alongside pr-changeset?**
A: These are independent. `pr-changeset` handles npm packages in `packages/*`. This skill handles Codex plugins in `Codex-plugins/*`. If a PR changes both, use both skills.

## Important Notes

- Plugin versions are semver strings stored directly in JSON — there is no automated tooling managing them
- The marketplace.json `plugins[].version` fields must always match the corresponding plugin.json `version` fields
- marketplace.json `metadata.version` is independent and tracks the marketplace manifest itself
- Both plugin.json files and marketplace.json must be committed together in the same commit as the plugin changes

Wersje

RepozytoriumWynikLicencja
Ta strona · OpenSaasAU/stack100MIT
OpenSaasAU/stack100MIT

Migawka bazy z 13.11.2026 · wersja paczki fd11cdc11a1f (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100version
    Podbija wersje i tworzy wydania: aktualizuje plugin.json i marketplace.json oraz tworzy tag git i commit.
  • 100version-bump
    Klasyfikuje zmiany w pluginach jako major, minor albo patch i aktualizuje plugin.json oraz marketplace.json przed PR.
  • 90marketplace
    Pilnuje spójności repozytorium wtyczek cc-plugins przy dodawaniu, zmianie wersji i edycji komponentów, czyli czterech plików naraz.
  • 100version-bump
    Automatyzuje semantyczne wersjonowanie i wydania pluginów Claude Code: wersje w package.json, marketplace.json i plugin.json, weryfikację buildu, tagi git, wydania GitHub i changelog.
  • 100version-bumper
    Automatycznie aktualizuje wersje semantyczne w plugin.json i katalogu marketplace przy wzmiance o bumpie lub wydaniu, dbając o spójność wersji w repozytorium wtyczek.
  • 90Codex CLI Plugins
    Tworzy wtyczki Codex CLI: manifest, pakowanie skilli, marketplace i lokalną instalację.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.