Agent skill

Draft PR with CI Rounds

by windmill-labs in windmill-labs/windmill

Opens a draft GitHub pull request with a conventional title and explicit body, then drives CI review rounds before marking it ready.

Custom licenceAuto-check passedDevelopment

Install Draft PR with CI Rounds

skills CLI
$ npx skills add windmill-labs/windmill --skill pr -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install windmill-labs/windmill pr --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/windmill-labs/windmill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/pr .claude/skills/pr && rm -rf skills-src

Use ~/.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/

Facts

Skill name
pr
GitHub stars
18k
Token cost
~3.4k tokens
SKILL.md length
1,832 words
Files
2
Skills in repo
42
Repo updated
First seen
Licence
Custom licence

At a glance

Opens a draft GitHub pull request with a conventional title and explicit body, then drives CI review rounds before marking it ready.

  • Works in 4 steps: Analyze branch changes: Understand all… → Push to remote: Ensure all commits are… → Create draft PR: Always open as draft… → …
  • Opening a pull request for the current branch
  • SKILL.md covers Instructions, PR Title Format, PR Body Format and Screenshots (required for…, plus 3 more sections
  • Runs Shell scripts from its folder; calls git, gh and bash; reaches raw.githubusercontent.com

What it does

This skill opens a draft GitHub pull request for the current branch and drives it through CI review rounds until it is ready. It analyzes the commits since the branch diverged from main, pushes to the remote, creates the PR as a draft and flips it to ready only once every review verdict is a go. A review-round.sh helper supports the rounds.

Titles follow conventional commit format (feat, fix, refactor, docs, chore or perf), stay under 70 characters, use lowercase imperative mood with no trailing period, and get an ee prefix when enterprise files ending in _ee.rs changed. The body must spell out what changed. When the diff touches the frontend folder, screenshots of the affected UI are required: the agent verifies the change in the browser, captures each page with the Playwright MCP tool and hosts the images in a public screenshots repository through the GitHub API, piping base64 through stdin to avoid argument-length failures.

When your agent uses it

  • Opening a pull request for the current branch
  • Writing a conventional-commit PR title and a clear change summary
  • Adding screenshots of affected UI to a frontend PR
  • Driving CI review rounds until every verdict is a go

Example prompts

  • “Open a draft PR for this branch and run the review rounds until it is ready.”
  • “Write the PR title and body for my changes to the flow editor, with screenshots of the UI.”
  • “Check the review round results and tell me whether the draft is ready to flip.”

Requirements

  • GitHub CLI (gh), authenticated
  • Playwright MCP for UI screenshots

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Analyze branch changes: Understand all commits since diverging from main
  2. Push to remote: Ensure all commits are pushed
  3. Create draft PR: Always open as draft for review before merging
  4. Drive review rounds: trigger CI reviews on the draft and only flip to ready once every verdict is a go (see "Review rounds" below)

What it can do on your machine

Read from SKILL.md and the folder at commit eab3dd5. 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

    Ships script files (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • git
    • gh
    • bash
    • jq
    • cargo

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • raw.githubusercontent.com

    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

Draft PR with CI Rounds loads about 3.4k tokens when it runs. Until then it costs about 32 tokens; SKILL.md has 1,832 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~32
When it runs · the whole SKILL.md, loaded when a task matches
~3.4k

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,832 words (~3,381 tokens).

“Create a draft pull request with a clear title and explicit description of changes, then drive it through CI review rounds to ready.”

— opening of SKILL.md by windmill-labs, Custom licence
name
pr
user_invocable
true

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in .agents/skills/pr of windmill-labs/windmill.

  • SKILL.md
  • review-round.sh

Open the folder on GitHubat commit eab3dd5

Compare with similar skills

Draft PR with CI Rounds 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.

Draft PR with CI Rounds compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Draft PR with CI Rounds this skillwindmill-labs/windmill18k—~3.4kAutomated safety check: PassCustom licence
PR Finalize Reviewmicrosoft/garnet12k—~3.1kAutomated safety check: PassMIT
React Router Pull Request Creatorremix-run/react-router57k—~2.5kAutomated safety check: PassMIT
Verdaccio Pull Request Workflowverdaccio/verdaccio18k—~1.9kAutomated safety check: PassMIT
Gh PR Metadatamodule-federation/core2.7k—~1kAutomated safety check: PassMIT
Draft Pull Request Creatorwordpress-mobile/WordPress-Android3.2k—~881Automated safety check: NotesGPL-2.0

Similar skills

  • PR Finalize Review

    microsoft/garnet

    Official

    Checks that a pull request's title and description match its implementation and reviews the code for Garnet best practices, reporting findings without posting them.

    12k GitHub stars~3.1k tokensUpdated today
    DevelopmentAuto-check passed
  • React Router Pull Request Creator

    remix-run/react-router

    Packages finished React Router work into a draft pull request: branch, commit, push, a written PR body and the right GitHub labels.

    57k GitHub stars~2.5k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Takes a change through a verdaccio pull request: branch, local checks, changeset, title and body, labels, CI and review rounds, and ports to other release lines.

    18k GitHub stars~1.9k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Gh PR Metadata

    module-federation/core

    Update the current GitHub PR title and body for this repository so they match the repo's pull request template and conventional-commit title style.

    2.7k GitHub stars~1k tokensUpdated today
    DevelopmentAuto-check passed
  • Draft Pull Request Creator

    wordpress-mobile/WordPress-Android

    Commits and pushes current changes, writes a pull request title and body from the branch history and template, and opens a draft PR on GitHub after you approve it.

    3.2k GitHub stars~881 tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • Submit PR

    tisfeng/Easydict

    创建或复用当前 checkout 已提交变更的 GitHub PR,必要时推送任务分支。PR 审查使用 review-pr;仅本地提交使用 git-commit。

    15k GitHub stars~595 tokensUpdated yesterday
    DevelopmentAuto-check passed

More from windmill-labs/windmill

All 42 skills in this repo
  • Windmill Trigger Type Checklist

    windmill-labs/windmill

    Checklist of every backend, frontend, CLI and capture change needed to add a new TriggerCrud-based trigger type, such as Azure, GCP or Kafka, to Windmill.

    18k GitHub stars~4.7k tokensUpdated today
    Auto-check passed
  • Windmill AI Evals

    windmill-labs/windmill

    Writes and runs black-box benchmark cases for Windmill's flow, app, script, CLI and global AI generation modes, including before-and-after comparisons.

    18k GitHub stars~969 tokensUpdated today
    Auto-check: notes
  • Domain Modeling and Glossary

    windmill-labs/windmill

    Actively challenges vague or conflicting terminology as you design, and keeps a living domain glossary file up to date in real time.

    18k GitHub stars~622 tokensUpdated today
    Auto-check passed
  • Local PR Review

    windmill-labs/windmill

    Runs the same code review locally that GitHub's auto-review actions run on a PR, delegating to a fresh-context subagent so the review isn't biased by the main session's own reasoning.

    18k GitHub stars~995 tokensUpdated today
    Auto-check passed
  • Windmill Dev Page Preview

    windmill-labs/windmill

    Opens the Windmill dev page to preview a flow, script or app, choosing between proxy and direct mode and deciding whether the agent or the runtime starts the wmill dev server.

    18k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Windmill Rust Backend Patterns

    windmill-labs/windmill

    Sets Rust conventions for the Windmill backend: error types, SQLx queries, JSON handling, async rules, module layout and rust-analyzer navigation.

    18k GitHub stars~869 tokensUpdated today
    Auto-check passed

Categories

Questions about Draft PR with CI Rounds

What does Draft PR with CI Rounds do?

Opens a draft GitHub pull request with a conventional title and explicit body, then drives CI review rounds before marking it ready. This skill opens a draft GitHub pull request for the current branch and drives it through CI review rounds until it is ready. It analyzes the commits since the branch diverged from main, pushes to the remote, creates the PR as a draft and flips it to ready only once every review verdict is a go.

When should I use Draft PR with CI Rounds?

Draft PR with CI Rounds fits situations like: opening a pull request for the current branch; writing a conventional-commit PR title and a clear change summary; adding screenshots of affected UI to a frontend PR; driving CI review rounds until every verdict is a go.

How do I install Draft PR with CI Rounds in Claude Code?

Run `npx skills add windmill-labs/windmill --skill pr -a claude-code`. Or copy the skill folder (.agents/skills/pr in windmill-labs/windmill) into .claude/skills/pr in your project. Claude Code loads it when a task matches its description.

How do I install Draft PR with CI Rounds in Codex?

Run `npx skills add windmill-labs/windmill --skill pr -a codex`. Or copy the skill folder (.agents/skills/pr in windmill-labs/windmill) into .agents/skills/pr in your project. Codex loads it when a task matches its description.

Can I use Draft PR with CI Rounds 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 windmill-labs/windmill --skill pr -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pr, .gemini/skills/pr, .github/skills/pr and .opencode/skills/pr in your project.

What does Draft PR with CI Rounds need to run?

Going by SKILL.md and its folder, Draft PR with CI Rounds needs a shell for the scripts in its folder and the command-line tools its instructions call (git, gh, bash, jq and cargo). Our summary lists: GitHub CLI (gh), authenticated; Playwright MCP for UI screenshots.

Does Draft PR with CI Rounds access the network?

SKILL.md names 1 domain. In commands or code: raw.githubusercontent.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Draft PR with CI Rounds 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 Draft PR with CI Rounds use?

Draft PR with CI Rounds has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Draft PR with CI Rounds use?

About 3.4k tokens (SKILL.md is roughly 14k 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 Draft PR with CI Rounds?

Skills that share tags, products or a category with Draft PR with CI Rounds: PR Finalize Review (microsoft/garnet, 12k stars), React Router Pull Request Creator (remix-run/react-router, 57k stars), Verdaccio Pull Request Workflow (verdaccio/verdaccio, 18k stars) and Gh PR Metadata (module-federation/core, 2.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Draft PR with CI Rounds?

windmill-labs (a GitHub organization) maintains it in windmill-labs/windmill, which has 18,117 GitHub stars. The repository holds 42 skills in this directory. The repository was last updated on October 7, 2026.

Source: windmill-labs/windmill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.