# Consumer Goods Tpe Dashboard Custom Kpi Configure

Customize the Trade Promotion Effectiveness (TPE) Analytics dashboards' generic KPI...

- Repository: https://github.com/forcedotcom/sf-skills (1134 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-10-30
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add forcedotcom/sf-skills --skill consumer-goods-tpe-dashboard-custom-kpi-configure -g -a claude-code -y`
Codex: `npx skills add forcedotcom/sf-skills --skill consumer-goods-tpe-dashboard-custom-kpi-configure -g -a codex -y`
Cursor: `npx skills add forcedotcom/sf-skills --skill consumer-goods-tpe-dashboard-custom-kpi-configure -g -a cursor -y`
Gemini CLI: `npx skills add forcedotcom/sf-skills --skill consumer-goods-tpe-dashboard-custom-kpi-configure -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add forcedotcom/sf-skills`

## Description

Customize the Trade Promotion Effectiveness (TPE) Analytics dashboards' generic KPI slots (Promotion Measure 1-3, Tactic Measure 1-2) with customer-chosen KPI measure codes and display names, without touching the shipped base model. Use when a customer/admin wants to \"customize TPE dashboards\", \"change the KPIs on the Promotion/Tactic Analysis dashboard\", or \"swap in our own measure codes on the TPE dashboard\".

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Customize TPE Dashboard KPIs

Headlessly clones the base TPE Analytics semantic-model parameters, visualizations, and dashboards
under a customer-chosen suffix, so a customer's own KPI measure codes appear on the Promotion/Tactic
Analysis dashboards without ever mutating the shipped base model. Driven entirely by `sf` CLI +
REST against an already-authenticated org. Requires `consumer-goods-tpe-dashboard-configure` to
have already installed the TPE Analytics app and the Extended TPM Analytics SDM, this skill never
installs those, only customizes on top of them.

Persona: a **Salesforce TPM System Admin** customizing TPE dashboards for their org's own KPIs.

There is no native "clone" endpoint for any of the three artifact types this skill touches
(semantic-model parameters, visualizations, dashboards), every clone is the same three-step
pattern: **GET** the base artifact, **deep-copy** its JSON and apply overrides, **POST** the copy as
a new artifact. Base-model artifacts are never mutated in place.

## The 5 KPI slots, two artifacts per slot, not one

The shipped Extended TPM Analytics SDM exposes 5 generic **List-type parameters** that the standard
dashboards bind to: Promotion Measure 1-3 (`Promotion_Measure_{1,2,3}_prm` / `_value`) and Tactic
Measure 1-2 (`Tactic_Measure_{1,2}_prm` / `_clc`). **Never assume Tactic mirrors Promotion's
`_value` naming**, resolve both slots' measurement apiNames from the live model per slot, never by
pattern. See `references/payload-shapes.md` for the confirmed apiNames and JSON shapes.

The rest: https://github.com/forcedotcom/sf-skills/blob/HEAD/plugins/builder/consumer-goods/skills/consumer-goods-tpe-dashboard-custom-kpi-configure/SKILL.md
