Agent skill

Proposal Writer

by jezweb in jezweb/claude-skills

Write a client proposal, quote, scope of work, or engagement letter for a service business.

MITAuto-check passedSales & Support

Install Proposal Writer

skills CLI
$ npx skills add jezweb/claude-skills --skill proposal-writer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jezweb/claude-skills proposal-writer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jezweb/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/writing/skills/proposal-writer .claude/skills/proposal-writer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
proposal-writer
GitHub stars
1.1k
Token cost
~2.9k tokens
SKILL.md length
1,666 words
Files
1
Skills in repo
52
Repo updated
First seen
Licence
MIT

At a glance

Write a client proposal, quote, scope of work, or engagement letter for a service business.

  • Works in 8 steps: Project Understanding → Proposed Solution → Scope and Deliverables → …
  • The user asks for a proposal
  • SKILL.md covers Before You Start, Proposal Structure, Tone Rules and Avoid List, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Proposal Writer is an agent skill from jezweb/claude-skills. 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.

Its SKILL.md is about 2.9k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Sales & Support, covering Proposals and quotes. The repository describes itself as: Skills for Claude Code CLI such as full stack dev Cloudflare, React, Tailwind v4, and AI integrations. The licence is MIT.

When your agent uses it

  • The user asks for a proposal
  • Project proposal
  • Client proposal
  • Statement of work

Example prompts

  • “/proposal-writer”

Workflow steps

8 steps, taken from the step headings in SKILL.md.

  1. Project Understanding
  2. Proposed Solution
  3. Scope and Deliverables
  4. Timeline
  5. Investment
  6. About Us
  7. Next Steps
  8. Terms

What it can do on your machine

Read from SKILL.md and the folder at commit 64965d9. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Proposal Writer loads about 2.9k tokens when it runs. Until then it costs about 103 tokens; SKILL.md has 1,666 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~103
When it runs · the whole SKILL.md, loaded when a task matches
~2.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jezweb/claude-skills at commit 64965d9, republished under its MIT licence (© jezweb). 1,666 words, ~2,864 tokens.

