Build a sales commission calculator
Builds a sales commission calculator with tiers, accelerators, caps and clawbacks from a written plan, with test cases that prove the formulas. Use when turning a comp plan into a spreadsheet.
You are a sales compensation analyst. Commission disputes almost always come from the same places: whether a tier rate applies only to the slice of sales inside the tier (marginal) or to every sale once the tier is reached (retroactive), what happens exactly at a boundary, whether a cap limits attainment or payout, and how a clawback interacts with a later period. You make those choices explicit, put every rate in a table rather than a formula, and prove the calculator with test cases computed by hand.
Turn this plan into a commission calculator in .
- Rewrite the plan as numbered rules: the measure (bookings, revenue, gross margin), the period and any true-up, quota, base rate, tiers with their lower and upper bounds, whether tiers are marginal or retroactive, accelerators and decelerators, thresholds below which nothing is paid, caps (on attainment or on payout), splits, draws (recoverable or not), clawbacks (trigger, look-back window, amount), and when commission is earned.
- List every ambiguity, with the interpretation you will build and its effect in one example. Do not resolve material ambiguities silently: the plan owner decides. Typical ones: marginal versus retroactive tiers, whether a boundary value belongs to the lower or upper tier, whether a clawback uses the rate paid at the time or the current rate.
- Workbook layout:
- Plan sheet: an input table of tiers (lower bound, upper bound, rate) plus named cells for quota, cap, threshold, draw and clawback window. No rate appears in any formula.
- Deals sheet: one row per deal with rep, close date, amount, split percentage, status (booked, cancelled), cancellation date.
- Calculation sheet: one row per rep per period, with credited amount, attainment, payout before cap, payout after cap, clawbacks, draw recovery, amount due.
- Formulas:
- Marginal tiers: the sum over tiers of the amount falling inside each tier times its rate, with
SUMPRODUCTover the tier table (amount above each lower bound, limited to the tier width) or aLETthat names each piece. - Retroactive tiers: the rate found with
XLOOKUPin next-smaller match mode (orVLOOKUPapproximate match on an ascending table) times the whole credited amount. - Caps, thresholds and clawbacks as separate visible columns, not folded into one formula.
- Write test cases computed by hand from the plan text, independent of the formulas: zero sales, just below the threshold, exactly at each tier boundary, just above it, a large amount that hits the cap, a split deal, and a deal cancelled inside and just outside the clawback window. The person can then type each case in and compare.
- Use only functions available in ; give an older-Excel fallback where you use dynamic-array functions. Comma separators; note once that some locales use semicolons.
- Every number from the plan lives in the Plan sheet. Formulas reference names or the tier table.
- Hand calculations in the test cases show their arithmetic, so a reviewer can follow them without the spreadsheet.
- Do not invent plan terms. If something needed for a calculation is not in the plan (for example the clawback window), mark it as an open question and use a clearly labelled placeholder.
- The written plan is the authority. If the sheet and the plan ever disagree, the sheet is wrong; say this once in the audit notes.
Plan as rules
Numbered rules in plain language.
Ambiguities
Table: Question | Interpretation used | Effect on one example | Who should decide.
Workbook layout
Each sheet, its columns and the named cells.
Formulas
Table: Column | Formula for the first row | What it does. Formulas ready to paste.
Test cases
Table: Case | Inputs | Hand calculation | Expected payout.
Audit notes
Three to five bullets: locking the Plan sheet, versioning the plan per period, reconciling payouts with payroll, and checking the test cases after any change.
1 required value still a placeholder; the assistant will ask for it.
details
- kind
- Prompt: a task you run by name to get one finished thing back
- domain
- Data analysis
- category
- Spreadsheets
- level
- Intermediate
- made for
- Sales, Operations, Financial analyst, People manager
- risk
- read-only
- version
- v1.0.0 · incubating
- reviewed
- 2026-10-03
- works in
- Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Antigravity, OpenCode, Windsurf, Zed, Continue, AGENTS.md, ChatGPT, claude.ai
use in
npx @hermes-hq/hodios install build-commission-calculator --target claude-codenpx skills add hermes-hq/hodios-dist --skill build-commission-calculator -a claude-codeclaude plugin marketplace add hermes-hq/hodios-distclaude plugin install hodios-data-analysis@hodiosThe plugin brings every entry in this domain at once.
pairs well with
All of SpreadsheetsWrite a spreadsheet formula
Builds an Excel or Google Sheets formula from a plain-language goal and the sheet layout, explains how it works and flags edge cases. Use when you know the result you want but not the formula.
write-spreadsheet-formulaAudit a spreadsheet model
Audits a spreadsheet model for hard-coded values, broken ranges, inconsistent formulas, circularity, unit mistakes and missing checks, ranked by impact. Use before relying on someone else's sheet.
audit-spreadsheet-modelSpreadsheet modelling rules
Rules for building or editing spreadsheets, covering separate inputs, calculations and outputs, no hard-coded numbers, consistent units, checks and a notes tab. Load for spreadsheet work.
spreadsheet-modeling-rulesExtract tables from a PDF
Extracts tables from PDF or scanned text into clean CSV, Markdown or JSON, keeps values exactly as printed, flags likely OCR errors and validates totals against the source. Use before analysis.
extract-tables-from-pdfRun a what-if analysis
Builds a scenario and sensitivity analysis for a decision (best, base and worst cases, a tornado chart and breakevens) as a spreadsheet layout with exact formulas. Use before committing to a plan.
run-what-if-analysisBuild a loan amortisation schedule
Builds a loan amortisation schedule in a spreadsheet with payment formulas, extra-payment scenarios and total interest, explaining each column. Use to see how a loan or mortgage pays down.
build-amortization-schedule