New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Pp Gumroad

by mvanhorn in mvanhorn/printing-press-library

Gumroad's seller API as an agent-ready CLI and MCP server. An agent skill from mvanhorn/printing-press-library.

Apache-2.0Auto-check: notesAgent Workflows

Install Pp Gumroad

skills CLI
$ npx skills add mvanhorn/printing-press-library --skill pp-gumroad -a claude-code

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

GitHub CLI
$ gh skill install mvanhorn/printing-press-library pp-gumroad --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/mvanhorn/printing-press-library.git skills-src && mkdir -p .claude/skills && cp -r skills-src/cli-skills/pp-gumroad .claude/skills/pp-gumroad && 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
pp-gumroad
GitHub stars
2.1k
Token cost
~3k tokens
SKILL.md length
1,285 words
Files
1
Skills in repo
506
Repo updated
First seen
Licence
Apache-2.0

At a glance

Gumroad's seller API as an agent-ready CLI and MCP server. An agent skill from mvanhorn/printing-press-library.

  • Works in 3 steps: Install via the Printing Press… → Verify: gumroad-pp-cli --version → Ensure the reported install directory is…
  • Phrases: gumroad products
  • SKILL.md covers Prerequisites: Install the CLI, When to Use This CLI, Unique Capabilities and Command Reference, plus 10 more sections
  • Calls claude, npx and go; needs GUMROAD_ACCESS_TOKEN

What it does

Pp Gumroad is an agent skill from mvanhorn/printing-press-library. Gumroad's seller API as an agent-ready CLI and MCP server. Trigger phrases: gumroad products, gumroad sales, gumroad payouts, gumroad subscribers, verify gumroad license, gumroad offer codes.

Its SKILL.md is about 3k 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 Agent Workflows. It works with Model Context Protocol. The repository describes itself as: Official library of CLIs generated by the CLI Printing Press. Endorsed, tested, and community-contributed. The licence is Apache-2.0.

When your agent uses it

  • Phrases: gumroad products
  • Gumroad payouts
  • Gumroad subscribers
  • Verify gumroad license

Example prompts

  • “/pp-gumroad”

Requirements

  • Node.js
  • A credential in GUMROAD_ACCESS_TOKEN
  • Pre-approved tools (allowed-tools): Read, Bash

Workflow steps

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

  1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and…
  2. Verify: gumroad-pp-cli --version
  3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

What it can do on your machine

Read from SKILL.md and the folder at commit d9a1696. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Bash

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • claude
    • npx
    • go

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

  • Network

    No URLs in SKILL.md. Its commands use npx, 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:

    • GUMROAD_ACCESS_TOKEN

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

Context cost

Pp Gumroad loads about 3k tokens when it runs. Until then it costs about 54 tokens; SKILL.md has 1,285 words of instructions outside code blocks.

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

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

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Bash

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 mvanhorn/printing-press-library at commit d9a1696, republished under its Apache-2.0 licence (© mvanhorn). 1,285 words, ~3,045 tokens.

Download SKILL.mdSave it as .claude/skills/pp-gumroad/SKILL.md (or your agent's skills folder).
name
pp-gumroad
description
Gumroad's seller API as an agent-ready CLI and MCP server. Trigger phrases: `gumroad products`, `gumroad sales`, `gumroad payouts`, `gumroad subscribers`, `verify gumroad license`, `gumroad offer codes`.
allowed-tools
Read, Bash
author
Bheem Reddy
license
Apache-2.0
argument-hint
<command> [args] | install cli|mcp
<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/commerce/gumroad/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

Gumroad — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the gumroad-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

  1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:
    bash
    npx -y @mvanhorn/printing-press-library install gumroad --cli-only
  2. Verify: gumroad-pp-cli --version
  3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer):

bash
go install github.com/mvanhorn/printing-press-library/library/commerce/gumroad/cmd/gumroad-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

When to Use This CLI

Use this skill when the user asks to inspect or operate a Gumroad seller account, especially products, sales, subscribers, payouts, licenses, offer codes, or tax data. Prefer sync/search/analytics for broad questions and direct endpoint commands for a specific object or mutation.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Local seller intelligence

  • sync --resources products,sales,subscribers,payouts --latest-only --json — Refresh a local SQLite snapshot of the seller-facing Gumroad resources that agents inspect most often.

    Use this before research or reporting tasks so later searches and analytics are grounded in one consistent seller snapshot.

    bash
    gumroad-pp-cli sync --resources products,sales,subscribers,payouts --latest-only --json

  • search — Search locally synced products, sales, subscribers, payouts, and tax records through one command.

    Use this when the user remembers a buyer, product, license, or payout clue but not the exact Gumroad object ID.

    bash
    gumroad-pp-cli search "annual plan" --data-source local --json --limit 20

  • analytics — Group and count synced Gumroad records locally for fast summaries without additional API traffic.

    Use this for lightweight revenue, subscriber, product, and payout triage after a sync.

    bash
    gumroad-pp-cli analytics --type sales --group-by product_id --limit 10 --json
