Agent skill

Pp Shopify

by mvanhorn in mvanhorn/printing-press-library

Operate a Shopify store from the terminal with local sync, analytics, and bulk exports.

Apache-2.0Auto-check: notesBackend & APIs

Install Pp Shopify

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

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

GitHub CLI
$ gh skill install mvanhorn/printing-press-library pp-shopify --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-shopify .claude/skills/pp-shopify && 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-shopify
GitHub stars
2.1k
Token cost
~3.1k tokens
SKILL.md length
1,317 words
Files
1
Skills in repo
505
Repo updated
First seen
Licence
Apache-2.0

At a glance

Operate a Shopify store from the terminal with local sync, analytics, and bulk exports.

  • Works in 3 steps: Install via the Printing Press… → Verify: shopify-pp-cli --version → Ensure the reported install directory is…
  • Tasks that involve E-commerce operations
  • SKILL.md covers Prerequisites: Install the CLI, When Not to Use This CLI, Command Reference and Freshness Contract, plus 10 more sections
  • Calls go, claude and npx; needs SHOPIFY_ACCESS_TOKEN

What it does

Pp Shopify is an agent skill from mvanhorn/printing-press-library. Operate a Shopify store from the terminal with local sync, analytics, and bulk exports.

Its SKILL.md is about 3.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 Backend & APIs, covering E-commerce operations. It works with Shopify and GraphQL. 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

  • Tasks that involve E-commerce operations

Example prompts

  • “/pp-shopify”

Requirements

  • Node.js
  • A credential in SHOPIFY_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: shopify-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 0fdcc7a. 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:

    • go
    • claude
    • npx

    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:

    • SHOPIFY_ACCESS_TOKEN

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

Context cost

Pp Shopify loads about 3.1k tokens when it runs. Until then it costs about 25 tokens; SKILL.md has 1,317 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~25
When it runs · the whole SKILL.md, loaded when a task matches
~3.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: 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 0fdcc7a, republished under its Apache-2.0 licence (© mvanhorn). 1,317 words, ~3,102 tokens.

