pp-kit

What this skill does

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/marketing/kit/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/". -->

# Kit — Printing Press CLI

## Prerequisites: Install the CLI

This skill drives the `kit-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 kit --cli-only
   ```
2. Verify: `kit-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.3 or newer):

```bash
go install github.com/mvanhorn/printing-press-library/library/marketing/kit/cmd/kit-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.

## Agentic Kit Workflows

Prefer these read-only workflows before raw endpoint mirrors when the user asks for planning, diagnosis, audit, support, or account context:

- `kit-pp-cli workflow creator-snapshot --agent` — one operating snapshot with account, growth, audience, content, webhook, and broadcast stats.
- `kit-pp-cli workflow audience-health --agent` — subscriber status counts, growth stats, and largest tags by subscriber count.
- `kit-pp-cli workflow content-inventory --agent` — sequences, sequence emails, snippets, forms, email templates, and recent broadcast stats for content planning.
- `kit-pp-cli workflow subscriber-lookup --email <email> --agent` — one subscriber profile with custom fields, tags, attribution, and email stats.

Use raw endpoint commands when the user needs a specific CRUD operation, exact endpoint parity, pagination beyond a workflow limit, or a write operation. These workflows call real Kit v4 endpoints; they are not cached summaries or mock payloads.

## Unique Capabilities

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

### Creator operations
- **`workflow creator-snapshot`** — One-call read-only operating snapshot for Kit account, growth, audience, content, webhooks, and broadcast stats.

  _Use this first when an agent needs current creator-account context without manually fanning out across endpoint mirrors._

  ```bash
  kit-pp-cli workflow creator-snapshot --agent
  ```

### Audience intelligence
- **`workflow audience-health`** — Read-only subscriber status counts, recent growth stats, and largest tags by subscriber count.

  _Use this before list cleaning, segmentation, or campaign planning to avoid multiple fragile subscriber and tag calls._

  ```bash
  kit-pp-cli workflow audience-health --agent
  ```
- **`workflow subscriber-lookup`** — Read-only subscriber dossier by email or id with profile, custom fields, tags, attribution, and email stats.

  _Use this for support, segmentation checks, and personalization debugging before raw subscriber endpoint calls._

### Content planning
- **`workflow content-inventory`** — Read-only inventory of sequences, sequence emails, snippets, forms, templates, and recent broadcast stats.

  _Use this for content audits and planning instead of separately listing each Kit content surface._

  ```bash
  kit-pp-cli workflow content-inventory --agent
  ```

### Trends and ranking
- **`growth-trends`** — Correlates account growth stats with broadcast performance over a date range. Optionally caches results via the typed `UpsertBroadcastsStats` write path.
- **`tag-performance`** — Ranks tags by subscriber count with share-of-total percentages; optional `--subscriber-query` uses `SearchSubscribers` to narrow to a segment.

### MCP intent tools

Four first-class MCP intent tools expose the workflow commands with typed input schemas and read-only annotations. Use these via the MCP server (`kit-pp-mcp`) when an agent host wants typed parameters and explicit safety hints:

- `intent_workflow_creator_snapshot`
- `intent_workflow_audience_health`
- `intent_workflow_content_inventory`
- `intent_workflow_subscriber_lookup`

The MCP server supports both stdio and streamable HTTP transports (`--transport http --addr :7777` or `PP_MCP_TRANSPORT=http`).

## Command Reference

**workflow** — Kit-specific compound workflows for agents

- `kit-pp-cli workflow creator-snapshot` — Summarize account, audience, content, and broadcast health
- `kit-pp-cli workflow audience-health` — Summarize subscriber status, recent growth, and largest tags
- `kit-pp-cli workflow content-inventory` — Inventory sequences, emails, snippets, forms, templates, and broadcasts
- `kit-pp-cli workflow subscriber-lookup` — Fetch one subscriber with tags, custom fields, attribution, and email stats

**account** — Manage account

- `kit-pp-cli account list` — Get current account
- `kit-pp-cli account list-colors` — List colors
- `kit-pp-cli account list-creatorprofile` — Get Creator Profile
- `kit-pp-cli account list-emailstats` — Get email stats
- `kit-pp-cli account list-growthstats` — Get growth stats for a specific time period. Defaults to last 90 days.<br/><br/>NOTE: We return your stats in your...
- `kit-pp-cli account update` — Update colors

**broadcasts** — Manage broadcasts

- `kit-pp-cli broadcasts create` — Draft or schedule to send a broadcast to all or a subset of your subscribers.<br/><br/>To save a draft, set...
- `kit-pp-cli broadcasts delete` — Delete a broadcast
- `kit-pp-cli broadcasts get` — Get a broadcast
- `kit-pp-cli broadcasts list` — List broadcasts
- `kit-pp-cli broadcasts list-stats` — Get stats for a list of broadcasts
- `kit-pp-cli broadcasts update` — Update an existing broadcast. Continue to draft or schedule to send a broadcast to all or a subset of your...

**bulk** — Manage bulk

- `kit-pp-cli bulk create` — See '[Bulk & async processing](#bulk-amp-async-processing)' for more information.
- `kit-pp-cli bulk create-customfields` — Bulk update subscriber custom field values
- `kit-pp-cli bulk create-forms` — Adding subscribers to double opt-in forms will trigger sending an Incentive Email. Subscribers already added to the...
- `kit-pp-cli bulk create-subscribers` — See '[Bulk & async processing](#bulk-amp-async-processing)' for more information.
- `kit-pp-cli bulk create-tags` — See '[Bulk & async processing](#bulk-amp-async-processing)' for more information.
- `kit-pp-cli bulk create-tags-2` — The subscribers being tagged must already exist. Subscribers can be created in bulk using the '[Bulk create...
- `kit-pp-cli bulk delete` — See '[Bulk & async processing](#bulk-amp-async-processing)' for more information.

**custom-fields** — Manage custom fields

- `kit-pp-cli custom-fields create` — Create a custom field for your account. The label field must be unique to your account. Whitespace will be removed...
- `kit-pp-cli custom-fields delete` — This will remove all data in this field from your subscribers.
- `kit-pp-cli custom-fields list` — A custom field allows you to collect subscriber information beyond the standard fields of first name and email...
- `kit-pp-cli custom-fields update` — Updates a custom field label (see [Create a custom field](/api-reference/custom-fields/create-a-custom-field) for...

**email-templates** — Manage email templates

- `kit-pp-cli email-templates` — List email templates

**forms** — Manage forms

- `kit-pp-cli forms` — List forms

**posts** — Manage posts

- `kit-pp-cli posts get` — Get a post
- `kit-pp-cli posts list` — List posts

**purchases** — Manage purchases

- `kit-pp