Agent skill

Setup Polar

by chmonitor in chmonitor/chmonitor

Interactive onboarding wizard to set up Polar payment integration from scratch.

GPL-3.0Auto-check: warningsData & Analytics

Install Setup Polar

The automated check flagged lines worth reading first. See the safety section below.

skills CLI
$ npx skills add chmonitor/chmonitor --skill setup-polar -a claude-code

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

GitHub CLI
$ gh skill install chmonitor/chmonitor setup-polar --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/chmonitor/chmonitor.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/setup-polar .claude/skills/setup-polar && 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
setup-polar
GitHub stars
298
Token cost
~1.1k tokens
SKILL.md length
459 words
Files
1
Skills in repo
53
Repo updated
First seen
Licence
GPL-3.0

At a glance

Interactive onboarding wizard to set up Polar payment integration from scratch.

  • Works in 9 steps: Check MCP Availability → Install Polar MCP → Gather Project Context → …
  • User wants to set up Polar
  • Calls claude and ngrok; reaches mcp.polar.sh and abc123.ngrok.io; needs POLAR_ACCESS_TOKEN and POLAR_WEBHOOK_SECRET
  • Integrate Polar in their project

What it does

Setup Polar is an agent skill from chmonitor/chmonitor. Interactive onboarding wizard to set up Polar payment integration from scratch. Use this skill when: (1) User wants to "set up Polar" or "integrate Polar" in their project; (2) User is starting fresh with Polar and needs guided setup; (3) User asks "how do I get started with Polar"; (4) User wants to add payments/subscriptions/checkout to their app using Polar; (5) User needs help creating their first Polar product and checkout. This skill walks through MCP installation, authentication, product creation, and…

Its SKILL.md is about 1.1k 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 DataFrames and Payments and billing. It works with Model Context Protocol. The repository describes itself as: Open-source operational advisor for ClickHouse — real-time monitoring plus AI-driven index/partition/materialized-view recommendations. The licence is GPL-3.0.

When your agent uses it

  • User wants to set up Polar
  • Integrate Polar in their project
  • User is starting fresh with Polar and needs guided setup
  • User asks how do I get started with Polar

Example prompts

  • “set up Polar”
  • “integrate Polar”
  • “how do I get started with Polar”
  • “/setup-polar”

Requirements

  • A credential in POLAR_ACCESS_TOKEN
  • A credential in POLAR_WEBHOOK_SECRET

Workflow steps

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

  1. Check MCP Availability
  2. Install Polar MCP
  3. Gather Project Context
  4. Create Organization (if needed)
  5. Create First Product
  6. Generate Integration Code
  7. Set Up Webhooks
  8. Test the Integration
  9. Next Steps

What it can do on your machine

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

    • claude
    • ngrok

    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:

    • mcp.polar.sh
    • abc123.ngrok.io

    Also links to:

    • sandbox.polar.sh
    • polar.sh

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

  • Credentials

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

    • POLAR_ACCESS_TOKEN
    • POLAR_WEBHOOK_SECRET

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

Context cost

Setup Polar loads about 1.1k tokens when it runs. Until then it costs about 143 tokens; SKILL.md has 459 words of instructions outside code blocks.

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

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: warnings

The automated check found patterns that need a careful read before installing.

  • WarningMentions a paste, webhook or tunnelling service often used to send data outSKILL.md:113
    py the ngrok URL (e.g., `https://abc123.ngrok.io`).

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 chmonitor/chmonitor at commit fc39ef0, republished under its GPL-3.0 licence (© chmonitor). 459 words, ~1,128 tokens.