Download SKILL.mdSave it as .claude/skills/pp-shopify/SKILL.md (or your agent's skills folder).
name
pp-shopify
description
Operate a Shopify store from the terminal with local sync, analytics, and bulk exports.
allowed-tools
Read, Bash
author
Cathryn Lavery
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/shopify/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/". -->

Shopify — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the shopify-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 shopify --cli-only
  2. Verify: shopify-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/shopify/cmd/shopify-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 Not to Use This CLI

Do not activate this CLI for requests that require creating, updating, deleting, publishing, commenting, upvoting, inviting, ordering, sending messages, booking, purchasing, or changing remote state. This printed CLI exposes read-only commands for inspection, export, sync, and analysis.

Command Reference

abandoned-checkouts — Shopify abandoned checkouts for recovery campaigns and lost-cart analysis.

  • shopify-pp-cli abandoned-checkouts get — Get one Shopify abandoned checkout by GraphQL ID.
  • shopify-pp-cli abandoned-checkouts list — List abandoned checkouts from the Shopify Admin GraphQL API.

customers — Shopify customers with lifetime order count, lifetime spend, and contact fields.

  • shopify-pp-cli customers get — Get one Shopify customer by GraphQL ID.
  • shopify-pp-cli customers list — List customers from the Shopify Admin GraphQL API.

fulfillment-orders — Shopify fulfillment orders for lag, routing, and fulfillment-state analysis.

  • shopify-pp-cli fulfillment-orders get — Get one Shopify fulfillment order by GraphQL ID.
  • shopify-pp-cli fulfillment-orders list — List fulfillment orders from the Shopify Admin GraphQL API.

inventory-items — Shopify inventory items with tracked status and available quantities by location.

  • shopify-pp-cli inventory-items get — Get one Shopify inventory item by GraphQL ID.
  • shopify-pp-cli inventory-items list — List inventory items from the Shopify Admin GraphQL API.

orders — Shopify orders with money totals, financial state, and fulfillment state.

  • shopify-pp-cli orders get — Get one Shopify order by GraphQL ID.
  • shopify-pp-cli orders list — List orders from the Shopify Admin GraphQL API.

products — Shopify products with product status, catalog metadata, and a compact variant inventory projection.

  • shopify-pp-cli products get — Get one Shopify product by GraphQL ID.
  • shopify-pp-cli products list — List products from the Shopify Admin GraphQL API.

Freshness Contract

This printed CLI owns bounded freshness only for registered store-backed read command paths. In --data-source auto mode, those paths check sync_state and may run a bounded refresh before reading local data. --data-source local never refreshes. --data-source live reads the API and does not mutate the local store. Set SHOPIFY_NO_AUTO_REFRESH=1 to skip the freshness hook without changing source selection.

Covered paths:

  • shopify-pp-cli abandoned-checkouts
  • shopify-pp-cli abandoned-checkouts get
  • shopify-pp-cli abandoned-checkouts list
  • shopify-pp-cli abandoned-checkouts search
  • shopify-pp-cli customers
  • shopify-pp-cli customers get
  • shopify-pp-cli customers list
  • shopify-pp-cli customers search
  • shopify-pp-cli fulfillment-orders
  • shopify-pp-cli fulfillment-orders get
  • shopify-pp-cli fulfillment-orders list
  • shopify-pp-cli fulfillment-orders search
  • shopify-pp-cli inventory-items
  • shopify-pp-cli inventory-items get
  • shopify-pp-cli inventory-items list
  • shopify-pp-cli inventory-items search
  • shopify-pp-cli orders
  • shopify-pp-cli orders get
  • shopify-pp-cli orders list
  • shopify-pp-cli orders search
  • shopify-pp-cli products
  • shopify-pp-cli products get
  • shopify-pp-cli products list
  • shopify-pp-cli products search

When JSON output uses the generated provenance envelope, freshness metadata appears at meta.freshness. Treat it as current-cache freshness for the covered command path, not a guarantee of complete historical backfill or API-specific enrichment.

Finding the right command

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

bash
shopify-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.

Hand-written Extensions

These commands are declared by the spec author and require separate hand-written wiring; the generator does not emit Cobra registration for them. They are listed here for discoverability and are intentionally outside ## Command Reference so the verify-skill unknown-command check does not treat them as generator-owned paths.

  • shopify-pp-cli bulk-operations — Run, poll, and inspect Shopify Admin GraphQL bulk operations.
  • shopify-pp-cli store daily-brief — Executive daily brief with revenue, top products, risk checks, and suggested actions from the local store.
  • shopify-pp-cli store audit — Health score from refunds, fulfillment risk, shipping anomalies, and dead stock.
  • shopify-pp-cli growth campaign-brief — Data-backed campaign brief from top products, VIPs, and winback opportunities.
  • shopify-pp-cli growth winback-candidates — Rank idle customers by lifetime value and suggested winback angle.
  • shopify-pp-cli growth vip-segments — Segment high-value customers by spend, frequency, and recency.
  • shopify-pp-cli ops fulfillment-risk — Find open fulfillment orders older than a threshold.
  • shopify-pp-cli ops shipping-anomalies — Find free/missing/high shipping charges from synced shipping lines.
  • shopify-pp-cli merchandising bundle-opportunities — Suggest bundles from co-purchase lift and confidence.
  • shopify-pp-cli merchandising dead-stock-actions — Turn stock with no recent sales into markdown/bundle actions.
  • shopify-pp-cli merchandising launch-brief — Build a launch/relaunch brief for a product from local evidence.
Show full SKILL.md (563 more words)Show less

Auth Setup

Run shopify-pp-cli auth setup to print the URL and steps for getting a key (add --launch to open the URL). Then set:

bash
export SHOPIFY_ACCESS_TOKEN="<your-key>"

Or persist it in ~/.config/shopify-pp-cli/config.toml.

Run shopify-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
    shopify-pp-cli abandoned-checkouts list --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

  • Read-only — do not use this CLI for create, update, delete, publish, comment, upvote, invite, order, send, or other mutating requests

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 AND no machine-format flag (--json, --csv, --compact, --quiet, --plain, --select) is set — piped/agent consumers and explicit-format runs get pure JSON on stdout.

Agent Feedback

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

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

Entries are stored locally at ~/.local/share/shopify-pp-cli/feedback.jsonl. They are never POSTed unless SHOPIFY_FEEDBACK_ENDPOINT is set AND either --send is passed or SHOPIFY_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.

shopify-pp-cli profile save briefing --json
shopify-pp-cli --profile briefing abandoned-checkouts list
shopify-pp-cli profile list --json
shopify-pp-cli profile show briefing
shopify-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 shopify-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

  1. Install the MCP server:
    bash
    go install github.com/mvanhorn/printing-press-library/library/commerce/shopify/cmd/shopify-pp-mcp@latest
  2. Register with Claude Code:
    bash
    claude mcp add shopify-pp-mcp -- shopify-pp-mcp
  3. Verify: claude mcp list

Direct Use

  1. Check if installed: which shopify-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
    shopify-pp-cli <command> [subcommand] [args] --agent
  4. If ambiguous, drill into subcommand help: shopify-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-shopify of mvanhorn/printing-press-library.

Open the folder on GitHubat commit 0fdcc7a

Compare with similar skills

Pp Shopify 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 Shopify compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pp Shopify this skillmvanhorn/printing-press-library2.1k—~3.1kAutomated safety check: NotesApache-2.0
Shopifyasgeirtj/system_prompts_leaks69k—~2kAutomated safety check: PassCC0-1.0
Shopify Core Workflow Bjeremylongshore/tons-of-skills-marketplace2.8k—~1.1kAutomated safety check: PassMIT
Shopify Developer Referencetech-leads-club/agent-skills7k—~1.9kAutomated safety check: PassCustom licence
Shopifyericrisco/rsc-harness167—~3.2kAutomated safety check: PassMIT
ShopifyShopify/Shopify-AI-Toolkit589—~4.2kAutomated safety check: PassMIT

Similar skills

  • Shopify

    asgeirtj/system_prompts_leaks

    Set up and operate a Shopify store with Shopify's official MCP server (the installed shopify command, NOT the npm Shopify CLI).

    69k GitHub stars~2k tokensUpdated today
    Backend & APIsAuto-check passed
  • Shopify Core Workflow B

    jeremylongshore/tons-of-skills-marketplace

    Manage Shopify orders, customers, and fulfillments using the GraphQL Admin API.

    2.8k GitHub stars~1.1k tokensUpdated today
    Backend & APIsAuto-check passed
  • Shopify Developer Reference

    tech-leads-club/agent-skills

    Reference for Shopify work: Liquid templates, OS 2.0 themes, Admin and Storefront GraphQL APIs, apps, Functions and Hydrogen, on API version 2026-01.

    7k GitHub stars~1.9k tokensUpdated 18 days ago
    Backend & APIsAuto-check passed
  • Shopify

    ericrisco/rsc-harness

    A skill your agent uses when building or customizing a Shopify store across its three code surfaces — themes (Liquid, Online Store 2.0 sections, blocks and JSON templates), apps (Remix with the…

    167 GitHub stars~3.2k tokensUpdated today
    Backend & APIsAuto-check passed
  • Shopify

    Shopify/Shopify-AI-Toolkit

    Official

    Build anything on Shopify. An agent skill from Shopify/Shopify-AI-Toolkit.

    589 GitHub stars~4.2k tokensUpdated today
    Backend & APIsAuto-check passed
  • Shopify Development

    davila7/claude-code-templates

    Build Shopify apps, extensions, themes using GraphQL Admin API, Shopify CLI, Polaris UI, and Liquid.

    32k GitHub starsUsed in 7 repos~2.2k tokens
    Backend & APIsAuto-check passed

More from mvanhorn/printing-press-library

All 505 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 yesterday
    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 yesterday
    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 yesterday
    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 yesterday
    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 yesterday
    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 yesterday
    Auto-check: notes

Works with

Questions about Pp Shopify

What does Pp Shopify do?

Operate a Shopify store from the terminal with local sync, analytics, and bulk exports. Pp Shopify is an agent skill from mvanhorn/printing-press-library. Operate a Shopify store from the terminal with local sync, analytics, and bulk exports.

When should I use Pp Shopify?

Pp Shopify fits situations like: tasks that involve E-commerce operations.

How do I install Pp Shopify in Claude Code?

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

How do I install Pp Shopify in Codex?

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

Can I use Pp Shopify 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-shopify -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-shopify, .gemini/skills/pp-shopify, .github/skills/pp-shopify and .opencode/skills/pp-shopify in your project.

What does Pp Shopify need to run?

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

Does Pp Shopify 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 Shopify 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 Shopify use?

Pp Shopify 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 Shopify use?

About 3.1k 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 Shopify?

Skills that share tags, products or a category with Pp Shopify: Shopify (asgeirtj/system_prompts_leaks, 69k stars), Shopify Core Workflow B (jeremylongshore/tons-of-skills-marketplace, 2.8k stars), Shopify Developer Reference (tech-leads-club/agent-skills, 7k stars) and Shopify (ericrisco/rsc-harness, 167 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pp Shopify?

mvanhorn (a GitHub user) maintains it in mvanhorn/printing-press-library, which has 2,053 GitHub stars. The repository holds 505 skills in this directory. The repository was last updated on October 7, 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.