Agent skill

Nx Gradle Plugin Version Bump

by nrwl in nrwl/nx

Bump the dev.nx.gradle.project-graph plugin version. An agent skill from nrwl/nx.

MITAuto-check: notesDevelopment

Install Nx Gradle Plugin Version Bump

skills CLI
$ npx skills add nrwl/nx --skill nx-gradle-plugin-version-bump -a claude-code

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

GitHub CLI
$ gh skill install nrwl/nx nx-gradle-plugin-version-bump --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/nrwl/nx.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/nx-gradle-plugin-version-bump .claude/skills/nx-gradle-plugin-version-bump && 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
nx-gradle-plugin-version-bump
GitHub stars
29k
Token cost
~1.3k tokens
SKILL.md length
361 words
Files
1
Skills in repo
21
Repo updated
First seen
Licence
MIT

At a glance

Bump the dev.nx.gradle.project-graph plugin version. An agent skill from nrwl/nx.

  • Works in 5 steps: Update the version constant → Update build.gradle.kts → Create migration TypeScript file → …
  • Updating the Gradle project graph plugin version across the codebase
  • SKILL.md covers Required Inputs, Steps, Verification and Commit Convention, plus 1 more section
  • Calls nx

What it does

Nx Gradle Plugin Version Bump is an agent skill from nrwl/nx. Bump the dev.nx.gradle.project-graph plugin version. Use when updating the Gradle project graph plugin version across the codebase, creating the migration files, and updating migrations.json.

Its SKILL.md is about 1.3k 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 Gradle. The repository describes itself as: The Monorepo Platform that amplifies both developers and AI agents. Nx optimizes your builds, scales your CI, and fixes failed PRs automatically. Ship in half the time. The licence is MIT.

When your agent uses it

  • Updating the Gradle project graph plugin version across the codebase
  • Creating the migration files
  • Updating migrations.json

Example prompts

  • “/nx-gradle-plugin-version-bump”

Requirements

  • Pre-approved tools (allowed-tools): Bash, Read, Write, Edit, Glob, Grep

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Update the version constant
  2. Update build.gradle.kts
  3. Create migration TypeScript file
  4. Create migration documentation file
  5. Add migration entry to migrations.json

What it can do on your machine

Read from SKILL.md and the folder at commit db71d69. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Write
    • Edit
    • Glob
    • Grep

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • nx

    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

Nx Gradle Plugin Version Bump loads about 1.3k tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 361 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Write, Edit, Glob, Grep

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 nrwl/nx at commit db71d69, republished under its MIT licence (© nrwl). 361 words, ~1,287 tokens.

