Agent skill

Open PR

by polarsource in polarsource/polar

Open or update a draft GitHub pull request after Polar-specific review and cubic CLI review.

MITAuto-check passedData & Analytics

Install Open PR

skills CLI
$ npx skills add polarsource/polar --skill open-pr -a claude-code

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

GitHub CLI
$ gh skill install polarsource/polar open-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/polarsource/polar.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/open-pr .claude/skills/open-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
open-pr
GitHub stars
10k
Token cost
~586 tokens
SKILL.md length
282 words
Files
1
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

Open or update a draft GitHub pull request after Polar-specific review and cubic CLI review.

  • Works in 5 steps: Preconditions → Polar code review → Cubic CLI review → …
  • Invokes open-pr
  • SKILL.md covers 1. Preconditions, 2. Polar code review, 3. Cubic CLI review and 4. Open the draft, plus 1 more section
  • Calls uv, pnpm and git; needs CUBIC_API_KEY

What it does

Open PR is an agent skill from polarsource/polar. Open or update a draft GitHub pull request after Polar-specific review and cubic CLI review. Use only when the user invokes open-pr, /open-pr, or $open-pr by name. Do not use for a plain request to open a PR, or for a host Create PR button.

Its SKILL.md is about 590 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 Data & Analytics, covering Pull requests and DataFrames. It works with GitHub. The repository describes itself as: Polar — A billing platform for the intelligence era. The licence is MIT.

When your agent uses it

  • Invokes open-pr
  • $open-pr by name
  • A plain request to open a PR
  • For a host Create PR button

Example prompts

  • “/open-pr”

Requirements

  • A credential in CUBIC_API_KEY

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Preconditions
  2. Polar code review
  3. Cubic CLI review
  4. Open the draft
  5. Reply

What it can do on your machine

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

    • uv
    • pnpm
    • git
    • gh

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

  • Network

    No URLs in SKILL.md. Its commands use uv, pnpm, git and gh, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • CUBIC_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Open PR loads about 586 tokens when it runs. Until then it costs about 62 tokens; SKILL.md has 282 words of instructions outside code blocks.

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

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 polarsource/polar at commit 599c727, republished under its MIT licence (© polarsource). 282 words, ~586 tokens.

