quote-builder
Skill6 starsChanged 4 months agoMITView on GitHub
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.
3 other projects use a version of this.
Adopted by
Most recently taken up by
- thefiredev-cloud/meshvault-harnesstheir own version, first seen Oct 13, 2026
- prab-hub/revexos-q2c-kittheir own version, first seen Oct 9, 2026
- thefiredev-cloud/meshvault-skills-startertheir own version, first seen Jul 22, 2026
Other versions3 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 3
- prab-hub/revexos-q2c-kit★ 0same name
- thefiredev-cloud/meshvault-harness★ 0same name
- thefiredev-cloud/meshvault-skills-starter★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository8 other files it gives its agents.
- agency-statusSkill
- client-approvalSkill
- client-reportSkill
- post-mortemSkill
- project-briefSkill
- proposal-writingSkill
- shooting-daySkill
- social-calendarSkill
The file
We split this skill into the rules it gives an agent
5 rules. 0 are common, 4 are distinctive, and 1 is very specific to this project.
0
Common
Most of the 3 edited versions we read keep these.
4
Distinctive
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 55
Default: 50% on signature, 50% on delivery.
- Distinctive: line 59
Default: 2 rounds of revisions included per deliverable.
- Distinctive: line 70
Never show cost or margin on the client version.
- Distinctive: line 137
Termini di pagamento: Default: 50% alla firma, 50% alla consegna.
- Very specific: line 138
Policy revisioni: Default: 2 round inclusi per deliverable.
“Common” is measured: kept by at least 6 in 10 of the 3 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
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
- Scope — the deliverables and quantities (e.g. 12 reels/month, 1 shooting day, 3 revisions).
- Your prices — unit price per line, or ask the skill to propose a structure you then adjust.
- 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
UNKNOWNand warns you. - Payment terms — default 50% upfront, 50% on delivery.
- Revision policy — default 2 included, extra billed at an hourly rate you provide.
- Currency and whether prices are net of tax/VAT.
Output format
- CLIENT QUOTE — clean, itemised, sendable. No internal costs, no margins.
- 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
UNKNOWNand 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
- Scope — deliverable e quantità (es. 12 reel/mese, 1 giorno di shooting, 3 revisioni).
- I tuoi prezzi — prezzo unitario per riga, o chiedi alla skill di proporre una struttura.
- 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 è
SCONOSCIUTOcon avviso. - Termini di pagamento — default 50% all'inizio, 50% alla consegna.
- Policy revisioni — default 2 incluse, extra a tariffa oraria che fornisci.
- 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
- 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.
- Termini di pagamento. Default: 50% alla firma, 50% alla consegna. Retainer: mensile anticipato. Trigger concreti, non vibes.
- 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. - 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
SCONOSCIUTOe 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.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