Operational monitoring

  • tail — Poll selected Gumroad resources and emit NDJSON changes for scripts or agent monitors.

    Use this for one-off checks after a launch, refund, payout, or product update.

    bash
    gumroad-pp-cli tail --resource sales --interval 30s --json

Command Reference

earnings — Manage earnings

  • gumroad-pp-cli earnings — Retrieve an annual earnings breakdown for the authenticated user. Requires view_tax_data scope.

files — Manage files

  • gumroad-pp-cli files abort — Cancel a multipart upload started by /files/presign. Requires edit_products scope.
  • gumroad-pp-cli files complete — Finalize a multipart upload started by /files/presign. Requires edit_products scope.
  • gumroad-pp-cli files presign — Start a multipart upload and return presigned URLs for each part. Requires edit_products scope.

licenses — Manage licenses

  • gumroad-pp-cli licenses decrement-uses-count — Decrement the uses count of a license. Requires edit_products scope.
  • gumroad-pp-cli licenses disable — Disable a license. Requires edit_products scope.
  • gumroad-pp-cli licenses enable — Enable a license. Requires edit_products scope.
  • gumroad-pp-cli licenses rotate — Rotate a license key. The old key will no longer be valid. Requires edit_products scope.
  • gumroad-pp-cli licenses verify — Verify a license key.

payouts — Manage payouts

  • gumroad-pp-cli payouts get — Retrieve details of a payout. Requires view_payouts scope.
  • gumroad-pp-cli payouts get-upcoming — Retrieve upcoming payouts. Requires view_payouts scope.
  • gumroad-pp-cli payouts list — Retrieve payouts for the authenticated user. Requires view_payouts scope.

products — Manage products

  • gumroad-pp-cli products create — Create a new product as a draft. Requires edit_products or account scope.
  • gumroad-pp-cli products delete — Permanently delete a product.
  • gumroad-pp-cli products get — Retrieve details of a product.
  • gumroad-pp-cli products list — Retrieve all existing products for the authenticated user.
  • gumroad-pp-cli products update — Update an existing product. Collection fields such as files, tags, and rich_content replace the full collection.

resource-subscriptions — Manage resource subscriptions

  • gumroad-pp-cli resource-subscriptions create — Subscribe to a resource webhook. Requires view_sales scope.
  • gumroad-pp-cli resource-subscriptions delete — Unsubscribe from a resource.
  • gumroad-pp-cli resource-subscriptions list — Show active subscriptions for the input resource. Requires view_sales scope.

sales — Manage sales

  • gumroad-pp-cli sales get — Retrieve details of a sale. Requires view_sales scope.
  • gumroad-pp-cli sales list — Retrieve successful sales by the authenticated user. Requires view_sales scope.

subscribers — Manage subscribers

  • gumroad-pp-cli subscribers <id> — Retrieve details of a subscriber. Requires view_sales scope.

tax-forms — Manage tax forms

  • gumroad-pp-cli tax-forms — Retrieve 1099 tax forms for the authenticated user. Requires view_tax_data scope.

user — Manage user

  • gumroad-pp-cli user — Retrieve the authenticated user's data.
Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

bash
gumroad-pp-cli which "<capability in your own words>"

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.

Recipes

List live products
bash
gumroad-pp-cli products list --agent

Returns compact JSON for the authenticated seller's products.

Find a buyer or license locally
bash
gumroad-pp-cli search "customer query" --data-source local --json

Searches previously synced seller data without making additional API calls.

Review payout history
bash
gumroad-pp-cli payouts list --after 2026-01-01 --agent

Reads payout records with pagination metadata when the token has view_payouts scope.

Show full SKILL.md (555 more words)Show less

Auth Setup

Create a Gumroad OAuth application, authorize it with the scopes needed for your workflow, and provide the resulting access token as GUMROAD_ACCESS_TOKEN. The MCP bundle exposes this as a sensitive user configuration value.

Run gumroad-pp-cli doctor to verify setup.

Agent Mode

Add --agent to any command. Expands to: --json --compact --no-input --no-color --yes.

  • Pipeable — JSON on stdout, errors on stderr

  • Filterable — --select keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:

    bash
    gumroad-pp-cli earnings --year 42 --agent --select id,name,status

  • Previewable — --dry-run shows the request without sending

  • Offline-friendly — sync/search commands can use the local SQLite store when available

  • Non-interactive — never prompts, every input is a flag

  • Explicit retries — use --idempotent only when an already-existing create should count as success, and --ignore-missing only when a missing delete target should count as success

