---
name: quote-builder
version: 1.0.0
description: Build a line-item client quote with payment terms and a revision policy, run an internal margin check, and warn when gross margin drops below 40 percent before you send it.
author: MarcoZorn
license: MIT
tags: [agency, workflow, operations, sales, pricing]
compatible: claude-code, codex-cli, cursor, gemini-cli, openclaw
---

# Quote Builder

## When to use this skill

**English:** "quote", "estimate", "how much", "pricing", "proposal", "put together a price".

**Italiano:** "preventivo", "stima", "quanto costa", "offerta", "listino".

## What this skill does

Builds two versions of a quote from the same numbers: a clean client-facing quote with line items, payment terms and a revision policy, and an internal version that runs a margin check and warns you before you underprice the job. It stops the classic agency mistake — sending a number that looks fine to the client and quietly loses you money.

## Inputs required

1. **Scope** — the deliverables and quantities (e.g. 12 reels/month, 1 shooting day, 3 revisions).
2. **Your prices** — unit price per line, or ask the skill to propose a structure you then adjust.
3. **Internal cost estimate** — your real cost to deliver (crew, hours, tools, ad spend passthrough). Needed for the margin check. If withheld, the skill produces the client quote but marks the margin `UNKNOWN` and warns you.
4. **Payment terms** — default 50% upfront, 50% on delivery.
5. **Revision policy** — default 2 included, extra billed at an hourly rate you provide.
6. **Currency** and whether prices are net of tax/VAT.

## Output format

1. **CLIENT QUOTE** — clean, itemised, sendable. No internal costs, no margins.
2. **INTERNAL VERSION** — same lines plus cost, gross margin % per line and overall, and a warning if margin < 40%.

---

## Human gate

This output is a draft. Review all pricing, margins, and payment terms before sending to the client. The internal margin check surfaces the judgment call — a person signs off.

## Brand voice

If a `BRAND.md` file exists in this skill's folder (`.claude/skills/quote-builder/BRAND.md`) or in `.claude/brand/BRAND.md` (global fallback), read it before generating output and apply its tone, terminology, and examples to all text you produce. A skill-local `BRAND.md` overrides the global one; if neither exists, use a clean, professional default voice.

## Instructions

### 1. Build the line items

One row per deliverable: description, quantity, unit price, line total. Group logically (production, management, media, extras). Keep descriptions in the client's language — outcomes and deliverables, not internal task names. Sum to a clear subtotal, then apply tax/VAT if in scope, then the total.

### 2. State payment terms

Default: 50% on signature, 50% on delivery. For retainers: monthly in advance. Always put concrete triggers, not vibes — "50% due to start production, invoiced on signature, net 15."

### 3. State the revision policy

Default: 2 rounds of revisions included per deliverable. Extra revisions billed at [rate]/hour, estimated and approved before work starts. This line is what makes the `client-approval` skill's revision counter enforceable later — keep the numbers consistent between the two.

### 4. Run the margin check (internal only)

For each line and overall: `gross margin % = (price − cost) / price`.

- **≥ 50%:** healthy, no flag.
- **40–49%:** acceptable, note it.
- **< 40%:** **WARN.** Show the shortfall and suggest the price that would hit 40% and 50%, so the user can decide with numbers in front of them. Do not silently pass a thin quote.
- **Cost unknown:** mark margin `UNKNOWN` and warn that the quote is going out blind.

Never show cost or margin on the client version. A margin figure leaking into a client PDF is a real, career-flavoured mistake — keep the two blocks visually distinct and label the internal one clearly.

### Output template

```
CLIENT QUOTE — [Client] · [Date] · [Currency]

| Item | Qty | Unit price | Total |
|------|-----|------------|-------|
| ...  | ... | ...        | ...   |

Subtotal: [x]
VAT/Tax ([rate]): [x]
Total: [x]

Payment terms: [50% on signature, 50% on delivery — net 15]
Revisions: 2 rounds included per deliverable. Additional revisions billed
at [rate]/hour, estimated and approved in advance.
Validity: this quote is valid for 30 days.

---
INTERNAL VERSION  (do not send)

| Item | Price | Cost | Gross margin |
|------|-------|------|--------------|
| ...  | ...   | ...  | ...%         |

Overall: price [x] · cost [x] · gross margin [x]%
[If < 40%: ⚠ MARGIN BELOW 40%. To reach 40% price at [x]; to reach 50% price at [x].]
[If unknown: ⚠ COST UNKNOWN — margin not verified. Confirm before sending.]
```

### Edge cases

