PR Babysitter
openinterpreter/openinterpreter
Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.
Minimum-requirements checklist for any change — code or docs-only.
Install Pre PR Checklist
$ npx skills add oocx/tfplan2md --skill pre-pr-checklist -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install oocx/tfplan2md pre-pr-checklist --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/oocx/tfplan2md.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/pre-pr-checklist .claude/skills/pre-pr-checklist && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "pre-pr-checklist" agent skill from https://github.com/oocx/tfplan2md/tree/main/.agents/skills/pre-pr-checklist into .claude/skills/pre-pr-checklist/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pre-pr-checklist", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/oocx/tfplan2md/tree/main/.agents/skills/pre-pr-checklistType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add oocx/tfplan2md --skill pre-pr-checklist -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install oocx/tfplan2md pre-pr-checklist --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/oocx/tfplan2md.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/pre-pr-checklist .agents/skills/pre-pr-checklist && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "pre-pr-checklist" agent skill from https://github.com/oocx/tfplan2md/tree/main/.agents/skills/pre-pr-checklist into .agents/skills/pre-pr-checklist/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pre-pr-checklist", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add oocx/tfplan2md --skill pre-pr-checklist -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install oocx/tfplan2md pre-pr-checklist --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/oocx/tfplan2md.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/pre-pr-checklist .cursor/skills/pre-pr-checklist && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "pre-pr-checklist" agent skill from https://github.com/oocx/tfplan2md/tree/main/.agents/skills/pre-pr-checklist into .cursor/skills/pre-pr-checklist/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pre-pr-checklist", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/oocx/tfplan2md.git --path .agents/skills/pre-pr-checklist--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add oocx/tfplan2md --skill pre-pr-checklist -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install oocx/tfplan2md pre-pr-checklist --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/oocx/tfplan2md.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/pre-pr-checklist .gemini/skills/pre-pr-checklist && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "pre-pr-checklist" agent skill from https://github.com/oocx/tfplan2md/tree/main/.agents/skills/pre-pr-checklist into .gemini/skills/pre-pr-checklist/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pre-pr-checklist", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install oocx/tfplan2md pre-pr-checklistInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add oocx/tfplan2md --skill pre-pr-checklist -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/oocx/tfplan2md.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/pre-pr-checklist .github/skills/pre-pr-checklist && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "pre-pr-checklist" agent skill from https://github.com/oocx/tfplan2md/tree/main/.agents/skills/pre-pr-checklist into .github/skills/pre-pr-checklist/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pre-pr-checklist", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add oocx/tfplan2md --skill pre-pr-checklist -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install oocx/tfplan2md pre-pr-checklist --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/oocx/tfplan2md.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/pre-pr-checklist .opencode/skills/pre-pr-checklist && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "pre-pr-checklist" agent skill from https://github.com/oocx/tfplan2md/tree/main/.agents/skills/pre-pr-checklist into .opencode/skills/pre-pr-checklist/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pre-pr-checklist", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
pre-pr-checklist- GitHub stars
- 174
- Token cost
- ~1.8k tokens
- SKILL.md length
- 567 words
- Files
- 1
- Skills in repo
- 28
- Repo updated
- First seen
- Licence
- MIT
At a glance
Minimum-requirements checklist for any change — code or docs-only.
- Works in 9 steps: Determine Your Change Category → Work Item Folder → Code Formatting → …
- Tasks that involve Failing and flaky tests
- SKILL.md covers Purpose, When to Use, Step 0 — Determine Your Change… and Step 1 — Work Item Folder, plus 8 more sections
- Calls dotnet, git and npx
What it does
Pre PR Checklist is an agent skill from oocx/tfplan2md. Minimum-requirements checklist for any change — code or docs-only. Run this before every PR creation or push to avoid CI failures on the first attempt.
Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Development, covering Failing and flaky tests. The repository describes itself as: Convert terraform plans (json) into human readable markdown for easier review of changes in pull requests. The licence is MIT.
When your agent uses it
- Tasks that involve Failing and flaky tests
Example prompts
- “/pre-pr-checklist”
Requirements
- Node.js
Workflow steps
9 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 88d5240. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
dotnetgitnpxnode
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
conventionalcommits.org
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Pre PR Checklist loads about 1.8k tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 567 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from oocx/tfplan2md at commit 88d5240, republished under its MIT licence (© oocx). 567 words, ~1,800 tokens.
Download SKILL.mdSave it as
.claude/skills/pre-pr-checklist/SKILL.md (or your agent's skills folder).- name
- pre-pr-checklist
- description
- Minimum-requirements checklist for any change — code or docs-only. Run this before every PR creation or push to avoid CI failures on the first attempt.
Pre-PR Checklist
Purpose
Ensure every change — including simple, single-agent tasks — satisfies the repository's minimum requirements before a PR is created. This avoids predictable CI failures (release-notes guardrail, snapshot guardrail, formatting, coverage thresholds).
When to Use
Mandatory before any report_progress call (coding agents) or scripts/pr-github.sh create call (local agents) that introduces changes to the repository.
Step 0 — Determine Your Change Category
git diff --name-only origin/main...HEADCategory A — Docs/agent-tooling only (all changed files are under docs/ except docs/workflow.md and docs/spec.md, .github/ or .agents/ (any subdirectory or file), website/, website.old/, assets/, tests/, scripts/, or src/tests/shell/):
→ Skip to Step 6 (Commit hygiene). Build/test/work-item checks are not required.
Category B — Code/tooling (any file in src/ (except src/tests/shell/), examples/, docs/workflow.md, docs/spec.md, README.md, or CONTRIBUTING.md):
→ Complete all steps below.
Step 1 — Work Item Folder
Every code/tooling PR must be anchored to a work item folder. If you are doing a simple task without a full workflow, create a minimal one now.
Determine the folder
| Branch prefix | Folder prefix |
|---|---|
feature/<NNN>-... | docs/features/<NNN>-.../ |
fix/<NNN>-... | docs/issues/<NNN>-.../ |
workflow/<NNN>-... | docs/workflow/<NNN>-.../ |
If the branch does not match any prefix, use docs/workflow/ (most internal/tooling changes fall here). Use the next-issue-number skill to reserve an issue number if you don't already have one.
Create minimal required files (if missing)
docs/<type>/<NNN>-<slug>/release-notes.md — describe the change in one or two sentences. No screenshots required for simple changes:
## <Short title>
<One or two sentences describing what changed and why.>docs/<type>/<NNN>-<slug>/work-protocol.md — log your agent entry (required by the validate-work-protocol hook):
# Work Protocol: <Short title>
**Work Item:** `docs/<type>/<NNN>-<slug>/`
**Branch:** `<branch-name>`
**Workflow Type:** <Feature | Bug Fix | Workflow>
**Created:** <YYYY-MM-DD>
## Agent Work Log
### <Your Agent Name>
- **Date:** <YYYY-MM-DD>
- **Summary:** <What you did>
- **Artifacts Produced:** <Files created or modified>
- **Problems Encountered:** NoneNote: For simple single-agent changes the validate-work-protocol hook only blocks
report_progressafter the trigger agent (Code Reviewer for features/bugs; Workflow Engineer for workflow items) has logged an entry. So for single-agent tasks the hook will not block you — but the release-notes guardrail (validate-release-notes.sh) will. Bothrelease-notes.mdandwork-protocol.mdmust be present.
Step 2 — Code Formatting
dotnet format src/tfplan2md.slnx --verify-no-changes --verbosity diagnosticIf formatting errors are found, auto-fix and re-check:
dotnet format src/tfplan2md.slnx
dotnet format src/tfplan2md.slnx --verify-no-changesStep 3 — Build
dotnet build src/tfplan2md.slnx --configuration Release --no-incrementalAll errors must be resolved before proceeding.
Step 4 — Tests and Coverage
Use the run-dotnet-tests skill. The project has mandatory coverage thresholds (84.48 % line, 72.80 % branch). New code must be tested.
scripts/test-with-timeout.sh -- dotnet test --solution src/tfplan2md.slnx --configuration ReleaseSnapshot changes
If any file under src/tests/Oocx.TfPlan2Md.Tests/TestData/Snapshots/ changed, use the update-test-snapshots skill and include SNAPSHOT_UPDATE_OK in at least one commit message:
git commit --amend -m "$(git log -1 --format=%B)
SNAPSHOT_UPDATE_OK"Show full SKILL.md (225 more words)Show less
Step 5 — Demo Artifact Regeneration
Required when any change could affect markdown rendering output:
node -e "require('child_process').execSync('dotnet run --project src/Oocx.TfPlan2Md/Oocx.TfPlan2Md.csproj -- examples/comprehensive-demo/plan.json --principals examples/comprehensive-demo/demo-principals.json --output artifacts/comprehensive-demo.md', {stdio: 'inherit'})"
npx markdownlint-cli2 artifacts/comprehensive-demo.mdOr more directly:
dotnet run --project src/Oocx.TfPlan2Md/Oocx.TfPlan2Md.csproj -- examples/comprehensive-demo/plan.json --principals examples/comprehensive-demo/demo-principals.json --output artifacts/comprehensive-demo.md
npx markdownlint-cli2 artifacts/comprehensive-demo.mdSkip this step only if the change has no effect on markdown output (e.g., internal refactoring with no observable output change, or pure tooling/docs changes).
Step 6 — Commit Hygiene
Before creating the PR, verify:
- All commits follow Conventional Commits:
type(scope): description- Valid types:
feat,fix,docs,style,refactor,perf,test,build,ci,chore,revert,workflow - For internal-only PRs (docs/scripts/agents only), use
workflow:,docs:,chore:,ci:,style:, orrefactor:— notfeat:,fix:, orperf:(those trigger version bumps)
- Valid types:
-
CHANGELOG.mdhas not been edited (it is auto-generated by Versionize in CI) - Working tree is clean:
git status --short
Step 7 — Local Guardrail Scripts
Run the same checks that CI will run, locally:
# Release notes guardrail
scripts/validate-release-notes.sh
# Snapshot integrity guardrail
scripts/validate-snapshot-changes.shBoth scripts default to comparing against origin/main. Fix any reported errors before pushing.
Step 8 — PR Title and Description
Before calling report_progress or scripts/pr-github.sh create, compose the PR title and description using the standard template:
## Problem
<Why is this change needed?>
## Change
<What changed?>
## Verification
<How was it validated? List the checks you ran from this checklist.>Quick Reference (Category B)
| Step | Command / Action |
|---|---|
| Work item folder | Create release-notes.md + work-protocol.md with agent log entry |
| Format | dotnet format src/tfplan2md.slnx --verify-no-changes |
| Build | dotnet build src/tfplan2md.slnx --configuration Release --no-incremental |
| Tests | scripts/test-with-timeout.sh -- dotnet test --solution src/tfplan2md.slnx |
| Snapshots | Use update-test-snapshots skill; add SNAPSHOT_UPDATE_OK to commit |
| Demo | dotnet run ... -- examples/comprehensive-demo/plan.json ... --output artifacts/comprehensive-demo.md |
| Lint demo | npx markdownlint-cli2 artifacts/comprehensive-demo.md |
| Guardrails | scripts/validate-release-notes.sh + scripts/validate-snapshot-changes.sh |
| Commits | Conventional Commits, no CHANGELOG.md edits |
© oocx, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in .agents/skills/pre-pr-checklist of oocx/tfplan2md.
Open the folder on GitHubat commit 88d5240
Compare with similar skills
Pre PR Checklist next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Pre PR Checklist this skilloocx/tfplan2md | 174 | — | ~1.8k | Automated safety check: Pass | MIT | |
| PR Babysitteropeninterpreter/openinterpreter | 69k | 3 repos | ~4.2k | Automated safety check: Pass | Apache-2.0 | |
| Releasingc15t/c15t | 1.9k | — | ~753 | Automated safety check: Pass | Apache-2.0 | |
| CI Fixwarpdotdev/oz-skills | 825 | — | ~790 | Automated safety check: Pass | MIT | |
| Fix CIccusage/ccusage | 19k | — | ~487 | Automated safety check: Pass | Custom licence | |
| Nx CI Monitortech-leads-club/agent-skills | 7k | — | ~5.3k | Automated safety check: Pass | Custom licence |
Similar skills
Releasing
c15t/c15t
Version and release c15t packages with Changesets. An agent skill from c15t/c15t.
CI Fix
warpdotdev/oz-skills
Diagnose and fix GitHub Actions CI failures. An agent skill from warpdotdev/oz-skills.
Fix CI
ccusage/ccusage
Diagnoses and fixes failing GitHub Actions checks with gh. An agent skill from ccusage/ccusage.
Nx CI Monitor
tech-leads-club/agent-skills
Monitor Nx Cloud CI pipeline status and handle self-healing fixes automatically.
- Official
Unblock Dependabot PR
kubernetes-sigs/cloud-provider-azure
Diagnose and unblock failed Dependabot pull requests in cloud-provider-azure by closing Kubernetes minor-version dependency bumps, classifying CI failures, syncing Go modules, retesting quota-flaked…
More from oocx/tfplan2md
All 28 skills in this repoCreate Agent Skill
oocx/tfplan2md
Create a new Agent Skill following project standards and templates.
Detect Diagram Crossings
oocx/tfplan2md
Detect and analyze edge crossings and overlaps in SVG workflow diagrams using geometric intersection algorithms and visual analysis.
Generate Release Screenshots
oocx/tfplan2md
Generate PNG screenshots for release notes using the repository's HtmlRenderer and ScreenshotGenerator tools.
Git Rebase Main
oocx/tfplan2md
Safely rebase the current feature branch on top of the latest origin/main.
Next Issue Number
oocx/tfplan2md
Determine the next available issue number across all change types (feature, fix, workflow, website) by checking both local docs and remote branches, then reserve it by pushing an empty branch.
Run Uat
oocx/tfplan2md
Run User Acceptance Testing by creating a PR with rendered markdown on GitHub or Azure DevOps.
Related
Categories
Questions about Pre PR Checklist
What does Pre PR Checklist do?
Minimum-requirements checklist for any change — code or docs-only. Pre PR Checklist is an agent skill from oocx/tfplan2md. Minimum-requirements checklist for any change — code or docs-only.
When should I use Pre PR Checklist?
Pre PR Checklist fits situations like: tasks that involve Failing and flaky tests.
How do I install Pre PR Checklist in Claude Code?
Run `npx skills add oocx/tfplan2md --skill pre-pr-checklist -a claude-code`. Or copy the skill folder (.agents/skills/pre-pr-checklist in oocx/tfplan2md) into .claude/skills/pre-pr-checklist in your project. Claude Code loads it when a task matches its description.
How do I install Pre PR Checklist in Codex?
Run `npx skills add oocx/tfplan2md --skill pre-pr-checklist -a codex`. Or copy the skill folder (.agents/skills/pre-pr-checklist in oocx/tfplan2md) into .agents/skills/pre-pr-checklist in your project. Codex loads it when a task matches its description.
Can I use Pre PR Checklist in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add oocx/tfplan2md --skill pre-pr-checklist -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pre-pr-checklist, .gemini/skills/pre-pr-checklist, .github/skills/pre-pr-checklist and .opencode/skills/pre-pr-checklist in your project.
What does Pre PR Checklist need to run?
Going by SKILL.md and its folder, Pre PR Checklist needs the command-line tools its instructions call (dotnet, git, npx and node). Our summary lists: Node.js.
Does Pre PR Checklist access the network?
SKILL.md names 1 domain. As links in the text: conventionalcommits.org. This is read from the text; nothing was executed.
Is Pre PR Checklist safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Pre PR Checklist use?
Pre PR Checklist is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Pre PR Checklist use?
About 1.8k tokens (SKILL.md is roughly 7.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Pre PR Checklist?
Skills that share tags, products or a category with Pre PR Checklist: PR Babysitter (openinterpreter/openinterpreter, 69k stars), Releasing (c15t/c15t, 1.9k stars), CI Fix (warpdotdev/oz-skills, 825 stars) and Fix CI (ccusage/ccusage, 19k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Pre PR Checklist?
oocx (a GitHub user) maintains it in oocx/tfplan2md, which has 174 GitHub stars. The repository holds 28 skills in this directory. The repository was last updated on October 7, 2026.
Source: oocx/tfplan2md on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.