upwork-proposal-writer
Draft or review an Upwork proposal (cover letter) using the five-move method extracted from a Top Rated Plus freelancer's winning proposals, corrected for the AI era. Use when the user shares an Upwork job post and wants a proposal drafted, or shares an existing proposal draft and wants it reviewed. Triggers include "write a proposal", "apply for this job", "bid on this", "cover letter for this Upwork job", "review my proposal". Works for design, dev, and adjacent creative/tech freelance jobs.
abullaisi · AI review on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add abullaisi/upwork-skills --skill upwork-proposal-writerAbout this skill
name: upwork-proposal-writer description: Draft or review an Upwork proposal (cover letter) using the five-move method extracted from a Top Rated Plus freelancer's winning proposals, corrected for the AI era. Use when the user shares an Upwork job post and wants a proposal drafted, or shares an existing proposal draft and wants it reviewed. Triggers include "write a proposal", "apply for this job", "bid on this", "cover letter for this Upwork job", "review my proposal". Works for design, dev, and adjacent creative/tech freelance jobs.
Upwork Proposal Writer
Draft proposals the way a Top Rated Plus freelancer actually writes them, not the way template blogs say to. The method below was extracted from real winning proposals (design/dev niche, top 3% Upwork tier) and cross-checked against Upwork's own published guidance. Where the two disagree, this file says so.
Inputs you need before drafting
Ask for anything missing. Never invent these.
- The job post, pasted in full.
- The user's identity line facts: role, years of experience, niche specialization.
- 3-5 portfolio links or samples that match THIS job's niche. Matched proof beats impressive-but-unrelated proof. If the user gives you ten links, pick the closest 3-5 and say why.
- One relevant outcome they can claim (a shipped result, a metric, a client situation similar to this job). The outcome belongs in the credibility move. If the user can't supply one, draft without it and say so. Never invent one.
- Optional: rate intentions, availability, anything the client asked applicants to answer.
Profile shortcut: if a stored profile file exists (upwork-profile.md in the working directory or ~/.claude/), read identity, niche, links, and rate from it and ask only for what's missing or not stated concretely (a rate line that says "ask me" means ask). Never ask for what the file already answers.
Before drafting, check the job's core ask against the profile. If a major requirement sits outside what the profile actually covers, flag the stretch in one line before the draft. The draft itself only claims what's real.
Mode 1: Draft (primary)
The five moves, in order
Move 1: credibility line. One sentence: identity + years + niche. Example shape: "I'm a UI/UX designer with 5+ years specializing in SaaS dashboards." This is the first thing the client sees in the results-list preview, alongside the freelancer's photo, badges, rate, and Job Success Score. It has to establish fit in one line.
Move 1, no-history variant. A freelancer with no Upwork track record still has a credibility line; it just does not come from this platform. Build it from what is real: years in the craft anywhere, the work itself, a specialization. "I'm a UI/UX designer with 4 years on SaaS dashboards, new to Upwork and bringing the portfolio with me" is honest and reads far better than padding. Two rules. Never imply Upwork experience that does not exist, because the profile beside the proposal shows the truth and the gap reads as dishonesty. And never apologize for being new; state it once as a fact if at all, then spend the rest of the sentence on the specialization. The same applies to input 4: the relevant outcome can come from any client, employer, or personal project, and it is worth saying explicitly rather than leaving the user to assume Upwork-only.
Move 2: curated proof. Immediately place the 3-5 matched portfolio links or attachments. Before any pitch. Upwork's own data: freelancers with published portfolios are hired nine times more often. The curation is the skill: e-commerce links for an e-commerce job, motion links when the brief mentions motion. If the stored profile only has generic homepage links, still ask for samples matched to this job's niche. Matched proof beats stored convenience.
Move 3: mirror the brief. Restate the client's requirements back as a short bullet list ("Based on your brief, you need someone who can combine: ..."). This proves close reading, which is the one thing a template blast can never fake. For short invite replies, compress this to a single sentence naming their specific situation.
Move 4: phased plan (scoped and fixed-price jobs only). A numbered 2-4 step delivery plan ("1. staging prototype, 2. full storefront, 3. portal, 4. integration + testing"). It de-risks the hire by showing the shape of the work. Skip this entirely on quick invite replies; adding it there reads as boilerplate.
Move 5: question close. End with either 2-3 specific clarifying questions ("Quick questions so I don't guess wrong: ...") or one low-pressure open question ("What does success look like for this?"). A question invites a reply. Never hard-push a call; if the client proposes a call, accept immediately with zero sales copy.
High-stakes escalation (optional, big scoped jobs only). When the job is large enough to justify an hour of unpaid work, upgrade Move 2 from links to a small custom artifact: a two-minute walkthrough video, a quick audit of their current site, or one annotated mock. Practitioners running high-ticket funnels report this as their highest-converting move. Never do it for routine jobs; the economics only work when the contract size does.
Remember what the proposal is for. Its only job is to earn a profile visit and a reply. The profile closes what the proposal opens, so the portfolio there must be complete and current before any proposal volume makes sense (that is where the 9x hire-rate effect lives).
Length rules (hard)
- 200-300 words maximum for standard proposals. Three short paragraphs is the sweet spot.
- 3-4 sentences total for replies to client invitations.
- Length scales with job complexity, never with enthusiasm.
Voice rules (hard)
- Write like a person. Contractions, short sentences, plain words.
- No em dashes anywhere.
- Zero filler openers: no "I'm excited," no "I hope this finds you well," no "I came across your posting."