resolve-renovate-pr

Diagnose and fix Renovate dependency-update PRs until they reach a mergeable state.

Updated Dec 25, 2021
One-click install
npx skills add https://github.com/kotahashihama/dotfiles --skill resolve-renovate-pr-kotahashihama
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: resolve-renovate-pr
Source: https://github.com/kotahashihama/dotfiles/tree/main/home/.claude/skills/resolve-renovate-pr
Command: npx skills add https://github.com/kotahashihama/dotfiles --skill resolve-renovate-pr-kotahashihama

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Renovate dependency-update PRs often sit open with failing CI, and it is unclear whether the failure is caused by your code, a pending approval, or a transient issue. This Skill triages the failure, decides whether the upgrade should happen at all, applies the follow-up fixes, and documents the reasoning on the PR without ever merging or approving it. ## Core Features & Use Cases - Upgrade feasibility research: Checks release announcements, peer dependency ranges via npm view, and upstream issue trackers before writing any migration code, so effort is not wasted on dependencies that should be skipped. - CI failure triage: Classifies failures into code-caused, approval/permission-pending, or transient, and reproduces them locally in a git worktree with the base branch merged in. - Follow-up fixes and lockfile handling: Commits migration fixes onto the Renovate branch itself, regenerates lockfiles instead of hand-editing them, and verifies the build actually runs (HTTP 200, CLI invocation) rather than trusting green tests. - Use Case: A Renovate PR bumps a major version of a build tool and CI fails. The Skill investigates whether the ecosystem supports the new version, reproduces the failure locally, fixes the breaking API usage, benchmarks before/after if speed was the selling point, and posts a comment on the PR summarizing findings. ## Quick Start Ask the assistant to resolve the open Renovate PR for a given repository, optionally passing a PR number or URL such as "resolve Renovate PR #142".

Frequently Asked Questions about resolve-renovate-pr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix a failing Renovate dependency update PR?

First classify the CI failure as code-caused, approval-pending, or transient using gh pr checks and gh run view. Reproduce code failures locally in a git worktree with the base branch merged in, then commit the migration fix directly onto the Renovate branch.

How do I decide whether a major dependency upgrade is safe to merge?

Check the official release announcement for GA status, run npm view to inspect peer dependency ranges of surrounding tools, and read upstream issue trackers for compatibility statements. Verify findings against primary sources rather than search result summaries before concluding.

Should I resolve Renovate lockfile conflicts by hand?

No, hand-editing lockfiles produces broken dependency trees because git can merge them without conflict markers while leaving dangling references. Delete the lockfile and regenerate it with the package manager, then verify with a frozen-lockfile install.

Why does CI pass locally but fail on the Renovate PR?

GitHub Actions checks out the PR merged into the base branch, not the branch alone. If the PR is behind base, merge origin/base locally before testing, and check the lag with git rev-list --count.

Does this Skill merge or approve the Renovate PR?

No, the Skill stops at a mergeable state and never merges, approves, or closes PRs. It reports the remaining external conditions such as required approvals and leaves the final decision to the user.

What are the limitations of automated Renovate PR resolution?

Approval-pending and permission failures cannot be fixed from code and are only reported. Upgrades requiring build, CI, or lint configuration changes require explicit user confirmation before any edits are made.