pp-servicetitan-pricebook

What this skill does

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/sales-and-crm/servicetitan-pricebook/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/". -->

# ServiceTitan Pricebook — Printing Press CLI

## Prerequisites: Install the CLI

This skill drives the `servicetitan-pricebook-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 servicetitan-pricebook --cli-only
   ```
2. Verify: `servicetitan-pricebook-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/sales-and-crm/servicetitan-pricebook/cmd/servicetitan-pricebook-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 CLI when an agent or operator needs to inspect or maintain the ServiceTitan Pricebook — costs, prices, markup tiers, vendor part numbers, warranty text, category taxonomy — without loading the 600+-tool general ST MCP. It is the right choice for margin-discipline checks after vendor cost changes, vendor-quote reconciliation, and pricebook hygiene audits. Run sync first; the novel audit commands read the local store.

## Unique Capabilities

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

### Margin discipline
- **`markup-audit`** — Find every material and equipment SKU whose actual markup has drifted off the materials-markup tier ladder.

  _Reach for this after any vendor cost change to catch SKUs that are now mispriced for their tier before margin erodes._

  ```bash
  servicetitan-pricebook-pp-cli markup-audit --tolerance 5 --agent
  ```
- **`cost-drift`** — Show every SKU whose cost moved since a given date, with old and new cost, old and new price, and whether the price followed.

  _Reach for this to see whether recent vendor cost increases were actually passed through to price._

  ```bash
  servicetitan-pricebook-pp-cli cost-drift --since 2026-04-01 --agent
  ```
- **`reprice`** — Compute the tier-correct price for markup-drifted SKUs and emit the exact update payloads; preview by default, --apply to write.

  _Reach for this after markup-audit to apply hold-markup pricing in one pass instead of editing each SKU by hand._

  ```bash
  servicetitan-pricebook-pp-cli reprice --tolerance 5 --agent
  ```

### Pricebook hygiene
- **`vendor-part-gaps`** — List materials and equipment whose primary vendor part number is empty — the missing 2M Part # sweep.

  _Reach for this to enforce the 2M Part # discipline before a vendor-quote reconcile, which matches on vendor part._

  ```bash
  servicetitan-pricebook-pp-cli vendor-part-gaps --kind material --agent
  ```
- **`warranty-lint`** — Flag equipment whose warranty text is not prefixed Manufacturer's, or that is missing JKA's 1-year parts & labor line.

  _Reach for this to keep warranty attribution honest — manufacturer warranties clearly labeled, JKA's own offering listed alongside._

  ```bash
  servicetitan-pricebook-pp-cli warranty-lint --agent
  ```
- **`orphan-skus`** — List materials, equipment, and services assigned to inactive or non-existent categories.

  _Reach for this during category taxonomy cleanup to find SKUs that fell out of the visible tree._

  ```bash
  servicetitan-pricebook-pp-cli orphan-skus --agent
  ```
- **`dedupe`** — Cluster near-duplicate materials and equipment so excess pricebook growth can be collapsed.

  _Reach for this to find redundant parts before they multiply — duplicate SKUs scatter estimates and inventory across entries that should be one._

  ```bash
  servicetitan-pricebook-pp-cli dedupe --kind material --min-score 0.8 --agent
  ```
- **`copy-audit`** — Flag SKUs whose display name or description is empty, too short, ALL-CAPS, a bare part number, or otherwise not customer-facing.

  _Reach for this to find pricebook entries that read like internal shorthand instead of customer-facing sales copy._

  ```bash
  servicetitan-pricebook-pp-cli copy-audit --kind equipment --agent
  ```

### Vendor quote workflow
- **`quote-reconcile`** — Match a vendor cost file against synced SKUs by vendor part number and print a no-write diff of proposed cost changes; accepts CSV or Claude-extracted JSON from a quote, order confirmation, or invoice PDF.

  _Reach for this when a vendor quote, order confirmation, or invoice lands; have Claude extract it to JSON, then reconcile against current costs before touching the pricebook._

  ```bash
  servicetitan-pricebook-pp-cli quote-reconcile ./2m-quote-2026-05.csv --agent
  ```
- **`bulk-plan`** — Turn a reviewed cost or copy change file into a single pricebook bulk-update payload instead of N individual update calls.

  _Reach for this to apply a batch of reconciled changes in one rate-limit-friendly call._

  ```bash
  servicetitan-pricebook-pp-cli bulk-plan ./reviewed-changes.csv --agent
  ```

### Agent-native plumbing
- **`health`** — One compact rollup of markup-drift, vendor-part-gap, warranty-lint, cost-drift, orphan-SKU, duplicate, and weak-copy counts.

  _Reach for this first in any pricebook session to see what needs attention before drilling into a specific audit._

  ```bash
  servicetitan-pricebook-pp-cli health --agent
  ```
- **`find`** — Forgiving ranked search over synced SKUs tuned for describing a part you do not know the code for.

  _Reach for this when a tech describes a part in plain words — it returns suggested SKUs with the code, price, vendor part, and category they need to pick one._

  ```bash
  servicetitan-pricebook-pp-cli find "1 hp submersible pump motor" --agent
  ```

## Command Reference

**categories** — Manage categories

- `servicetitan-pricebook-pp-cli categories create` — Post to add a new category to your pricebook
- `servicetitan-pricebook-pp-cli categories delete` — Deletes an existing category from your pricebook
- `servicetitan-pricebook-pp-cli categories get` — Gets category details
- `servicetitan-pricebook-pp-cli categories get-list` — GET the categories in your pricebook
- `servicetitan-pricebook-pp-cli categories update` — Edits an existing category in your pricebook

**clientspecificpricing** — Manage clientspecificpricing

- `servicetitan-pricebook-pp-cli clientspecificpricing client-specific-pricing-get-all-rate-sheets` — Client specific pricing_get all rate sheets
- `servicetitan-pricebook-pp-cli clientspecificpricing client-specific-pricing-update-rate-sheet` — Client specific pricing_update rate sheet

**discounts-and-fees** — Manage discounts and fees

- `servicetitan-pricebook-pp-cli discounts-and-fees discount-and-fees-create` — Post to add a new discount or fee to your pricebook
- `servicetitan-pricebook-pp-cli discounts-and-fees discount-and-fees-delete` — Deletes a discount or fee from your pricebook
- `servicetitan-pricebook-pp-cli discounts-and-fees discount-and-fees-get` — Get details of a discount or fee in the pricebook.
- `servicetitan-pricebook-pp-cli discounts-and-fees discount-and-fees-get-list` — Get data on all of the discounts or fees in the pricebook. Supports optional search filtering.
- `servicetitan-pricebook-pp-cli discounts-and-fees discount-and-fees-update` — Edit an existing item in your pricebo