Download SKILL.mdSave it as .claude/skills/setup-polar/SKILL.md (or your agent's skills folder).
name
setup-polar
description
Interactive onboarding wizard to set up Polar payment integration from scratch. Use this skill when: (1) User wants to "set up Polar" or "integrate Polar" in their project; (2) User is starting fresh with Polar and needs guided setup; (3) User asks "how do I get started with Polar"; (4) User wants to add payments/subscriptions/checkout to their app using Polar; (5) User needs help creating their first Polar product and checkout. This skill walks through MCP installation, authentication, product creation, and generates framework-specific integration code.

Polar Setup Wizard

Interactive setup guide to get Polar payments working in your project.

Setup Flow

Follow these steps in order:

Step 1: Check MCP Availability

First, check if the Polar MCP server is available. Try listing products or organizations using MCP tools.

If MCP tools work: Skip to Step 3.

If MCP not available: Continue to Step 2.

Step 2: Install Polar MCP

Guide the user to install the Polar MCP server based on their environment:

Claude Code:

bash
# Production
claude mcp add --transport http "Polar" "https://mcp.polar.sh/mcp/polar-mcp"

# Sandbox (recommended for setup)
claude mcp add --transport http "Polar Sandbox" "https://mcp.polar.sh/mcp/polar-sandbox"

Cursor (.cursor/mcp.json):

json
{
  "mcpServers": {
    "Polar Sandbox": {
      "url": "https://mcp.polar.sh/mcp/polar-sandbox"
    }
  }
}

After installation, the user must:

  1. Restart their editor/CLI
  2. Authenticate when prompted (redirects to polar.sh)

Once authenticated, verify MCP works by listing organizations.

Step 3: Gather Project Context

Ask the user:

  1. Framework: What framework are you using?

    • Next.js (App Router)
    • Next.js (Pages Router)
    • Express.js
    • FastAPI (Python)
    • Other
  2. Environment: Start with sandbox or production?

    • Sandbox (recommended for new setups)
    • Production
  3. Product type: What are you selling?

    • Subscription (recurring)
    • One-time purchase
    • Both
Step 4: Create Organization (if needed)

Use MCP to check if user has an organization. If not, guide them to create one at:

Step 5: Create First Product

Use MCP to create a test product. Example for subscription:

Create a product with:
- Name: "Pro Plan"
- Monthly price: $29
- Organization: [user's org]

Store the returned product ID for checkout integration.

Step 6: Generate Integration Code

Hand off to the polar-integration skill to generate the Checkout, Customer Portal, and Webhooks endpoints for the framework selected in Step 3. That skill has the canonical, framework-agnostic recipes plus per-framework variations.

Before invoking it, make sure the user has these environment variables ready (use whatever loader their framework provides):

bash
POLAR_ACCESS_TOKEN=    # from polar.sh/settings (or sandbox)
POLAR_WEBHOOK_SECRET=  # created in Step 7
POLAR_SERVER=sandbox   # omit or set to "production" when going live

Pass along the product ID from Step 5 so checkout links can be tested in Step 8.

Show full SKILL.md (186 more words)Show less
Step 7: Set Up Webhooks
  1. Start the local development server.
  2. Start ngrok against the dev server's port:
    bash
    ngrok http <port>
  3. Copy the ngrok URL (e.g., https://abc123.ngrok.io).

Use MCP to create a webhook endpoint, or guide the user to the dashboard:

  • Sandbox: https://sandbox.polar.sh → Settings → Webhooks
  • Add endpoint: https://[ngrok-url]/<webhook-path> (use the path from the route generated in Step 6).
  • Select events: order.paid, subscription.created, subscription.canceled.
  • Copy the webhook secret into the env var loader from Step 6.
Step 8: Test the Integration
  1. Start the dev server.
  2. Visit the checkout URL with the product ID from Step 5 (path and query shape come from the route generated in Step 6).
  3. Complete checkout using test card: 4242 4242 4242 4242.
  4. Verify the webhook was received in terminal logs.
  5. Check the success page displays correctly.
Step 9: Next Steps

Once basic setup works, suggest:

  1. Add customer portal - Let users manage subscriptions (Recipe 2 in polar-integration).
  2. Link to your auth - Pass externalCustomerId in checkout.
  3. Add benefits - License keys, file downloads, Discord roles.
  4. Go production - Switch POLAR_SERVER from sandbox to production.

© chmonitor, GPL-3.0. 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/setup-polar of chmonitor/chmonitor.

Open the folder on GitHubat commit fc39ef0

Compare with similar skills

Setup Polar 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.

Setup Polar compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Setup Polar this skillchmonitor/chmonitor298—~1.1kAutomated safety check: WarnGPL-3.0
Retentioneering Product Analyticsretentioneering/retentioneering-tools920—~1.6kAutomated safety check: PassApache-2.0
Investigate Datawalkthru-earth/geocoding-playground153—~935Automated safety check: PassCC-BY-4.0
Airtable Registermehta-lab/VisCy104—~1.9kAutomated safety check: PassBSD-3-Clause
Downloading Batch Export FilesPostHog/posthog-foss721—~2.4kAutomated safety check: PassMIT
Polar Python SDKpolarsource/polar10k—~1.8kAutomated safety check: PassApache-2.0

Similar skills

  • Retentioneering Product Analytics

    retentioneering/retentioneering-tools

    Analyze event logs, clickstreams, user paths, product funnels, retention, behavioral segments, transition graphs, step matrices, sequence patterns, and customer journeys using Retentioneering.

    920 GitHub stars~1.6k tokensUpdated yesterday
    Data & AnalyticsAuto-check passed
  • Investigate Data

    walkthru-earth/geocoding-playground

    Investigates geocoder data quality issues by querying live S3 parquet files via MotherDuck MCP.

    153 GitHub stars~935 tokensUpdated 3 mo ago
    Data & AnalyticsAuto-check passed
  • Airtable Register

    mehta-lab/VisCy

    Register zarr positions into the Computational Imaging Database on Airtable, write channelsmetadata/experimentmetadata to zarr .zattrs, or bulk-update Airtable records via MCP.

    104 GitHub stars~1.9k tokensUpdated today
    Data & AnalyticsAuto-check passed
  • Downloading Batch Export Files

    PostHog/posthog-foss

    Official

    Export PostHog events, persons, sessions, or the results of a HogQL query on demand and download the resulting files.

    721 GitHub stars~2.4k tokensUpdated today
    Data & AnalyticsAuto-check passed
  • 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
    Data & AnalyticsAuto-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
    Data & AnalyticsAuto-check passed

More from chmonitor/chmonitor

All 53 skills in this repo
  • Hyperframes Creative

    chmonitor/chmonitor

    Non-animation creative direction for HyperFrames videos. An agent skill from chmonitor/chmonitor.

    298 GitHub starsUsed in 5 repos~1.3k tokens
    Auto-check passed
  • Hyperframes Media

    chmonitor/chmonitor

    Audio and media assets for HyperFrames compositions, produced by one shared audio engine (scripts/audio.mjs) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound…

    298 GitHub starsUsed in 1 repo~2.8k tokens
    Auto-check: notes
  • Remotion To Hyperframes

    chmonitor/chmonitor

    Port an existing Remotion (React) composition to HyperFrames HTML.

    298 GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Music To Video

    chmonitor/chmonitor

    A skill your agent uses when the user has a music track (an audio file, or a video to pull audio from) and wants a beat-synced HyperFrames video, calm to hard-hitting.

    298 GitHub starsUsed in 1 repo~4k tokens
    Auto-check: notes
  • Hyperframes Animation

    chmonitor/chmonitor

    All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus…

    298 GitHub starsUsed in 2 repos~1.8k tokens
    Auto-check passed
  • Faceless Explainer

    chmonitor/chmonitor

    turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video, up to ~3 min (sweet spot 30-90s), where every visual is invented (typography, abstract graphics…

    298 GitHub stars~4.5k tokensUpdated 2 days ago
    Auto-check: notes

Questions about Setup Polar

What does Setup Polar do?

Interactive onboarding wizard to set up Polar payment integration from scratch. Setup Polar is an agent skill from chmonitor/chmonitor. Interactive onboarding wizard to set up Polar payment integration from scratch.

When should I use Setup Polar?

Setup Polar fits situations like: user wants to set up Polar; integrate Polar in their project; user is starting fresh with Polar and needs guided setup; user asks how do I get started with Polar.

How do I install Setup Polar in Claude Code?

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

How do I install Setup Polar in Codex?

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

Can I use Setup Polar 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 chmonitor/chmonitor --skill setup-polar -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/setup-polar, .gemini/skills/setup-polar, .github/skills/setup-polar and .opencode/skills/setup-polar in your project.

What does Setup Polar need to run?

Going by SKILL.md and its folder, Setup Polar needs the command-line tools its instructions call (claude and ngrok) and credentials named POLAR_ACCESS_TOKEN and POLAR_WEBHOOK_SECRET. Our summary lists: A credential in POLAR_ACCESS_TOKEN; A credential in POLAR_WEBHOOK_SECRET.

Does Setup Polar access the network?

SKILL.md names 4 domains. In commands or code: mcp.polar.sh and abc123.ngrok.io; the agent is likely to contact these when it follows the instructions. As links in the text: sandbox.polar.sh and polar.sh. This is read from the text; nothing was executed.

Is Setup Polar safe to install?

Our automated static check of SKILL.md flagged 1 warning(s): mentions a paste, webhook or tunnelling service often used to send data out. Read the flagged lines before installing; the check is not a guarantee either way.

What licence does Setup Polar use?

Setup Polar is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Setup Polar use?

About 1.1k tokens (SKILL.md is roughly 4.5k 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 Setup Polar?

Skills that share tags, products or a category with Setup Polar: Retentioneering Product Analytics (retentioneering/retentioneering-tools, 920 stars), Investigate Data (walkthru-earth/geocoding-playground, 153 stars), Airtable Register (mehta-lab/VisCy, 104 stars) and Downloading Batch Export Files (PostHog/posthog-foss, 721 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Setup Polar?

chmonitor (a GitHub organization) maintains it in chmonitor/chmonitor, which has 298 GitHub stars. The repository holds 53 skills in this directory. The repository was last updated on October 5, 2026.

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