Download SKILL.mdSave it as .claude/skills/open-pr/SKILL.md (or your agent's skills folder).
name
open-pr
description
Open or update a draft GitHub pull request after Polar-specific review and cubic CLI review. Use only when the user invokes open-pr, /open-pr, or $open-pr by name. Do not use for a plain request to open a PR, or for a host Create PR button.
license
MIT
metadata.author
polar
metadata.version
1.0.0

Open PR

Open or update a draft pull request. Do not mark it ready for review.

This is not a bug hunt and not a security review. /code-review, /security-review, and /simplify do those. Do not run Cursor /review here.

Address every review comment by default (Polar, cubic CLI, cubic GitHub, humans). Fix, commit, push, rerun that step. Dispute only when the comment is factually wrong.

1. Preconditions

  • Working tree committed. Branch pushed. git fetch origin main.
  • Lint, type-check, and tests pass:
    • Backend: cd server && uv run task lint && uv run task lint_types && uv run task test_fast
    • Frontend: clients/AGENTS.md (pnpm lint, pnpm typecheck, scoped tests)
  • PR body: no PII, stats, or org information. PRs are public.
  • Title from the user or the diff. Body:
# Summary

👇 LLM generated

<what this PR does>

## What

## Why

## How

## Checklist

Fill the headings from .github/pull_request_template.md.

If lint or tests fail, stop. Do not review or open a PR.

2. Polar code review

Read .agents/skills/polar-code-review/SKILL.md and follow it exactly.

Address every finding (🔴, 🟠, 🟡, 🧹). Then rerun this step.

3. Cubic CLI review

If CUBIC_API_KEY is unset, skip this step and say so. Do not fail closed.

Otherwise:

bash
cubic review --base origin/main --json

Address every finding. If the diff changed, rerun step 2. Repeat until clean or only disputed issues remain. Exit code 1 means work to do, not a skip.

4. Open the draft

Create or update a draft PR.

  • GitHub CLI: gh pr create --draft, or update the existing PR
  • Cursor cloud: ManagePullRequest with draft: true

After the PR exists, pull review comments and address them the same way.

5. Reply

Exactly this. Nothing else.

Done
<summary>
<summary>
PR link: <url>

Failed instead of Done if you stopped (lint, tests, or an unfixed comment). Two-line summary of what shipped or why it failed. Omit the PR line only if no PR exists.

© polarsource, 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/open-pr of polarsource/polar.

Open the folder on GitHubat commit 599c727

Compare with similar skills

Open PR 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.

Open PR compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Open PR this skillpolarsource/polar10k—~586Automated safety check: PassMIT
Owid Catalogowid/etl158—~2.3kAutomated safety check: PassMIT
Firecrawl Developer Indexfirecrawl/skills115—~2kAutomated safety check: PassISC
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Check PRonyx-dot-app/onyx32k2 repos~2.3kAutomated safety check: PassMIT
Contributor-First PR MergeHKUDS/OpenHarness16k1 repos~847Automated safety check: PassMIT

Similar skills

  • Owid Catalog

    owid/etl

    Access Our World in Data from Python with the owid-catalog library: load chart data, catalog tables or individual indicators as pandas DataFrames that carry their own units, descriptions, sources…

    158 GitHub stars~2.3k tokensUpdated today
    Data & AnalyticsAuto-check passed
  • Search an index of public repositories, GitHub issues, merged pull requests, repository READMEs, and curated documentation sites.

    115 GitHub stars~2k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • 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.

    69k GitHub starsUsed in 3 repos~4.2k tokens
    DevelopmentAuto-check passed
  • Check PR

    onyx-dot-app/onyx

    Checks a GitHub, GitLab, or Perforce (p4) pull request (or merge request, or shelved changelist) for unresolved review comments, failing status checks, and incomplete PR descriptions.

    32k GitHub starsUsed in 2 repos~2.3k tokens
    DevelopmentAuto-check passed
  • Merges external GitHub pull requests while keeping the original author credited, and fixes conflicts after the merge instead of rewriting the contribution.

    16k GitHub starsUsed in 1 repo~847 tokens
    DevelopmentAuto-check passed
  • Opens a GitHub pull request from your current branch with the gh CLI, after reviewing the commits and diff and gathering the details the PR needs.

    70k GitHub starsUsed in 1 repo~1.6k tokens
    DevelopmentAuto-check passed

More from polarsource/polar

All 18 skills in this repo
  • Polar Python SDK

    polarsource/polar

    Integrate Polar billing in server-side Python applications using the versioned Polar and PolarAsync clients.

    10k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Polar Typescript SDK

    polarsource/polar

    Integrate Polar billing in server-side TypeScript applications using the versioned createPolar and createPolarCore clients.

    10k GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Adr Check

    polarsource/polar

    Check a code change against the repo's Accepted Architecture Decision Records (ADRs) in handbook/engineering/decisions/ and report violations with citations.

    10k GitHub stars~771 tokensUpdated today
    Auto-check passed
  • API Surface Review

    polarsource/polar

    Review changes to Polar's API contract — Pydantic schemas, FastAPI endpoints, OpenAPI output and the generated SDKs.

    10k GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Billing Review

    polarsource/polar

    Review a diff that touches Polar's billing domain — subscriptions, cycles and crons, orders, billing entries, meters and usage, discounts, checkout, payments and dunning, refunds, disputes, payouts…

    10k GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Interview Task

    polarsource/polar

    Prepare an interview task for a candidate, as part of our hiring process.

    10k GitHub stars~933 tokensUpdated today
    Auto-check passed

Works with

Questions about Open PR

What does Open PR do?

Open or update a draft GitHub pull request after Polar-specific review and cubic CLI review. Open PR is an agent skill from polarsource/polar. Open or update a draft GitHub pull request after Polar-specific review and cubic CLI review.

When should I use Open PR?

Open PR fits situations like: invokes open-pr; $open-pr by name; A plain request to open a PR; for a host Create PR button.

How do I install Open PR in Claude Code?

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

How do I install Open PR in Codex?

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

Can I use Open PR 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 polarsource/polar --skill open-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/open-pr, .gemini/skills/open-pr, .github/skills/open-pr and .opencode/skills/open-pr in your project.

What does Open PR need to run?

Going by SKILL.md and its folder, Open PR needs the command-line tools its instructions call (uv, pnpm, git and gh) and credentials named CUBIC_API_KEY. Our summary lists: A credential in CUBIC_API_KEY.

Does Open PR access the network?

SKILL.md contains no URLs. Its commands use uv, git and gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Open PR 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 Open PR use?

Open PR is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Open PR use?

About 586 tokens (SKILL.md is roughly 2.3k 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 Open PR?

Skills that share tags, products or a category with Open PR: Owid Catalog (owid/etl, 158 stars), Firecrawl Developer Index (firecrawl/skills, 115 stars), PR Babysitter (openinterpreter/openinterpreter, 69k stars) and Check PR (onyx-dot-app/onyx, 32k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Open PR?

polarsource (a GitHub organization) maintains it in polarsource/polar, which has 10,336 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on October 7, 2026.

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