freelance_profile_optimization v1.0.0

name: freelance_profile_optimization description: "Audit and fix a freelance marketplace profile on any platform: a scored audit across headline, overview, proof, search wording and trust, fixing the weakest section first, plus the AI search layer that decides whether clients who start in ChatGPT or other assistants ever reach the profile. Use when a freelancer gets few views or invites, is joining Upwork, Fiverr, Contra, Toptal or a niche marketplace, is launching a new service line, or asks why a good portfolio is not converting."

Freelance Profile Optimization

Purpose

Turn a marketplace profile from a CV into a page that does three jobs at once. It matches the searches clients actually run, it proves the work in a way a client can check in under a minute, and it gives one clear next step. The audit is platform neutral. It works on Upwork, Fiverr, Contra, Toptal, LinkedIn service pages and niche marketplaces, because the failure modes are the same everywhere: a vague headline, an overview written about the freelancer instead of the buyer, proof that proves nothing, and skill lists that describe four different jobs.

A second layer now matters as well. Some clients start in an AI assistant instead of the marketplace. Upwork launched an app inside ChatGPT in April 2026, reported from its own release, so discovery can start outside the platform. This skill covers that layer too: consistent identity across profiles, a readable portfolio page, structured data, crawler access, and a monthly prompt test.

Evidence tiers used in this skill: Official means a platform help page or a standards doc says it. Reported means practitioners or a company release describe it. Everything else is this skills operating advice, stated as advice. Full sources are in the research notes kept with the production run, and the key official points are named inline below.

Workflow

1. Gather the profile as a client sees it

• Collect the exact headline, the full overview or Gig description, the skill list in order, every portfolio item with its title and description, the visible rate, availability and badges, and a count of reviews or testimonials shown.
• Ask for the target: the one offer this profile should sell, the buyer type, and 3 to 5 phrases that buyer would type into search. Call these target queries. An audit without a target buyer grades against nothing.
• View the profile logged out or in search preview where the platform allows it. Judge the preview, not the edit screen. The preview is all most clients ever see.

2. Score it, weakest first

• Run the scorer when the profile can be put in JSON: python3 scripts/profile_audit.py profile.json. A demo profile ships with it: python3 scripts/profile_audit.py --demo prints a 28 out of 100 example with fix lines.
• Or score by hand with references/audit-rubric.md. Five sections: Headline 20, Overview 25, Proof and portfolio 20, Search wording 20, Trust and conversion 20.
• Report the total and the weakest section by name. Fix order is part of the method: finish the weakest section before polishing any strong one.

3. Fix the headline

• Use the pattern Role, Specialty, Buyer or Outcome. Example: Shopify Developer, Custom Themes and Landing Pages for Small Stores.
• Put the exact service phrase from the target queries in the headline. Official, Fiverr: search relevance is how closely title, description and metadata match the clients query. The same matching logic is why a creative slogan headline fails on every platform: it matches no query a client types.
• Cut vague filler: expert, passionate, guru, creative professional. Replace each vague word with a tool, a deliverable or a buyer type.
• Keep it to 3 to 14 words unless the platform gives a hard character limit that forces shorter.

4. Rewrite the overview as an offer

• Open with who you help and what they get, with a target query phrase in the first 40 words. Search previews and skimmers see the opening only.
• Follow this order: buyer and outcome, what they get, how the work runs in 2 to 4 short steps, one proof line, one next step. Worked rewrites are in references/before-after.md.
• Write in buyer language. Any sentence that would sit happily on a CV should be rewritten to name the deliverable or the result for the client.
• Use proof numbers only when they are true, yours to claim, and clear about scope or time frame. If you did not control the final business result, claim the output: pages built, episodes edited, articles delivered.
• Close with one action only: message with the project link, book a short call, or order the starter package. Two competing calls to action convert worse than one clear one, and no closing line converts worst of all.

5. Rebuild proof

• Require at least 3 portfolio items for the target offer. Each item needs a title that names the job and the buyer type, a short context, your exact role, and an outcome or a concrete output.
• Order items for the target buyer, strongest and most relevant first. Remove weak or unrelated work instead of padding the list.
• For freelancers new to a platform: use proof from past jobs, employment, volunteer work or samples, with permission, and label the origin plainly. A sample for a fictional client must say so. Never invent a client, a testimonial or a result, and never show confidential work without permission. An anonymised case study that states the goal, your scope and the type of result is the safe form.
• Surface testimonials where the platform allows it and ask past clients for them with a specific prompt: what the job was, what changed, and whether they would hire again. A specific testimonial beats a page of five star ratings with no words.

6. Fix search wording