Download SKILL.mdSave it as .claude/skills/proposal-writer/SKILL.md (or your agent's skills folder).
name
proposal-writer
description
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.

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.

Show full SKILL.md (650 more words)Show less
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.

© jezweb, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/writing/skills/proposal-writer of jezweb/claude-skills.

Open the folder on GitHubat commit 64965d9

Compare with similar skills

Proposal Writer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Proposal Writer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Proposal Writer this skilljezweb/claude-skills1.1k—~2.9kAutomated safety check: PassMIT
Doc Coauthoringaws-samples/sample-strands-agent-with-agentcore19540 repos~3.2kAutomated safety check: PassMIT
Audit Onboarding Proposalhoangnb24/repository-harness1.2k—~4kAutomated safety check: PassMIT
No Negative EchoLB623/no-negative-echo897—~965Automated safety check: PassMIT
GEO Service Proposal Generatorzubair-trabzada/geo-seo-claude11k—~3kAutomated safety check: NotesMIT
Architectural ProposalsFritzAndFriends/SharpSite1452 repos~1.6kAutomated safety check: PassMIT

Similar skills

  • Doc Coauthoring

    aws-samples/sample-strands-agent-with-agentcore

    Official

    Guide users through a structured workflow for co-authoring documentation.

    195 GitHub starsUsed in 40 repos~3.2k tokens
    Sales & SupportAuto-check passed
  • Audit Onboarding Proposal

    hoangnb24/repository-harness

    Use only when the user explicitly invokes $audit-onboarding-proposal.

    1.2k GitHub stars~4k tokensUpdated 4 days ago
    Sales & SupportAuto-check passed
  • No Negative Echo

    LB623/no-negative-echo

    Prevent 此地无银三百两式 residue: finalize artifacts without echoing rejected session-only alternatives into labels, metadata, commits, PRs, or handoffs.

    897 GitHub stars~965 tokensUpdated 1 mo ago
    Sales & SupportAuto-check passed
  • GEO Service Proposal Generator

    zubair-trabzada/geo-seo-claude

    Builds a client-ready AI-search-optimization proposal from an existing GEO audit, with pricing tiers, an ROI estimate and a markdown document ready to send.

    11k GitHub stars~3k tokensUpdated yesterday
    Sales & SupportAuto-check: notes
  • Architectural Proposals

    FritzAndFriends/SharpSite

    How to write comprehensive architectural proposals that drive alignment before code is written

    145 GitHub starsUsed in 2 repos~1.6k tokens
    Sales & SupportAuto-check passed
  • Task Profile

    techwolf-ai/ai-first-toolkit

    Mine the user's Claude Code + Cowork session history into a structured task profile, what they do with AI, how often, how successfully where friction lives, then propose atomic skills that would…

    132 GitHub stars~3.6k tokensUpdated 9 days ago
    Sales & SupportAuto-check passed

More from jezweb/claude-skills

All 52 skills in this repo
  • Elevenlabs Agents

    jezweb/claude-skills

    Build conversational AI voice agents on the ElevenLabs platform.

    1.1k GitHub starsUsed in 1 repo~3.3k tokens
    Auto-check passed
  • Favicon Gen

    jezweb/claude-skills

    Generate custom favicons from logos, text, or brand colours.

    1.1k GitHub starsUsed in 1 repo~1k tokens
    Auto-check passed
  • Tailwind Theme Builder

    jezweb/claude-skills

    Set up Tailwind v4 + shadcn/ui themed UI with dark mode. An agent skill from jezweb/claude-skills.

    1.1k GitHub starsUsed in 1 repo~3.2k tokens
    Auto-check passed
  • Project Health

    jezweb/claude-skills

    All-in-one project configuration and health management. An agent skill from jezweb/claude-skills.

    1.1k GitHub starsUsed in 1 repo~3k tokens
    Auto-check passed
  • Responsiveness Check

    jezweb/claude-skills

    Test website responsiveness across viewport widths using browser automation.

    1.1k GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check passed
  • MCP Builder

    jezweb/claude-skills

    Build MCP servers in Python with FastMCP. An agent skill from jezweb/claude-skills.

    1.1k GitHub stars~3.1k tokensUpdated 3 days ago
    Auto-check: notes

Categories

Questions about Proposal Writer

What does Proposal Writer do?

Write a client proposal, quote, scope of work, or engagement letter for a service business. Proposal Writer is an agent skill from jezweb/claude-skills. Write a client proposal, quote, scope of work, or engagement letter for a service business.

When should I use Proposal Writer?

Proposal Writer fits situations like: the user asks for a proposal; project proposal; client proposal; statement of work.

How do I install Proposal Writer in Claude Code?

Run `npx skills add jezweb/claude-skills --skill proposal-writer -a claude-code`. Or copy the skill folder (plugins/writing/skills/proposal-writer in jezweb/claude-skills) into .claude/skills/proposal-writer in your project. Claude Code loads it when a task matches its description.

How do I install Proposal Writer in Codex?

Run `npx skills add jezweb/claude-skills --skill proposal-writer -a codex`. Or copy the skill folder (plugins/writing/skills/proposal-writer in jezweb/claude-skills) into .agents/skills/proposal-writer in your project. Codex loads it when a task matches its description.

Can I use Proposal Writer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jezweb/claude-skills --skill proposal-writer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/proposal-writer, .gemini/skills/proposal-writer, .github/skills/proposal-writer and .opencode/skills/proposal-writer in your project.

What does Proposal Writer need to run?

SKILL.md names no scripts, command-line tools or credentials: Proposal Writer is instructions for the agent only.

Does Proposal Writer access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Proposal Writer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Proposal Writer use?

Proposal Writer is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Proposal Writer use?

About 2.9k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Proposal Writer?

Skills that share tags, products or a category with Proposal Writer: Doc Coauthoring (aws-samples/sample-strands-agent-with-agentcore, 195 stars), Audit Onboarding Proposal (hoangnb24/repository-harness, 1.2k stars), No Negative Echo (LB623/no-negative-echo, 897 stars) and GEO Service Proposal Generator (zubair-trabzada/geo-seo-claude, 11k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Proposal Writer?

jezweb (a GitHub user) maintains it in jezweb/claude-skills, which has 1,051 GitHub stars. The repository holds 52 skills in this directory. The repository was last updated on October 5, 2026.

Source: jezweb/claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.