MCPInstall

proposal-writer

Write a client proposal, quote, scope of work, or engagement letter for a service business. Covers project understanding, scope, timeline, pricing presentation, and terms. Use whenever the user asks for a proposal, quote, project proposal, client proposal, SOW, statement of work, engagement letter, or B2B service engagement document — for web dev, consulting, trades, or any service business.

Installs
1.2K
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/jezweb/claude-skills --skill proposal-writer
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads proposal-writer automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Client Proposal Writer

Produces proposals for service businesses — web development, consulting, trades, professional services, creative agencies. The goal is a document that wins the work by showing you understood the problem, have a clear plan, and are easy to work with.

Before You Start

Gather these inputs. Ask for anything missing:

  1. Client name and business — who is this for, what do they do
  2. What they asked for — the brief, the problem, the conversation summary
  3. What you are proposing — your recommended solution at a high level
  4. Pricing — your numbers, or ask for guidance on range
  5. Timeline — how long, any fixed deadlines
  6. Tone — match the client relationship (new vs existing, corporate vs casual, local tradie vs enterprise)

If the user has notes from a discovery call or email thread, use those to write the "project understanding" section in the client's own language.


Proposal Structure

Present sections in this order. Every section earns its place — cut any that do not apply.

1. Project Understanding

This is the most important section. It proves you listened. Restate the client's problem in their words, not yours. Show you understand what they are trying to achieve, not just what they asked you to build.

Too corporate:

We understand that your organisation is seeking to leverage digital transformation to enhance customer engagement across multiple touchpoints and drive sustainable growth through an integrated online presence.

Right tone:

You have been running the business for 12 years on word-of-mouth alone, and it has worked — you are booked out most weeks. The problem is that when someone searches "plumber Newcastle" you do not show up, and you are losing jobs to competitors with half your experience. You want a website that shows up in local search and makes it easy for people to call or book online.

Rules for this section:

  • Use the client's language, not industry jargon
  • Reference specific details from the conversation ("you mentioned", "as we discussed")
  • State the business problem, not just the technical requirement
  • Keep it to 2-3 short paragraphs

2. Proposed Solution

High-level description of what you will do and why this approach makes sense for them. This is the "what and why", not the detailed scope.

Connect the solution back to their problem. "Because you need local customers to find you, we will build the site on WordPress with a focus on local SEO structure from day one" is better than "We will build a WordPress website with SEO."

One to two paragraphs. Save the detail for the scope section.

3. Scope and Deliverables

Numbered list of specific items the client will receive. Each item should be concrete enough that both parties can agree on whether it was delivered.

Too vague:

  • Website design and development
  • SEO optimisation
  • Ongoing support

Right level of detail:

  1. Custom WordPress website — up to 8 pages (Home, About, Services x4, Contact, Blog)
  2. Mobile-responsive design matching your brand colours and logo
  3. Local SEO setup — Google Business Profile optimisation, schema markup on all pages, location-based meta titles
  4. Contact form with email notifications to your nominated address
  5. Online booking integration with your existing Calendly account
  6. Basic analytics setup (Google Analytics 4 + Google Search Console)
  7. 30-minute training session on how to update content yourself
  8. 30 days of post-launch support for bug fixes and minor adjustments

What is NOT included is just as important as what is. Add an exclusions note at the bottom of this section:

Not included in this scope: Ongoing content writing, paid advertising setup or management, additional pages beyond the 8 listed above, custom functionality not described here. These can be quoted separately if needed.

4. Timeline

Phases with durations or target dates. Show the client what happens when.

PhaseDurationWhat happens
Discovery and planningWeek 1Content gathering, sitemap sign-off
DesignWeeks 2-3Homepage mockup, revision, remaining pages
DevelopmentWeeks 3-5Build, integrations, internal testing
Review and launchWeek 6Client review, revisions, go-live

If there is a fixed deadline (event, season, campaign), state it and work the timeline back from it. Flag any dependencies on the client: "This timeline assumes content and images are provided by [date]."

5. Investment

Frame pricing as an investment, not a cost. Present confidently — no hedging, no apologising for the number.

Choose the pricing format that suits the project:

Single price (simple projects):

Investment: $4,500 + GST

This covers everything listed in the scope above — design, development, SEO setup, training, and 30 days of post-launch support.

Good / Better / Best packages (gives the client choice):

StarterProfessionalPremium
Pages5812
DesignTemplate-basedCustom designCustom + brand guide
SEOBasic on-pageLocal SEO packageLocal SEO + content strategy
Support14 days30 days90 days
Investment$2,500$4,500$7,500