• Build the target query list from real client language: job posts in the niche, the marketplaces own search suggestions, and the words past clients used in their first message. Keep 3 to 5 queries per profile.
• Check each query against headline, overview and skills. Work a missing phrase in naturally, once, in the section a client would expect it. Do not repeat phrases for machines.
• Tighten skills to 5 to 15 items that all belong to one offer. A mixed list makes the profile a weak match for several jobs instead of a strong match for one. Where a platform supports specialised profiles or multiple listings, split separate offers there instead.
• Batch edits on Fiverr and similar platforms. Official, Fiverr: a Gig can drop from search briefly while the system re-indexes after edits. Make the full set of changes in one pass, then wait before judging the result.

7. Close the trust gaps

• Show a rate or a from price with a scope line. Clients filter and compare on price fit, and a profile with no price cannot be compared.
• State availability and a reply window you can keep. Official, Fiverr: responsiveness is one of the signals in search placement, and clients on every platform read reply time as a trust signal.
• Add at least 3 FAQs: scope and what is not included, revision policy, timeline, and what you need from the client to start. If clients keep asking the same clarification question, the answer belongs in the profile.
• Add a short video intro where the platform supports one and it states the offer clearly in the first seconds. Official, Fiverr: adding a Gig video is on Fiverrs own list of fixes for a Gig that is hard to find.
• Use a clear, current photo, or a clean studio mark for an agency profile. No sunglasses, no group photo, no logo as a personal avatar.

8. Run the AI search layer

Full detail in references/ai-search-layer.md. The short version:

• Keep one identity: same name, same headline wording and same service phrases on the marketplace profile, the portfolio site and professional profiles, linked to each other where allowed.
• Keep one public portfolio page with the offer, proof, price range and contact route in plain HTML text, not only in images or PDFs.
• If the freelancer controls that page, add ProfilePage structured data. Official, Google: ProfilePage needs a mainEntity typed Person or Organization, and a Person can carry sameAs links to their other profiles. Minimal block:

json
{
  "@context": "https://schema.org",
  "@type": "ProfilePage",
  "mainEntity": {
    "@type": "Person",
    "name": "Full Name",
    "description": "Shopify developer for small clothing and home goods stores.",
    "sameAs": [
      "https://www.upwork.com/freelancers/example",
      "https://www.linkedin.com/in/example"
    ]
  }
}

• Check robots.txt on the owned site. Official, OpenAI bot docs as published by OpenAI: OAI-SearchBot is the crawler for ChatGPT search and follows robots.txt, while GPTBot is a separate training crawler that can be blocked on its own. Allow the search bots wanted, and check bot protection presets that can block them at the edge.
• Run a monthly prompt test: 10 prompts a real buyer would ask an assistant, record whether the freelancer is named, linked and described correctly. Fix wrong facts first, then visibility.

9. Measure before rewriting again

• After publishing, leave the profile alone for two weeks unless a fact is wrong. Track views, search appearances where the platform shows them, messages, interviews and hires, plus the AI prompt test result.
• Change one section at a time after that window, so a change in results can be tied to a change in the profile.
• Re-audit quarterly, or whenever the offer, the buyer or the rate changes. A profile that sold a starter offer will undersell a specialist offer until it is rewritten.

Output Contract

Deliver, in this order:

1. The score table: five sections, points earned, total out of 100, weakest section named.
2. The fix list for the weakest section, finished rewrites included, not just advice. Headline and overview fixes are delivered as ready to paste text.
3. Rewrites for the other sections that scored under 70 percent of their max, also as ready to paste text where the section is text.
4. A portfolio plan: which items stay, which go, which need fields filled, and which new item to create first.
5. The search wording check: the 3 to 5 target queries and where each one now appears.
6. The AI search layer checklist with a pass or a specific gap for each of the five checks in step 8.
7. A two week measurement plan naming the exact numbers to watch on that platform.

State the evidence tier for any platform ranking claim you repeat. Never present a practitioner weight or percent as a platform rule.

Operating Rules

• Never invent numbers, clients, testimonials, certifications or results. Unverifiable means cut it or label it as a sample. This rule outranks conversion.
• Never copy another freelancers headline, overview or portfolio text. Structure can be studied, wording and proof cannot be borrowed.
• Never keyword stuff. Each target phrase earns its place by being true and useful to a human reader first.
• Never promise ranking, invites, hires or an AI recommendation. Promise a profile that is findable, readable and consistent, and say exactly that.
• Respect each platforms rules on contact and links. Some marketplaces restrict off platform contact or external links in profile text. Where a link is not allowed, use the platforms own portfolio and sharing tools instead, as Fiverr directs sellers to its Share tools.
• One profile, one offer. If the freelancer genuinely sells two different services to two different buyers, build two focused profiles or listings where the platform allows it, instead of one blended profile.
• Keep rates and availability honest and current. A reply window or availability claim the freelancer cannot keep will cost more in reviews than it earns in clicks.
• When you lack the target buyer, the target queries, or sight of the real profile, say what is missing and audit only what you can see. Do not score sections you have not seen.