OpenParable
Skip to content
← Back to skills

Upgrade Dep

Development
upgrade-dep

Upgrade Dep is an Agent Skill for development published in the getsentry/sentry-javascript repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Upgrade a dependency in the Sentry JavaScript SDK. Use when upgrading packages, bumping versions, or fixing security vulnerabilities via dependency updates.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/getsentry/sentry-javascript/blob/HEAD/.agents/skills/upgrade-dep/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/upgrade-dep, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Dependency Upgrade

Only upgrade one package at a time.

Upgrade command

npx yarn-update-dependency@latest [package-name]

If the dependency is not defined in any package.json, run the upgrade from the root workspace (the yarn.lock lives there).

Avoid upgrading top-level dependencies (especially test dependencies) without asking the user first.

Ensure updated package.json files end with a newline.

OpenTelemetry constraint

STOP if upgrading any opentelemetry package would introduce forbidden versions:

  • 2.x.x (e.g., 2.0.0)
  • 0.2xx.x (e.g., 0.200.0, 0.201.0)

Verify before upgrading:

yarn info <package-name>@<version> dependencies

E2E test dependencies

Do not upgrade the major version of a dependency in dev-packages/e2e-tests/test-applications/* if the test directory name pins a version (e.g., nestjs-8 must stay on NestJS 8).

Post-upgrade verification

yarn install
yarn build:dev
yarn dedupe-deps:fix
yarn fix
yarn circularDepCheck

Useful commands

yarn list --depth=0          # Check dependency tree
yarn why [package-name]      # Find why a package is installed
yarn info <pkg> dependencies # Inspect package dependencies
yarn info <pkg> versions     # Check available versions
yarn outdated                # Check outdated dependencies
yarn audit                   # Check for security vulnerabilities