Package pricing works well when the client is unsure of scope. The middle option is typically where you want them to land — price it as the best value.

Line items (transparency-focused):

ItemInvestment
Design (homepage + 7 inner pages)$1,800
Development and integrations$1,500
Local SEO setup$600
Training and documentation$300
30-day post-launch support$300
Total$4,500 + GST

Line items invite line-item negotiation ("Can we drop the training?"). Use when the client has asked for a breakdown or when transparency builds trust.

Value-based framing (optional addition to any format):

For context: businesses in your area that rank on the first page for "plumber Newcastle" report an average of 15-20 inbound enquiries per month. At your average job value, this site should pay for itself within the first 2-3 months of consistent rankings.

Only use value framing when you can back it up with real numbers or reasonable estimates. Do not invent statistics.

6. About Us

Brief credibility section. Two to three sentences, not a company history.

Jezweb has been building websites for Australian businesses since 2009. We work primarily with trades and service businesses in the Hunter Valley and across NSW. Over 200 active clients trust us to keep their sites running and ranking.

Include one or two proof points: years in business, number of clients, relevant case study, industry-specific experience. Skip the mission statement and founding story.

7. Next Steps

Clear, single call to action. Tell the client exactly what to do next.

To get started, reply to this email with a "go ahead" and we will send through an invoice for the first payment. We will then schedule a 30-minute kickoff call to gather your content and lock in the timeline.

Or:

If you are happy to proceed, sign the attached agreement and return it by [date]. We will invoice the deposit and start the discovery phase the following week.

Do not offer three different next steps. One action, clearly stated.

8. Terms

Keep it short and plain-language. Cover the essentials:

  • Payment schedule — e.g., 50% deposit to commence, 50% on completion (or milestone-based for larger projects)
  • Revision limits — e.g., 2 rounds of design revisions included; additional rounds at $X/hour
  • Timeline assumptions — e.g., timeline assumes client feedback within 5 business days at each review point
  • Ownership — e.g., all design files and code are yours once final payment is received
  • What happens if scope changes — e.g., changes beyond the agreed scope will be quoted separately before work begins

Do not write a legal contract. This section sets expectations. If the client needs formal terms, reference a separate T&C document.


Tone Rules

Confident, not arrogant. "We will" not "We would endeavour to." State what you will do as a matter of fact.

Specific, not vague. "8 pages" not "a multi-page website." "$4,500" not "competitive pricing." "Week 3" not "in due course."

Brief, not padded. If a section can be said in two sentences, do not write four. The client is busy. Respect that.

Human, not robotic. Write like you are explaining the plan to someone sitting across the table. Contractions are fine. First person is fine.

Honest about limits. If something is not included, say so up front. If there is a risk (timeline depends on client providing content), name it. Clients trust people who are straight with them.


Avoid List

  • Jargon the client will not understand. "Headless CMS with SSR via edge functions" means nothing to a plumber. Say "a fast, modern website that is easy for you to update."
  • "We're passionate about..." Nobody is passionate about building websites for a plumbing company. You are good at it and you will do a thorough job. That is enough.
  • Company history padding. "Founded in 2009 by Jeremy Dawes with a vision to..." — save it for the About page. The proposal is about the client, not about you.
  • Burying the price. Put the investment section where the client expects it — after scope and timeline. Do not hide it on page 7 after three pages of methodology.
  • Weasel words. "Up to", "as low as", "starting from" — be direct about what it costs.
  • Promising what you cannot deliver. "Guaranteed first page rankings" or "Your investment will generate $X in revenue." If you cannot guarantee it, do not write it.

Pricing Section Examples

Too corporate:

We are pleased to present our proposed investment framework for the delivery of the aforementioned scope of work. Our pricing model reflects our commitment to delivering exceptional value while maintaining the highest standards of quality and innovation in our deliverables.

Total proposed investment: $4,500.00 (exclusive of GST)

Right tone:

Investment: $4,500 + GST

That covers everything listed above — design, build, SEO setup, training, and a month of support after launch. No hidden fees.

Payment is split 50/50: half up front to get started, half when the site goes live.


Output Format

Deliver the proposal as clean markdown with clear section headings. If the user needs a formatted file, offer to create it as markdown they can paste into Google Docs, Canva, or their proposal tool.

For proposals that need to look polished (PDF to a corporate client), suggest the user paste the content into their branded template. The skill produces the words, not the layout.

Match the regional tone of the client. Default to Australian English unless told otherwise.

FAQ

