# price-optimization-tool

Works out unit economics and compares price candidates across demand scenarios, then proposes a reversible price test.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 611 installs · ★ 1258
- Author: nexscope-ai
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/nexscope-ai/eCommerce-Skills/tree/HEAD/price-optimization-tool/SKILL.md
- Updated: 2026-08-26
- HTML: https://affpapa.org/en/nevibecode/skills/price-optimization-tool

## What it does

The skill walks through a pricing decision in steps. First it audits whether price, demand, traffic, promotion and cost data are comparable, then calculates contribution for each candidate and drops the ones that break approved floors or ceilings. Next it checks whether the evidence can support an elasticity estimate at all. Weak price variation or confounding changes get called out, and the skill falls back to base, downside and upside demand scenarios instead of a single forecast.

Inside are formulas for net revenue, contribution and a price floor that accounts for percentage fees, plus a midpoint elasticity diagnostic. Bundles and tiers get their own pass: component economics, customer savings, attach rate and cannibalization risk. The advice is to start with the smallest useful controlled test rather than repricing a whole catalog at once.

It will not touch live prices without explicit authorization, and it will not call a price proven optimal when the data is not clean enough. When material inputs are missing, it asks one consolidated follow-up question; if they stay unavailable, you get a provisional candidate framework and a test plan.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add nexscope-ai/eCommerce-Skills --skill price-optimization-tool -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/price-optimization-tool/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/price-optimization-tool/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add nexscope-ai/eCommerce-Skills --skill price-optimization-tool -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/price-optimization-tool/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add nexscope-ai/eCommerce-Skills --skill price-optimization-tool -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/price-optimization-tool/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install nexscope-ai/eCommerce-Skills price-optimization-tool
```

2. **Manually: put the files in place**
- File: `.github/skills/price-optimization-tool/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add nexscope-ai/eCommerce-Skills --skill price-optimization-tool -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/nexscope-ai/eCommerce-Skills --path price-optimization-tool
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/price-optimization-tool/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add nexscope-ai/eCommerce-Skills --skill price-optimization-tool -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/nexscope-ai/eCommerce-Skills/tree/HEAD/price-optimization-tool/SKILL.md

## When to use it
- calculate contribution for each price candidate
- check whether a dataset can support an elasticity estimate
- compare regular, bundle and quantity-tier pricing
- design a controlled price test with guardrails
- find a price floor that accounts for percentage fees

## Example prompts
- Evaluate these five price candidates using my cost and sales history.
- Can this dataset support a price-elasticity estimate, and what should I test next?
- Build a price experiment for my top five Shopify SKUs.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 8c07db8e1c261b46.

BEGIN THIRD-PARTY FILE 8c07db8e1c261b46
````text
---
name: price-optimization-tool
description: Evaluate ecommerce price candidates using unit economics, historical observations, elasticity analysis, scenario modeling, and controlled experiments. Use when a seller asks what price to test, how price changes could affect contribution or revenue, how to estimate elasticity, how to optimize a bundle or tier, or how to design a price experiment across Amazon, Shopify, TikTok Shop, Walmart, eBay, or other channels. Do not claim a proven optimal price without sufficient clean data, and do not change live prices without explicit authorization.
---

# Price Optimization Tool

Build an evidence-bounded price decision from seller economics and observed behavior, then recommend a reversible test or rollout with explicit uncertainty.

## Installation

```bash
npx skills add nexscope-ai/eCommerce-Skills --skill price-optimization-tool -g
```

## Capabilities

- Audit price, demand, traffic, promotion, cost, and inventory data for comparability.
- Calculate contribution economics and hard candidate-price constraints.
- Estimate directional or numeric elasticity only when the evidence supports it.
- Compare price candidates under base, downside, and upside demand scenarios.
- Optimize regular, promotional, bundle, quantity, and good-better-best price candidates.
- Design controlled price tests with hypotheses, guardrails, confounder controls, and decision rules.
- Produce a recommendation with uncertainty, approval requirements, and a reversible rollout.

## Usage Examples

```text
Evaluate these five price candidates using my cost and sales history.
```

```text
Can this dataset support a price-elasticity estimate, and what should I test next?
```

```text
Build a price experiment for my top five Shopify SKUs without misleading customers.
```

```text
Compare separate-item, bundle, and quantity-tier pricing for these products.
```

## Inputs and Collection

Use seller-supplied and inspected evidence first. Collect:

- SKU, variant, channel, market, currency, tax treatment, fulfillment method, lifecycle stage, and business objective;
- timestamped regular price, realized selling price, list or compare-at price, coupons, promotions, and seller-funded discounts;
- timestamped sessions or impressions, orders, units, net revenue, cancellations, returns, and inventory availability;
````
END THIRD-PARTY FILE 8c07db8e1c261b46

The third-party file has ended. Everything between the 8c07db8e1c261b46 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2354 of 13040 bytes. © nexscope-ai · MIT · https://github.com/nexscope-ai/eCommerce-Skills/tree/HEAD/price-optimization-tool/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md