Download SKILL.mdSave it as .claude/skills/nx-gradle-plugin-version-bump/SKILL.md (or your agent's skills folder).
name
nx-gradle-plugin-version-bump
description
Bump the dev.nx.gradle.project-graph plugin version. Use when updating the Gradle project graph plugin version across the codebase, creating the migration files, and updating migrations.json.
allowed-tools
Bash, Read, Write, Edit, Glob, Grep

Gradle Plugin Version Bump

Bumps the dev.nx.gradle.project-graph plugin to a new version. This is a recurring task that touches 5 files in an identical pattern every time.

Required Inputs

Collect these values from the master branch before starting:

  1. NEW_VERSION - the version we want to bump to Example: OLD_VERSION: 0.1.15 => NEW_VERSION: 0.1.16 You can find this value by looking at the OLD_VERSION specified in packages/gradle/project-graph/build.gradle.kts in the version field.
    The NEW_VERSION will be the OLD_VERSION + 1.

  2. NX_MIGRATION_VERSION - the version of Nx that will trigger our version bump migration Example: OLD_VERSION: 22.7.0-beta.0 => NEW_VERSION: 22.7.0-beta.1 You can find this value by looking at the nx version in package.json under devDependencies. The NEW_VERSION will be the OLD_VERSION + 1.

  3. MIGRATION_FOLDER - the folder name under packages/gradle/src/migrations/ that will contain our migration files Example: NEW_VERSION: 22.7.0-beta.1 => MIGRATION_FOLDER: 22-7-0 Take the version and replace all the dots with hyphens and remove the beta or rc suffix.

Steps

1. Update the version constant

File: packages/gradle/src/utils/versions.ts

Change gradleProjectGraphVersion to the new version:

ts
export const gradleProjectGraphVersion = 'NEW_VERSION';
2. Update build.gradle.kts

File: packages/gradle/project-graph/build.gradle.kts

Update the version on line 13:

kotlin
version = "NEW_VERSION"
3. Create migration TypeScript file

File: packages/gradle/src/migrations/MIGRATION_FOLDER/change-plugin-version-NEW_VERSION.ts

Determine the previous version by reading the current gradleProjectGraphVersion from packages/gradle/src/utils/versions.ts before modifying it.

Template:

ts
import { Tree, readNxJson } from '@nx/devkit';
import { hasGradlePlugin } from '../../utils/has-gradle-plugin';
import { addNxProjectGraphPlugin } from '../../generators/init/gradle-project-graph-plugin-utils';
import { updateNxPluginVersionInCatalogsAst } from '../../utils/version-catalog-ast-utils';

/* Change the plugin version to NEW_VERSION
 */
export default async function update(tree: Tree) {
  const nxJson = readNxJson(tree);
  if (!nxJson) {
    return;
  }
  if (!hasGradlePlugin(tree)) {
    return;
  }

  const gradlePluginVersionToUpdate = 'NEW_VERSION';

  // Update version in version catalogs using AST-based approach to preserve formatting
  await updateNxPluginVersionInCatalogsAst(tree, gradlePluginVersionToUpdate);

  // Then update in build.gradle(.kts) files
  await addNxProjectGraphPlugin(tree, gradlePluginVersionToUpdate);
}
4. Create migration documentation file

File: packages/gradle/src/migrations/MIGRATION_FOLDER/change-plugin-version-NEW_VERSION.md

Replace PREV_VERSION with the version that was current before this bump.

Template:

md
#### Change dev.nx.gradle.project-graph to version NEW_VERSION

Change dev.nx.gradle.project-graph to version NEW_VERSION in build file

#### Sample Code Changes

##### Before

\```text title="build.gradle"
plugins {
id "dev.nx.gradle.project-graph" version "PREV_VERSION"
}
\```

##### After

\```text title="build.gradle"
plugins {
id "dev.nx.gradle.project-graph" version "NEW_VERSION"
}
\```
Show full SKILL.md (144 more words)Show less
5. Add migration entry to migrations.json

File: packages/gradle/migrations.json

Add a new entry at the end of the generators object (before the closing }), following the existing pattern:

json
"change-plugin-version-NEW_VERSION": {
  "version": "NX_MIGRATION_VERSION",
  "description": "Change dev.nx.gradle.project-graph to version NEW_VERSION in build file",
  "implementation": "./dist/src/migrations/MIGRATION_FOLDER/change-plugin-version-NEW_VERSION",
  "documentation": "./dist/src/migrations/MIGRATION_FOLDER/change-plugin-version-NEW_VERSION.md"
}

The migration key uses the version with hyphens replacing dots (e.g., 0-1-16). The paths are dist-prefixed because the published package ships only dist/, and documentation is how the entry references the step-4 file. Older entries also carry cli: "nx" (deprecated in the migrations schema) and the factory alias for implementation; the template uses the primary key and omits cli. For the general entry shape see the author-migration skill.

Verification

Run:

bash
nx run-many -t test,build,lint -p gradle

Commit Convention

chore(gradle): bump gradle project graph plugin version to NEW_VERSION

Final Verification

Take a look at the most recent Gradle version bump PR and compare your changes to that. You should not be touching more or less files than the most recent version bump PR. If you do, ask for more information and stop all changes.

© nrwl, MIT. 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 .claude/skills/nx-gradle-plugin-version-bump of nrwl/nx.

Open the folder on GitHubat commit db71d69

Compare with similar skills

Nx Gradle Plugin Version Bump 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.

Nx Gradle Plugin Version Bump compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Nx Gradle Plugin Version Bump this skillnrwl/nx29k—~1.3kAutomated safety check: NotesMIT
Exposed Bug Fix WorkflowJetBrains/Exposed9.3k—~3.8kAutomated safety check: PassApache-2.0
Caffeine Cache Optimization Experimentsben-manes/caffeine18k—~2.6kAutomated safety check: NotesApache-2.0
Groovy 5 Developer Guideapache/grails-core2.9k—~3kAutomated safety check: PassApache-2.0
Release New Versionniki914/zafiro231—~2.1kAutomated safety check: PassMIT
Minecraft CI ReleaseJahrome907/minecraft-agent-skills169—~3.6kAutomated safety check: PassMIT

Similar skills

  • Exposed Bug Fix Workflow

    JetBrains/Exposed

    Official

    Takes a GitHub or YouTrack issue for the Exposed project through reproduction, a failing test, a fix, validation and a pull request.

    9.3k GitHub stars~3.8k tokensUpdated today
    DevelopmentAuto-check passed
  • Runs controlled JMH experiments on the Caffeine cache to find shared contention and hot-path waste, then reviews correctness and returns a reviewable patch.

    18k GitHub stars~2.6k tokensUpdated today
    DevelopmentAuto-check: notes
  • Groovy 5 Developer Guide

    apache/grails-core

    Guidance for Groovy 5 work in Grails projects: syntax, closures, traits, DSLs, metaprogramming, Spock tests, static compilation and Java 21 integration.

    2.9k GitHub stars~3k tokensUpdated today
    DevelopmentAuto-check passed
  • Release New Version

    niki914/zafiro

    A skill your agent uses when the user wants to release a new Zafiro version — drafting bilingual release notes, deciding the next version number, bumping app/build.gradle.kts, tagging, and…

    231 GitHub stars~2.1k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Minecraft CI Release

    Jahrome907/minecraft-agent-skills

    Set up and review CI, artifact publishing, versioning, and release management for Minecraft 26.x or legacy 1.21.x mods and Paper plugins.

    169 GitHub stars~3.6k tokensUpdated 26 days ago
    DevelopmentAuto-check passed
  • Update Version Catalog

    RedMadRobot/gradle-version-catalogs

    Use EVERY time the user asks to update / bump the version catalogs, "сделать обновление", "обновить каталог(и)", "обнови версии", "оформи изменения", "update the catalog", or to record dependency…

    118 GitHub stars~9.5k tokensUpdated 6 days ago
    DevelopmentAuto-check passed
  • Monitor CI

    nrwl/nx

    Monitor Nx Cloud CI pipeline and handle self-healing fixes. An agent skill from nrwl/nx.

    29k GitHub starsUsed in 6 repos~4.7k tokens
    Auto-check passed
  • Nx Import

    nrwl/nx

    Import, merge, or combine repositories into an Nx workspace using nx import.

    29k GitHub starsUsed in 6 repos~3.5k tokens
    Auto-check passed
  • Run Nx generators with prioritization for workspace-plugin generators.

    29k GitHub starsUsed in 2 repos~592 tokens
    Auto-check: notes
  • Author or scope a first-party Nx migration. An agent skill from nrwl/nx.

    29k GitHub stars~12k tokensUpdated today
    Auto-check: notes
  • Generate code using nx generators. An agent skill from nrwl/nx.

    29k GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check passed
  • Check modified Nx documentation pages against the astro-docs style guide.

    29k GitHub stars~1.3k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Nx Gradle Plugin Version Bump

What does Nx Gradle Plugin Version Bump do?

Bump the dev.nx.gradle.project-graph plugin version. An agent skill from nrwl/nx. Nx Gradle Plugin Version Bump is an agent skill from nrwl/nx.project-graph plugin version.

When should I use Nx Gradle Plugin Version Bump?

Nx Gradle Plugin Version Bump fits situations like: updating the Gradle project graph plugin version across the codebase; creating the migration files; updating migrations.json.

How do I install Nx Gradle Plugin Version Bump in Claude Code?

Run `npx skills add nrwl/nx --skill nx-gradle-plugin-version-bump -a claude-code`. Or copy the skill folder (.claude/skills/nx-gradle-plugin-version-bump in nrwl/nx) into .claude/skills/nx-gradle-plugin-version-bump in your project. Claude Code loads it when a task matches its description.

How do I install Nx Gradle Plugin Version Bump in Codex?

Run `npx skills add nrwl/nx --skill nx-gradle-plugin-version-bump -a codex`. Or copy the skill folder (.claude/skills/nx-gradle-plugin-version-bump in nrwl/nx) into .agents/skills/nx-gradle-plugin-version-bump in your project. Codex loads it when a task matches its description.

Can I use Nx Gradle Plugin Version Bump 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 nrwl/nx --skill nx-gradle-plugin-version-bump -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/nx-gradle-plugin-version-bump, .gemini/skills/nx-gradle-plugin-version-bump, .github/skills/nx-gradle-plugin-version-bump and .opencode/skills/nx-gradle-plugin-version-bump in your project.

What does Nx Gradle Plugin Version Bump need to run?

Going by SKILL.md and its folder, Nx Gradle Plugin Version Bump needs the command-line tools its instructions call (nx). Its frontmatter pre-approves these tools: Bash, Read, Write, Edit, Glob, Grep.

Does Nx Gradle Plugin Version Bump 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 Nx Gradle Plugin Version Bump safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Nx Gradle Plugin Version Bump use?

Nx Gradle Plugin Version Bump is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Nx Gradle Plugin Version Bump use?

About 1.3k tokens (SKILL.md is roughly 5.1k 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 Nx Gradle Plugin Version Bump?

Skills that share tags, products or a category with Nx Gradle Plugin Version Bump: Exposed Bug Fix Workflow (JetBrains/Exposed, 9.3k stars), Caffeine Cache Optimization Experiments (ben-manes/caffeine, 18k stars), Groovy 5 Developer Guide (apache/grails-core, 2.9k stars) and Release New Version (niki914/zafiro, 231 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Nx Gradle Plugin Version Bump?

nrwl (a GitHub organization) maintains it in nrwl/nx, which has 29,399 GitHub stars. The repository holds 21 skills in this directory. The repository was last updated on October 9, 2026.

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