proposal-writer
Skill0 starsChanged 5 months agoMITView on GitHub
Draft client proposals, quotes, scopes of work, and engagement letters for service work — project understanding, scope, timeline, pricing presentation, and terms. Use when writing any B2B service engagement document.
29 other projects use a version of this.
Adopted by
Most recently taken up by
- runbooklabhq/freelancer-ops-skills-litetheir own version, first seen Nov 8, 2026
- Jakeschincariol/closer-skilltheir own version, first seen Nov 8, 2026
- AgnesAI-Labs/agnet-skills-cntheir own version, first seen Nov 1, 2026
- jqaisystems/jqai-ai-skillstheir own version, first seen Nov 1, 2026
- Nomanriaz786/claude-consulting-teamtheir own version, first seen Nov 1, 2026
- genspark-ai/genofficetheir own version, first seen Oct 25, 2026
Used with
Projects with it also use sop-writer, weekly-report and 5 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
Dokkabei97Skillsop-writer
Creates Standard Operating Procedures for repetitive tasks. Generates step-by-step documentation with checklists, decision trees, and responsibility assignments to eliminate single points of failure.
Also in 3 projects that use this
Microsoft AzureSkillweekly-report
**WORKFLOW SKILL** — Generate weekly executive reports for the azd team. Pulls PR/issue/release data from GitHub, reads changelogs, combines with team notes, and produces a polished markdown report.
Also in 5 projects that use this
akhilkannurSkillcontent-repurposer
Also in 4 projects that use this
claude-office-skillsSkillmeeting-notes
>
Also in 3 projects that use this
LangChainSkilllinkedin-post
Write a LinkedIn post based on research findings or a given topic. Use this skill when asked to create LinkedIn content, professional posts, or thought leadership pieces.
Also in 3 projects that use this
seikaikyoSkillinterview-me
需求不明時的意圖萃取訪談:一次一題、每題附上自己的猜測、聽出「真正想要 vs 覺得應該要」,直到能預測使用者反應(約 95% 信心)才動工。適用:需求缺少對象 / 動機 / 成功標準 / 約束,或使用者點名「訪談我」「先確認一下」「我們確定嗎」。明確自足的指示、純資訊查詢、機械性操作不適用。
Also in 3 projects that use this
Other versions29 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 29
- genspark-ai/genoffice★ 12ksame name
- claude-office-skills/skills★ 433same name
- hamzafarooq/claude-code-starter★ 145same name
- duncan-buildroom/freeskills★ 65same name
- ncklrs/startup-os-skills★ 51same name
- Jakeschincariol/closer-skill★ 33same name
- Xipher-Labs/walter-os★ 8same name
- ARCASSystems/FounderOS★ 7same name
- chakmarebel/federal-proposal-copilot★ 4same name
- dotlabshq/crux★ 4same name
19 more not listed
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 repository20 other files it gives its agents.
- context-engineeringSkill
- multi-agent-patternsSkill
- prompt-injection-defenseSkill
- rag-retrievalSkill
- adr-writerSkill
- ci-cdSkill
- playwright-e2eSkill
- structural-searchSkill
- react-server-componentsSkill
- shadcn-uiSkill
- tailwind-v4Skill
- zustand-stateSkill
- accessibilitySkill
- api-designSkill
- database-patternsSkill
- debuggingSkill
- security-patternsSkill
- typescript-patternsSkill
- task-prioritizationSkill
- sitecore-xmcloudSkill
The file
We split this skill into the rules it gives an agent
12 rules. 0 are common, 12 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 21 edited versions we read keep these.
12
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 25
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 …
- Distinctive: line 44
Use the client's language, not industry jargon
- Distinctive: line 47
Keep it to 2-3 short paragraphs
- Distinctive: line 91
If there is a fixed deadline (event, season, campaign), state it and work the timeline back from it.
- Distinctive: line 132
Only use value framing when you can back it up with real numbers or reasonable estimates.
- Distinctive: line 152
Do not offer three different next steps.
- Distinctive: line 156
Keep it short and plain-language.
- Distinctive: line 164
Do not write a legal contract.
- Distinctive: line 174
Brief, not padded: If a section can be said in two sentences, do not write four.
- Distinctive: line 176
Human, not robotic: Write like you are explaining the plan to someone sitting across the table.
- Distinctive: line 178
Honest about limits: If something is not included, say so up front.
- Distinctive: line 187
Burying the price: Put the investment section where the client expects it — after scope and timeline.
“Common” is measured: kept by at least 6 in 10 of the 21 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
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:
- Client name and business — who is this for, what do they do
- What they asked for — the brief, the problem, the conversation summary
- What you are proposing — your recommended solution at a high level
- Pricing — your numbers, or ask for guidance on range
- Timeline — how long, any fixed deadlines
- 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:
- Custom WordPress website — up to 8 pages (Home, About, Services x4, Contact, Blog)
- Mobile-responsive design matching your brand colours and logo
- Local SEO setup — Google Business Profile optimisation, schema markup on all pages, location-based meta titles
- Contact form with email notifications to your nominated address
- Online booking integration with your existing Calendly account
- Basic analytics setup (Google Analytics 4 + Google Search Console)
- 30-minute training session on how to update content yourself
- 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.
| Phase | Duration | What happens |
| Discovery and planning | Week 1 | Content gathering, sitemap sign-off |
| Design | Weeks 2-3 | Homepage mockup, revision, remaining pages |
| Development | Weeks 3-5 | Build, integrations, internal testing |
| Review and launch | Week 6 | Client 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):
| Starter | Professional | Premium | |
| Pages | 5 | 8 | 12 |
| Design | Template-based | Custom design | Custom + brand guide |
| SEO | Basic on-page | Local SEO package | Local SEO + content strategy |
| Support | 14 days | 30 days | 90 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):
| Item | Investment |
| 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.
We have been building web platforms for B2B clients since 2015, working primarily with enterprise marketing and content teams. Dozens of clients trust us to keep their sites fast, accessible, and easy to maintain.
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.
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.

