Skip to content

Commit 821e5c9

Browse files
authored
docs: add cross-client dependabot rollup skill (#793)
## Summary - add a reusable skill for the Dependabot PR rollup workflow - place it under `.agents/skills/` for cross-client discovery - keep the skill aligned with the Agent Skills standard and client-agnostic ## Details - adds `.agents/skills/dependabot-pr-rollup/SKILL.md` - documents the workflow for: - finding open Dependabot PRs - comparing PR heads to their base branch - replaying only net dependency changes in a fresh worktree - running `npm run all` - optionally committing, pushing, and opening a PR ## Notes - `.agents/skills/` is the shared interoperability location used across multiple coding agents - no code changes - tests not run (documentation-only skill)
1 parent 6ee6290 commit 821e5c9

1 file changed

Lines changed: 48 additions & 0 deletions

File tree

  • .agents/skills/dependabot-pr-rollup
Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
---
2+
name: dependabot-pr-rollup
3+
description: Find open Dependabot PRs for the current GitHub repo, compare each PR head to its base branch, replay only the net dependency changes in a fresh worktree and branch, run npm validation, and optionally commit, push, and open a PR. Use when you want to batch or manually replicate active Dependabot updates.
4+
license: MIT
5+
compatibility: Requires git, git worktree, gh CLI auth, npm, and a GitHub repo with an origin remote.
6+
---
7+
8+
# Dependabot PR Rollup
9+
10+
## When to use
11+
12+
Use this skill when the user wants to:
13+
- find all open Dependabot PRs in the current repo
14+
- reproduce their net effect in one local branch
15+
- validate the result with the repo's standard npm checks
16+
- optionally commit, push, and open a PR
17+
18+
## Workflow
19+
20+
1. Inspect the current checkout state, but do not reuse a dirty worktree.
21+
2. List open Dependabot PRs with `gh pr list --state open --author app/dependabot`.
22+
3. For each PR, collect the title, base branch, head branch, changed files, and relevant diffs.
23+
4. Compare each PR head against `origin/<base>` instead of trusting the PR title. Dependabot PRs can already be partially merged, superseded by newer versions, or have no remaining net effect.
24+
5. Create a new worktree and branch from `origin/<base>`.
25+
6. Reproduce only the remaining dependency changes in the new worktree.
26+
- Inspect `package.json` before editing.
27+
- Run `npm ci --ignore-scripts` before applying updates.
28+
- Use `npm install ... --ignore-scripts` for direct dependency changes so `package-lock.json` stays in sync.
29+
7. Run `npm run all`.
30+
8. If requested, commit the changed source, lockfile, and generated artifacts, then push and open a PR.
31+
32+
## Repo-specific notes
33+
34+
- Use `gh` for GitHub operations.
35+
- Keep the user's original checkout untouched by working in a separate worktree.
36+
- In this repo, `npm run all` is the safest validation command because it runs build, check, package, and test.
37+
- If dependency changes affect bundled output, include the regenerated `dist/` files.
38+
39+
## Report back
40+
41+
Always report:
42+
- open Dependabot PRs found
43+
- which PRs required no net changes
44+
- new branch name
45+
- new worktree path
46+
- files changed
47+
- `npm run all` result
48+
- if applicable, commit SHA and PR URL

0 commit comments

Comments
 (0)