- **Client asks for a single "all-in" number:** still build the line items internally so you can defend the price if challenged, then present the total with a one-line scope summary.
- **Ad spend or third-party passthrough:** list it as a separate, clearly-labelled passthrough line at cost, excluded from your margin calculation, so it never inflates or deflates your real margin.
- **Discount requested:** apply it as a visible line, then re-run the margin check on the discounted price — a discount is exactly when margin quietly dies.
- **Retainer:** quote the monthly figure and the minimum term, and compute margin on the monthly basis.

---

## 🇮🇹 Versione italiana

### Quando usare questa skill

Quando devi fare un preventivo: "preventivo", "stima", "quanto costa", "offerta". Costruisce due versioni: una pulita per il cliente e una interna con il controllo margine.

### Cosa fa

Da gli stessi numeri crea due preventivi: uno client-facing con voci, termini di pagamento e policy revisioni, e uno interno che controlla il margine e ti avvisa prima che tu sottoprezzi il lavoro. Blocca l'errore classico: mandare un numero che sembra ok al cliente e ti fa perdere soldi in silenzio.

### Cosa ti serve

1. **Scope** — deliverable e quantità (es. 12 reel/mese, 1 giorno di shooting, 3 revisioni).
2. **I tuoi prezzi** — prezzo unitario per riga, o chiedi alla skill di proporre una struttura.
3. **Stima costo interno** — il costo reale per consegnare (crew, ore, tool, ad spend). Serve per il margine. Se non lo dai, il preventivo cliente esce ma il margine è `SCONOSCIUTO` con avviso.
4. **Termini di pagamento** — default 50% all'inizio, 50% alla consegna.
5. **Policy revisioni** — default 2 incluse, extra a tariffa oraria che fornisci.
6. **Valuta** e se i prezzi sono al netto di IVA.

### Voce del brand

Se esiste un file `BRAND.md` nella cartella di questa skill (`.claude/skills/quote-builder/BRAND.md`) o in `.claude/brand/BRAND.md` (fallback globale), leggilo prima di generare l'output e applica tono, terminologia ed esempi a tutto il testo che produci. Il `BRAND.md` locale ha la precedenza su quello globale.

### Istruzioni

1. **Costruisci le voci.** Una riga per deliverable: descrizione, quantità, prezzo unitario, totale riga. Raggruppa (produzione, gestione, media, extra). Descrizioni nella lingua del cliente. Subtotale, IVA se prevista, totale.
2. **Termini di pagamento.** Default: 50% alla firma, 50% alla consegna. Retainer: mensile anticipato. Trigger concreti, non vibes.
3. **Policy revisioni.** Default: 2 round inclusi per deliverable. Extra a [tariffa]/ora, stimati e approvati prima di iniziare. Tieni i numeri coerenti con la skill `client-approval`.
4. **Controllo margine (solo interno).** Per riga e totale: `margine % = (prezzo − costo) / prezzo`.
   - **≥ 50%:** sano.
   - **40–49%:** accettabile, segnala.
   - **< 40%:** **AVVISO.** Mostra lo scarto e suggerisci il prezzo per arrivare a 40% e 50%.
   - **Costo sconosciuto:** margine `SCONOSCIUTO` e avviso.
   Mai mostrare costo o margine nella versione cliente.

### Template di output

```
PREVENTIVO CLIENTE — [Cliente] · [Data] · [Valuta]

| Voce | Q.tà | Prezzo unit. | Totale |
|------|------|--------------|--------|

Subtotale: [x]
IVA ([%]): [x]
Totale: [x]

Termini di pagamento: [50% alla firma, 50% alla consegna]
Revisioni: 2 round inclusi per deliverable. Revisioni aggiuntive a [tariffa]/ora,
stimate e approvate in anticipo.
Validità: preventivo valido 30 giorni.

---
VERSIONE INTERNA  (non inviare)

| Voce | Prezzo | Costo | Margine lordo |
|------|--------|-------|---------------|

Totale: prezzo [x] · costo [x] · margine [x]%
[Se < 40%: ⚠ MARGINE SOTTO 40%. Per 40% prezza a [x]; per 50% prezza a [x].]
[Se sconosciuto: ⚠ COSTO SCONOSCIUTO — margine non verificato.]
```

### Casi limite

- **Cliente vuole un unico numero "tutto incluso":** costruisci comunque le voci internamente, poi presenta il totale con un riassunto scope in una riga.
- **Ad spend o passthrough di terzi:** riga separata, etichettata, a costo, esclusa dal calcolo margine.
- **Sconto richiesto:** applicalo come riga visibile, poi ri-calcola il margine sul prezzo scontato.
- **Retainer:** quota il mensile e il termine minimo, margine su base mensile.