What does the proposal-writer skill do?

Write a client proposal, quote, scope of work, or engagement letter for a service business. Covers project understanding, scope, timeline, pricing presentation, and terms. Use whenever the user asks for a proposal, quote, project proposal, client proposal, SOW, statement of work, engagement letter, or B2B service engagement document — for web dev, consulting, trades, or any service business.

How do I install proposal-writer?

Run npx skills add https://github.com/jezweb/claude-skills --skill proposal-writer in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/proposal-writer/ (personal) or .claude/skills/proposal-writer/ (project).

Which AI agents can use proposal-writer?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is proposal-writer safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains proposal-writer?

It is published by jezweb in jezweb/claude-skills. It has 1,222 recorded installs.

More from jezweb/claude-skills

View all →

shadcn-ui

jezweb/claude-skills

Install and configure shadcn/ui components for React projects. Guides component selection, installation order, dependency management, customisation with semantic tokens, and common UI recipes (forms, data tables, navigation, modals). Use after tailwind-theme-builder has set up the theme infrastructure, when adding components, building forms, creating data tables, or setting up navigation.

Frontend & Design3.6K installs

color-palette

jezweb/claude-skills

Generate complete, accessible colour palettes from a single brand hex. Produces 11-shade scale (50-950), semantic tokens, dark mode variants, Tailwind v4 CSS output, WCAG contrast checks. Use whenever the user supplies a brand hex and asks for a palette, mentions setting up a design system, wants Tailwind theme colours from a brand colour, or asks to check colour accessibility / contrast.

Frontend & Design3.2K installs

tailwind-theme-builder

jezweb/claude-skills

Set up Tailwind v4 + shadcn/ui themed UI with dark mode. Install deps, configure CSS variables via @theme inline, wire dark mode toggle, verify. Use whenever the user mentions Tailwind v4, setting up Tailwind theming, shadcn/ui colours, dark mode, or troubleshooting colours not working, tw-animate-css errors, @theme inline conflicts, @apply breaking after upgrade, or v3 → v4 migration issues.

Frontend & Design3.2K installs

wordpress-elementor

jezweb/claude-skills

Edit Elementor pages and manage templates on WordPress sites via browser automation (for visual / structural changes) or WP-CLI (for safe text replacements). Use whenever the user wants to edit an Elementor page, update text in Elementor widgets, apply or manage Elementor templates, or make content changes to pages built with the Elementor page builder.

ux-audit

jezweb/claude-skills

Walk through a live web app AS a real user to find usability + behavioural bugs that static reviews miss. REQUIRES proof of interaction (typing, clicking, sending, observing) before any verdict — a sweep that didn't interact terminates with verdict 'Incomplete'. Walks threads, exercises every element, runs the multi-pane stress matrix, visual polish sweep, component perfection checklist, automated a11y (axe-core), pragmatic performance budget (LCP/CLS/INP), scenario battery (11 scenarios), and stress recipes including the real-flavour data battery. Hard gates: console errors/warnings = 0, network 5xx = 0, layout collapse = 0, axe Critical/Serious = 0, perf budget green. Audit-the-audit meta-check rejects rushed reports. Each finding has reproduction steps, evidence path, and suspected code location. Trigger with 'ux audit', 'walkthrough', 'qa sweep', 'audit the app', 'dogfood this', 'check all pages', 'find what's broken', 'stress the UI'.

Frontend & Design2.8K installs

tailwind-v4-shadcn

jezweb/claude-skills

Set up Tailwind v4 with shadcn/ui using @theme inline pattern and CSS variable architecture. Four-step pattern: CSS variables, Tailwind mapping, base styles, automatic dark mode. Prevents 8 documented errors. Use when initializing React projects with Tailwind v4, or fixing colors not working, tw-animate-css errors, @theme inline dark mode conflicts, @apply breaking, v3 migration issues.

Frontend & Design2.6K installs

Popular docs & writing skills

View category →

grill-with-docs

mattpocock/skills

A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.

Docs & Writing1.2M installs

lark-markdown

open.feishu.cn

飞书 Markdown:查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。

Docs & Writing778.7K installs

writing-beats

mattpocock/skills

Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.

Docs & Writing490.7K installs

writing-shape

mattpocock/skills

Writing, exploit: shape raw material into an article, paragraph by paragraph.

Docs & Writing490.2K installs

writing-fragments

mattpocock/skills

Writing, explore: mine raw fragments, no structure yet.

Docs & Writing489.6K installs

writing-for-agents

mattpocock/skills

Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.

Docs & Writing479.3K installs