Agent skill
openclaw-pr-maintainer
Maintainer workflow for reviewing, triaging, preparing, closing, or landing OpenClaw pull requests and related issues. Use when Codex needs to validate bug-fix claims, search for related issues or PRs, apply or recommend close/reason labels, prepare GitHub comments safely, check review-thread follow-up, or perform maintainer-style PR decision making before merge or closure.
Install this agent skill to your Project
npx add-skill https://github.com/openclaw/openclaw/tree/main/.agents/skills/openclaw-pr-maintainer
SKILL.md
OpenClaw PR Maintainer
Use this skill for maintainer-facing GitHub workflow, not for ordinary code changes.
Apply close and triage labels correctly
- If an issue or PR matches an auto-close reason, apply the label and let
.github/workflows/auto-response.ymlhandle the comment/close/lock flow. - Do not manually close plus manually comment for these reasons.
r:*labels can be used on both issues and PRs.- Current reasons:
r: skillr: supportr: no-ci-prr: too-many-prsr: testflightr: third-party-extensionr: moltbookr: spaminvaliddirtyfor PRs only
Enforce the bug-fix evidence bar
- Never merge a bug-fix PR based only on issue text, PR text, or AI rationale.
- Before landing, require:
- symptom evidence such as a repro, logs, or a failing test
- a verified root cause in code with file/line
- a fix that touches the implicated code path
- a regression test when feasible, or explicit manual verification plus a reason no test was added
- If the claim is unsubstantiated or likely wrong, request evidence or changes instead of merging.
- If the linked issue appears outdated or incorrect, correct triage first. Do not merge a speculative fix.
Handle GitHub text safely
- For issue comments and PR comments, use literal multiline strings or
-F - <<'EOF'for real newlines. Never embed\n. - Do not use
gh issue/pr comment -b "..."when the body contains backticks or shell characters. Prefer a single-quoted heredoc. - Do not wrap issue or PR refs like
#24643in backticks when you want auto-linking. - PR landing comments should include clickable full commit links for landed and source SHAs when present.
Search broadly before deciding
- Prefer targeted keyword search before proposing new work or closing something as duplicate.
- Use
--repo openclaw/openclawwith--match title,bodyfirst. - Add
--match commentswhen triaging follow-up discussion. - Do not stop at the first 500 results when the task requires a full search.
Examples:
gh search prs --repo openclaw/openclaw --match title,body --limit 50 -- "auto-update"
gh search issues --repo openclaw/openclaw --match title,body --limit 50 -- "auto-update"
gh search issues --repo openclaw/openclaw --match title,body --limit 50 \
--json number,title,state,url,updatedAt -- "auto update" \
--jq '.[] | "\(.number) | \(.state) | \(.title) | \(.url)"'
Follow PR review and landing hygiene
- If bot review conversations exist on your PR, address them and resolve them yourself once fixed.
- Leave a review conversation unresolved only when reviewer or maintainer judgment is still needed.
- When landing or merging any PR, follow the global
/landprprocess. - Use
scripts/committer "<msg>" <file...>for scoped commits instead of manualgit addandgit commit. - Keep commit messages concise and action-oriented.
- Group related changes; avoid bundling unrelated refactors.
- Use
.github/pull_request_template.mdfor PR submissions and.github/ISSUE_TEMPLATE/for issues.
Extra safety
- If a close or reopen action would affect more than 5 PRs, ask for explicit confirmation with the exact count and target query first.
syncmeans: if the tree is dirty, commit all changes with a sensible Conventional Commit message, thengit pull --rebase, thengit push. Stop if rebase conflicts cannot be resolved safely.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
openclaw-test-heap-leaks
Investigate `pnpm test` memory growth, Vitest worker OOMs, and suspicious RSS increases in OpenClaw using the `scripts/test-parallel.mjs` heap snapshot tooling. Use when Codex needs to reproduce test-lane memory growth, collect repeated `.heapsnapshot` files, compare snapshots from the same worker PID, distinguish transformed-module retention from real data leaks, and fix or reduce the impact by patching cleanup logic or isolating hotspot tests.
parallels-discord-roundtrip
Run the macOS Parallels smoke harness with Discord end-to-end roundtrip verification, including guest send, host verification, host reply, and guest readback.
security-triage
Triage GitHub security advisories for OpenClaw with high-confidence close/keep decisions, exact tag and commit verification, trust-model checks, optional hardening notes, and a final reply ready to post and copy to clipboard.
openclaw-release-maintainer
Maintainer workflow for OpenClaw releases, prereleases, changelog release notes, and publish validation. Use when Codex needs to prepare or verify stable or beta release steps, align version naming, assemble release notes, check release auth requirements, or validate publish-time commands and artifacts.
openclaw-ghsa-maintainer
Maintainer workflow for OpenClaw GitHub Security Advisories (GHSA). Use when Codex needs to inspect, patch, validate, or publish a repo advisory, verify private-fork state, prepare advisory Markdown or JSON payloads safely, handle GHSA API-specific publish constraints, or confirm advisory publish success.
openclaw-parallels-smoke
End-to-end Parallels smoke, upgrade, and rerun workflow for OpenClaw across macOS, Windows, and Linux guests. Use when Codex needs to run, rerun, debug, or interpret VM-based install, onboarding, gateway smoke tests, latest-release-to-main upgrade checks, fresh snapshot retests, or optional Discord roundtrip verification under Parallels.
Didn't find tool you were looking for?