Linkedin Profile Optimizer

LinkedIn Profile Optimizer

Most profiles are a CV pasted into a different box. The headline is a job title and an employer, the About is a third-person paragraph of adjectives, the experience entries list duties, Featured is empty and the banner is the default. None of that is wrong, exactly. It simply gives a visitor nothing to act on, and the headline, which travels beside every comment the person writes, says nothing to the people who will never open the profile.

This skill treats the profile as one argument aimed at one reader. It fixes the goal first, inventories the evidence, scores each section against a rule catalogue, and rewrites in priority order so the hour available goes to the sections that matter for that goal. It works offline: it reads profile text the user pastes and answers the user gives about the visuals. It does not fetch profiles, log in, post, or call any service.

Scope boundary. This skill covers the standing profile only. It does not write feed posts (linkedin-post-writer), strip machine-sounding phrasing from drafts (linkedin-humanizer), or test opening lines (linkedin-hook-analyzer). It does not write comments or handle replies and threads (linkedin-comment-writer, linkedin-reply-manager, linkedin-thread-tracker), plan or recycle content (linkedin-content-planner, linkedin-content-repurposer), or draw stories out of a person (linkedin-story-interviewer). Rolling profile standards out across a team is linkedin-employee-advocacy; working out who a post reached is linkedin-engagement-analytics. Each of those stands alone, as this one does.

When to use this skill

• Someone asks for a profile review, a headline rewrite or a better About
• A person is about to post regularly and the profile those posts lead to is CV-shaped
• A job search, a move to independent work or a new role changes what the profile is for
• A founder or hiring manager wants the profile to attract candidates or customers
• A profile was rewritten once and needs a quarterly check
• A draft headline or About exists and needs a second opinion before it goes live

Inputs the skill expects

• The profile as text: headline, About, each experience entry, skills (and which are in the top slots), Featured items, recommendations, public URL. A link is not enough; nothing here opens it
• Answers about the photo and banner, given while looking at the live profile on a phone (references/featured-and-visuals.md §8 lists the questions)
• The goal: clients, job search, authority or hiring
• Two to four search terms the target reader would type, and how that reader describes themselves
• Evidence the person can stand behind and is allowed to publish

Clarify First

Before auditing or rewriting, confirm these inputs. If any is unknown or vague, ASK — do not assume:

• The single goal (clients, job search, authority, hiring) — sets the section weights, the Featured slots and the closing action; a profile aimed at two goals argues for neither
• Who the reader is and what they would search for — without it the headline and skills checks have nothing to test against, and the rewrite defaults to generic wording
• What evidence exists and what may be published — decides whether the rewrite can use figures, must fall back to scope, or has to stop and collect proof first
• Whether the pasted text is the whole profile — never score a section that was not supplied, and never infer content from a URL or a name

Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.

Workflows

Workflow 1 — Quick start: audit a profile

1. Copy assets/profile_template.json and paste the profile text into it. Fill in goal, target_keywords and audience_terms; the keyword and audience checks are skipped when those are empty.
2. Answer the photo and banner fields by looking at the live profile on a phone. The tool cannot see images.
3. Run the auditor. Read the scorecard for where the weight is, then the fix list from the top.
4. The agent reports the scorecard, the five highest-priority fixes with their evidence, and any section it could not assess because the text was missing.

python3 tools/linkedin/linkedin-profile-optimizer/scripts/profile_auditor.py \
  --input tools/linkedin/linkedin-profile-optimizer/assets/sample_profile.json

Workflow 2 — Rewrite in priority order

1. Complete sections 1 and 2 of assets/profile_rewrite_worksheet.md (goal and evidence inventory) before writing a sentence.
2. Headline: draft the blocks, assemble three candidates, run the three tests in references/headline-and-about.md §4, choose one.
3. About: write the five moves, then read only the preview on a phone.
4. Experience: convert each duty line with the four questions in references/experience-skills-and-credibility.md §3. Verify that every figure is accurate and cleared for publication.
5. Skills, Featured, visuals and credibility: work the remaining worksheet sections in the order the fix list ranks them.
6. Deliver before and after for each rewritten section, with the assumptions and any evidence still to be confirmed listed at the top.

python3 tools/linkedin/linkedin-profile-optimizer/scripts/profile_auditor.py \
  --input tools/linkedin/linkedin-profile-optimizer/assets/sample_profile.json \
  --goal job_search --top 8

Workflow 3 — Re-audit and hold the line

1. Put the rewritten text into a second JSON file and run the auditor again.
2. Compare scores section by section. For every finding left open on purpose, record the reason in worksheet section 10.
3. Use --fail-under as a quality gate when a team wants a floor before profiles are linked from a campaign.
4. Validate the platform limits in the product on the day of publishing and pass any change with --headline-limit or --about-preview.
5. Set a review date: quarterly, and after any change of role or goal.

python3 tools/linkedin/linkedin-profile-optimizer/scripts/profile_auditor.py \
  --input tools/linkedin/linkedin-profile-optimizer/assets/sample_profile_rewritten.json \
  --fail-under 75 --format json

python3 tools/linkedin/linkedin-profile-optimizer/scripts/profile_rules.py --list-rules

Decision frameworks

Where the hour goes, by goal

The auditor weights sections by goal. These are editorial weights, not platform facts; change them in scripts/profile_rules.py if your situation differs.

Headline decisions