← LeaderboardThe Skill Leaderboard

dependency-conflict-resolver

Resolve a dependency or version conflict (npm, pip, yarn, pnpm, Maven, Go modules) step by step. Use when an install fails with peer-dependency or version-conflict errors, packages won't co-exist, or a lockfile is fighting you. Produces the conflict explained, the resolution options ranked by safety, exact commands, and how to keep it from recurring.

Published by mohitagw15856 ↗mohitagw15856/pm-claude-skills

Try your first task

dependency-conflict-resolver

Start a fresh conversation. Replace the highlighted placeholders.

Use dependency-conflict-resolver to diagnose the dependency conflict in [install error output] using [manifest and lockfile], then provide safety-ranked resolution options with exact edits or commands, risks, a recommendation, and a verification step.

Required inputs

  • [install error output]
  • [manifest and lockfile]

User-approved starter prompt based on a pinned source version; check current skill requirements before running. Task evidence ↗

SKILL.md

name: dependency-conflict-resolverdescription: "Resolve a dependency or version conflict (npm, pip, yarn, pnpm, Maven, Go modules) step by step. Use when an install fails with peer-dependency or version-conflict errors, packages won't co-exist, or a lockfile is fighting you. Produces the conflict explained, the resolution options ranked by safety, exact commands, and how to keep it from recurring."

Dependency Conflict Resolver Skill

Untangle "could not resolve dependency" hell into a clear, ranked plan.

Working from a brief

Infer the package manager and ecosystem from the error or files mentioned; label assumptions (assumed — confirm). Always deliver a concrete resolution path even from just the error text.

Input

The install error / conflict output, plus (if given) the manifest (package.json, requirements.txt, go.mod…) and lockfile, and the manager. Infer what's missing.

Output Structure

The conflict

Plain-English: package A needs X of C, package B needs Y of C, and they can't both be satisfied (name the actual packages/versions from the input).

Options (ranked by safety)

  1. Safest — e.g. align versions, upgrade the constrained package, or find a compatible range. Exact command.
  2. Pragmatic — e.g. an override/resolution (overrides, resolutions, constraints file) with the exact snippet — and the risk it carries.
  3. Last resort — e.g. --legacy-peer-deps / --force — clearly flagged as masking the problem, not fixing it.

Give the exact commands/edits for each, and a recommendation of which to pick and why.

Verify & prevent

How to confirm the fix (npm ls <pkg>, a clean reinstall, the build), and one habit to avoid recurrence (lockfile committed, renovate/dependabot, version pinning policy).

Quality Checks

  • Names the actual conflicting packages and versions from the input
  • Options are ranked by safety with the trade-off of each stated
  • --force/--legacy-peer-deps-style escapes are flagged as masking, not fixing
  • Includes a verification step

Anti-Patterns

  • Do not lead with --force / --legacy-peer-deps — it hides the conflict and breaks later
  • Do not delete the lockfile as the first move — explain what that actually does
  • Do not give a single fix when several are viable — rank them with trade-offs
  • Do not skip verifying the resolution actually installs/builds

Example Trigger Phrases

  • "npm install fails with a peer-dependency error."
  • "pip can't resolve these versions."
  • "These two packages won't co-exist."
  • "My lockfile keeps fighting me."