Response envelope

Commands that read from the local store or the API wrap output in a provenance envelope:

json
{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

Parse .results for data and .meta.source to know whether it's live or local. A human-readable N results (live) summary is printed to stderr only when stdout is a terminal — piped/agent consumers get pure JSON on stdout.

Agent Feedback

When you (or the agent) notice something off about this CLI, record it:

gumroad-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
gumroad-pp-cli feedback --stdin < notes.txt
gumroad-pp-cli feedback list --json --limit 10

Entries are stored locally at ~/.gumroad-pp-cli/feedback.jsonl. They are never POSTed unless GUMROAD_FEEDBACK_ENDPOINT is set AND either --send is passed or GUMROAD_FEEDBACK_AUTO_SEND=true. Default behavior is local-only.

Write what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.

Output Delivery

Every command accepts --deliver <sink>. The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:

SinkEffect
stdoutDefault; write to stdout only
file:<path>Atomically write output to <path> (tmp + rename)
webhook:<url>POST the output body to the URL (application/json or application/x-ndjson when --compact)

Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.

Named Profiles

A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.

gumroad-pp-cli profile save briefing --json
gumroad-pp-cli --profile briefing earnings --year 42
gumroad-pp-cli profile list --json
gumroad-pp-cli profile show briefing
gumroad-pp-cli profile delete briefing --yes

Explicit flags always win over profile values; profile values win over defaults. agent-context lists all available profiles under available_profiles so introspecting agents discover them at runtime.

Exit Codes

CodeMeaning
0Success
2Usage error (wrong arguments)
3Resource not found
4Authentication required
5API error (upstream issue)
7Rate limited (wait and retry)
10Config error

Argument Parsing

Parse $ARGUMENTS:

  1. Empty, help, or --help → show gumroad-pp-cli --help output
  2. Starts with install → ends with mcp → MCP installation; otherwise → see Prerequisites above
  3. Anything else → Direct Use (execute as CLI command with --agent)

MCP Server Installation

Install the MCP binary from this CLI's published public-library entry or pre-built release, then register it:

bash
claude mcp add gumroad-pp-mcp -- gumroad-pp-mcp

Verify: claude mcp list

Direct Use

  1. Check if installed: which gumroad-pp-cli If not found, offer to install (see Prerequisites at the top of this skill).
  2. Match the user query to the best command from the Unique Capabilities and Command Reference above.
  3. Execute with the --agent flag:
    bash
    gumroad-pp-cli <command> [subcommand] [args] --agent
  4. If ambiguous, drill into subcommand help: gumroad-pp-cli <command> --help.

© mvanhorn, Apache-2.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 cli-skills/pp-gumroad of mvanhorn/printing-press-library.

Open the folder on GitHubat commit d9a1696

Compare with similar skills

Pp Gumroad 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.

Pp Gumroad compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pp Gumroad this skillmvanhorn/printing-press-library2.1k—~3kAutomated safety check: NotesApache-2.0
MCP Server Builderanthropics/skills180k63 repos~2.3kAutomated safety check: PassApache-2.0
MCP Server BuildershareAI-lab/learn-claude-code78k4 repos~1.2kAutomated safety check: PassMIT
MCP Integration for Pluginsanthropics/claude-plugins-official38k11 repos~3.1kAutomated safety check: PassApache-2.0
MemPalace Memory SearchMemPalace/mempalace59k—~1.4kAutomated safety check: PassMIT
Crush Configurationcharmbracelet/crush29k—~3.7kAutomated safety check: PassCustom licence

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 63 repos~2.3k tokens
    Agent WorkflowsAuto-check passed

  • MCP Server Builder

    shareAI-lab/learn-claude-code

    Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.

    78k GitHub starsUsed in 4 repos~1.2k tokens
    Agent WorkflowsAuto-check passed

  • MCP Integration for Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to bundle Model Context Protocol servers in a Claude Code plugin, covering config files, stdio, SSE, HTTP and WebSocket server types, and authentication.

    38k GitHub starsUsed in 11 repos~3.1k tokens
    Agent WorkflowsAuto-check passed

  • MemPalace Memory Search

    MemPalace/mempalace

    Mines project files and conversation exports into a local, searchable memory palace and recalls past work by semantic search through the mempalace CLI.

    59k GitHub stars~1.4k tokensUpdated today
    Agent WorkflowsAuto-check passed

  • Crush Configuration

    charmbracelet/crush

    Explains how to configure the Crush coding agent with crushrc or crush.json, covering providers, models, LSPs, MCP servers, hooks, permissions and config precedence.

    29k GitHub stars~3.7k tokensUpdated today
    Agent WorkflowsAuto-check passed

  • Context Mode Output Sandbox

    mksglu/context-mode

    Routes large command, file, API and browser output through context-mode tools so only the needed result enters the agent's context, instead of dumping it via Bash.

    26k GitHub stars~4.1k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from mvanhorn/printing-press-library

All 506 skills in this repo

  • Agent Desktop

    mvanhorn/printing-press-library

    Desktop automation through the real Rust agent-desktop CLI, published in Printing Press through a small bridge.

    2.1k GitHub stars~2.3k tokensUpdated today
    Auto-check: notes

  • Gfonts

    mvanhorn/printing-press-library

    Search, browse, and download Google Fonts from the terminal via the gfonts CLI.

    2.1k GitHub stars~574 tokensUpdated today
    Auto-check passed

  • Pp 1688

    mvanhorn/printing-press-library

    The free, offline Trigger phrases: search 1688 for, find a factory on 1688 for, wholesale price on 1688 for, who is the cheapest supplier on 1688 for, compare 1688 suppliers for, use 1688, run 1688.

    2.1k GitHub stars~3k tokensUpdated today
    Auto-check: notes

  • Pp Activity Japan

    mvanhorn/printing-press-library

    Inspect known Activity Japan plan IDs or URLs, compare dated prices and sessions, check language-sitemap coverage, and hand off to canonical booking pages.

    2.1k GitHub stars~2k tokensUpdated today
    Auto-check: notes

  • Pp Adminbyrequest

    mvanhorn/printing-press-library

    Every Admin By Request portal action, plus a local SQLite mirror of audit, events, inventory and requests for ad-hoc...

    2.1k GitHub stars~3.3k tokensUpdated today
    Auto-check: notes

  • Pp Agent Capture

    mvanhorn/printing-press-library

    macOS screen capture, window recording, GIF conversion, and agent evidence bundles from the terminal.

    2.1k GitHub stars~1.6k tokensUpdated today
    Auto-check: notes

Works with

Categories

Questions about Pp Gumroad

What does Pp Gumroad do?

Gumroad's seller API as an agent-ready CLI and MCP server. An agent skill from mvanhorn/printing-press-library. Pp Gumroad is an agent skill from mvanhorn/printing-press-library. Gumroad's seller API as an agent-ready CLI and MCP server.

When should I use Pp Gumroad?

Pp Gumroad fits situations like: phrases: gumroad products; gumroad payouts; gumroad subscribers; verify gumroad license.

How do I install Pp Gumroad in Claude Code?

Run `npx skills add mvanhorn/printing-press-library --skill pp-gumroad -a claude-code`. Or copy the skill folder (cli-skills/pp-gumroad in mvanhorn/printing-press-library) into .claude/skills/pp-gumroad in your project. Claude Code loads it when a task matches its description.

How do I install Pp Gumroad in Codex?

Run `npx skills add mvanhorn/printing-press-library --skill pp-gumroad -a codex`. Or copy the skill folder (cli-skills/pp-gumroad in mvanhorn/printing-press-library) into .agents/skills/pp-gumroad in your project. Codex loads it when a task matches its description.

Can I use Pp Gumroad 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 mvanhorn/printing-press-library --skill pp-gumroad -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pp-gumroad, .gemini/skills/pp-gumroad, .github/skills/pp-gumroad and .opencode/skills/pp-gumroad in your project.

What does Pp Gumroad need to run?

Going by SKILL.md and its folder, Pp Gumroad needs the command-line tools its instructions call (claude, npx and go) and credentials named GUMROAD_ACCESS_TOKEN. Our summary lists: Node.js; A credential in GUMROAD_ACCESS_TOKEN. Its frontmatter pre-approves these tools: Read, Bash.

Does Pp Gumroad access the network?

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

Is Pp Gumroad safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Pp Gumroad use?

Pp Gumroad is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Pp Gumroad use?

About 3k tokens (SKILL.md is roughly 12k 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 Pp Gumroad?

Skills that share tags, products or a category with Pp Gumroad: MCP Server Builder (anthropics/skills, 180k stars), MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars), MCP Integration for Plugins (anthropics/claude-plugins-official, 38k stars) and MemPalace Memory Search (MemPalace/mempalace, 59k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pp Gumroad?

mvanhorn (a GitHub user) maintains it in mvanhorn/printing-press-library, which has 2,056 GitHub stars. The repository holds 506 skills in this directory. The repository was last updated on October 9, 2026.

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