# 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.

- Skill name: `upgrade-dep`
- Category: [Development](https://www.openparable.com/skill/development/1)
- Source: https://github.com/getsentry/sentry-javascript/blob/HEAD/.agents/skills/upgrade-dep/SKILL.md
- Repository: getsentry/sentry-javascript (8,707 GitHub stars when collected)

## SKILL.md

# Dependency Upgrade

**Only upgrade one package at a time.**

## Upgrade command

```bash
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:

```bash
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

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

## Useful commands

```bash
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
```

---

Source: https://www.openparable.com/skill/development/upgrade-dep (OpenParable). Cite the canonical URL above.
