Agent Skills › win4r/MuseAI-Skills › printify

printify

GitHub

通过 CLI 管理 Printify 按需打印服务，涵盖商品目录浏览、店铺与产品 CRUD、订单管理及上传功能。支持认证配置、状态检查及 JSON 数据解析，辅助完成电商内容创建与业务运营操作。

opt/hatch/skills/printify/SKILL.md win4r/MuseAI-Skills

Trigger Scenarios

需要管理 Printify 店铺或商品时查询 Printify 目录或变体时创建或查看 Printify 订单时

Install

npx skills add win4r/MuseAI-Skills --skill printify -g -y

More Options

Non-standard path

npx skills add https://github.com/win4r/MuseAI-Skills/tree/main/opt/hatch/skills/printify -g -y

Use without installing

npx skills use win4r/MuseAI-Skills@printify

指定 Agent (Claude Code)

npx skills add win4r/MuseAI-Skills --skill printify -a claude-code -g -y

安装 repo 全部 skill

npx skills add win4r/MuseAI-Skills --all -g -y

预览 repo 内 skill

npx skills add win4r/MuseAI-Skills --list

SKILL.md

Frontmatter

{
    "icon": "printify",
    "name": "printify",
    "metadata": {
        "includeInPrompt": false
    },
    "description": "Use Printify to browse catalog data, manage shops and products, and review or create orders."
}

Printify (Print on Demand)

Purpose

Use the printify CLI to manage shops, products, uploads, orders, and catalog lookups.

Tooling

Use the installed CLI directly from PATH:

printify <subcommand> [options]

Global flags:

--timeout-secs <seconds> (optional, default 30): HTTP timeout.

Core commands:

status
authorize-url
verify
set-token (reads token from stdin)
disconnect
shops
products --shop-id <id> [--product-id <id>]
create-product --shop-id <id> --json '<json>'
update-product --shop-id <id> --product-id <id> --json '<json>'
delete-product --shop-id <id> --product-id <id>
publish-product --shop-id <id> --product-id <id>
orders --shop-id <id> [--order-id <id>]
create-order --shop-id <id> --json '<json>'
upload --file <path>
blueprints [--blueprint-id <id>]
print-providers --blueprint-id <id>
variants --blueprint-id <id> --provider-id <id>
shipping --blueprint-id <id> --provider-id <id>

JSON output contract:

status: parse ok, status, connect_url, disconnect_url, and reason
authorize-url: parse ok, authorize_url, and connect_url
verify: parse ok, action, and error
set-token: parse ok, status, and reason
disconnect: parse ok, action, config_path, removed
parse ok, status, body, and error
Read results retain Printify's raw timestamps and add semantic UTC and user-local forms for record creation/update and order production, fulfillment, delivery, or cancellation times.

Auth

First-use setup:

Run printify status to check connection state.
If not connected and connect_url is present, replace <connect_url> with the returned URL and share exactly this Markdown link: [Connect Printify](<connect_url>); do not paste the raw URL separately.
If connect_url is missing, run printify authorize-url and share the returned connect_url the same way.
The user can generate a token at https://printify.com/app/account/api.
If the user provides a token through the CLI flow, store it only through printify set-token; do not write auth files directly.
Run printify verify after setup when you need to confirm the token works.
Never print the access token in chat output.

Operating Rules

Always check printify status before API calls. If not connected, guide the user through the auth setup above.
List shops before performing shop-specific operations to get the correct shop_id.
Confirm with the user before creating, updating, or publishing products. Product deletion may proceed from a clear, unambiguous request without an additional confirmation.
Confirm with the user before creating orders (orders may trigger charges).
When browsing the catalog, start with blueprints then drill into print-providers and variants.
On HTTP 401, tell the user their token may be expired and to generate a new one at https://printify.com/app/account/api.