borghei/Claude-Skills / tools/linkedin/linkedin-profile-optimizer
linkedin-profile-optimizer
VerifiedAudits and rewrites a LinkedIn profile from pasted text: headline, About, experience, skills, Featured, banner and photo. Use when reviewing a profile, fixing a headline or About, or preparing a profile before posting more.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 15.3 KB |
| assets/profile_rewrite_worksheet.md | markdown | 4.3 KB |
| assets/profile_template.json | config | 1.5 KB |
| assets/sample_profile.json | config | 2.4 KB |
| assets/sample_profile_rewritten.json | config | 4.7 KB |
| references/experience-skills-and-credibility.md | markdown | 9.6 KB |
| references/featured-and-visuals.md | markdown | 9.4 KB |
| references/headline-and-about.md | markdown | 10.7 KB |
| scripts/profile_auditor.py | script | 15.1 KB |
| scripts/profile_rules.py | script | 15.2 KB |
references/featured-and-visuals.md
View on GitHub# Featured Section, Banner and Photo
The parts of a profile a visitor sees before reading a sentence. Dimensions
and placement behaviour below are current as of writing and change without
notice; verify in the product, and always check the result on a phone.
## Contents
1. Why these three are grouped
2. Featured: the slot model
3. Slots by goal
4. Titles and thumbnails
5. When to rotate
6. Banner
7. Photo
8. Self-assessment for the auditor
9. Review checklist
## 1. Why these three are grouped
The photo, banner and Featured row are the visual top of the profile. They are
also the three places where the default is an empty or generic state, so they
are where a small amount of effort produces the most visible change. None of
them can be assessed from pasted text, which is why the auditor asks you to
answer questions about them instead of guessing.
## 2. Featured: the slot model
Featured is the only section where you choose what a visitor sees first and in
what order. Treat it as a small number of slots, each with a job.
| Slot | Job | Typical items |
|------|-----|---------------|
| Proof | Shows that the claim in the headline is true | Case study, results write-up, portfolio piece, testimonial, shipped project |
| Depth | Shows how you think | Your strongest post, an article, a recorded talk, a piece of research |
| Door | Gives the visitor the next step | Booking page, contact page, newsletter sign-up, careers page, open role |
**Recommendation:** three or four items, one per slot, with a second proof
item if you have a strong one. A long row scrolls sideways and most visitors
do not scroll it. The first two items carry nearly all of the attention, so
put the proof slot first unless the goal is authority.
An item belongs in Featured only if you would be content for it to be the
single thing a visitor opened.
## 3. Slots by goal
| Goal | First | Second | Third | Leave out |
|------|-------|--------|-------|-----------|
| Clients | Proof: a case with a named scope and outcome | Depth: the post or article that best explains your method | Door: how to start a conversation | A services brochure |
| Job search | Proof: portfolio or the project you most want to be asked about | Proof or depth: a second work sample or a post showing how you reason | Optional: a talk or write-up | A CV as a PDF (the profile is the CV) |
| Authority | Depth: the piece you most want to be known for | Depth or proof: an outside appearance, a talk, research | Door: the channel you own (newsletter, book) | Every appearance you have ever made |
| Hiring | Proof: what the team is like, told by the team | Depth: a piece on how the team works | Door: the careers page or the specific open role | A generic company video |
Things that weaken any Featured row:
- an employer's corporate announcement with nothing of yours in it;
- an item that needs a login or a download before the visitor learns anything;
- anything dated enough that the visitor wonders what you have done since;
- a "selected writing" pile with no order.
## 4. Titles and thumbnails
Each item shows a title and an image. Both are editable for most item types.
**Titles.** State what the visitor gets, not what the format is.
| Format-first title | Payoff-first title |
|--------------------|--------------------|
| "Case study" | "How a 62-seller CRM migration cut over in one weekend" |
| "My talk at a regional conference" | "Why forecasts drift: a 20-minute talk with the worked numbers" |
| "Newsletter" | "A Friday note on revenue operations, read by sales leaders" |
| "Portfolio" | "Six shipped checkout redesigns, with before-and-after flows" |
The auditor flags very short titles and titles built from format words
(rule FT-04).
**Thumbnails.** A consistent set looks deliberate. Use the same background and
type across items, keep the text large enough to read at phone size, and leave
margins, because the crop differs between surfaces. Link previews are commonly
drawn at about a 1.91:1 ratio (1200 by 627 pixels is a widely used size as of
writing); check how your item type is cropped before producing a set.
## 5. When to rotate
Review Featured on a schedule and on events.
| Trigger | Action |
|---------|--------|
| Quarterly review | Replace anything that is no longer your best example of its slot |
| A new piece of work clearly beats an existing item | Swap it in the same week |
| Change of goal (for example, clients to job search) | Rebuild all slots; the old row argues for the old goal |
| A launch or campaign | Give the door slot to it for the duration, then restore |
| An item passes a year old | Keep only if it is still the strongest proof you have |
Age alone is not a reason to remove something. A two-year-old case study that
remains your best proof stays. A two-year-old webinar recording does not.
## 6. Banner
The banner is the widest piece of space on the profile and most people leave
it as the default.
**Mechanics, as of writing.** The recommended personal banner size is 1584 by
396 pixels (a 4:1 ratio). The profile photo overlaps the lower left of the
banner, and the overlap is larger and positioned differently on a phone than on
a desktop. Verify both the size and the overlap in the product.
**What to put on it.** One of these, not all:
| Option | Use when |
|--------|----------|
| One line saying what you do and for whom | The headline is doing a different job (for example, anchored on a job title) |
| The next step (a site, a newsletter, "hiring engineers") | You have one clear action |
| An image of the work itself | The work is visual: products, buildings, stages, print |
| A plain brand field with a small mark | You want it tidy and unobtrusive |
**Composition rules.**
- Keep text away from the lower left. A safe habit is to place all text in the
right-hand half and the upper two thirds.
- One line of text, large. If it needs a second line it is too long.
- High contrast between text and background; avoid text over a busy photo.
- No more than two typefaces and a restrained palette.
- Nothing essential within the outer margin, which some surfaces crop.
**Checking it.** Upload it, then open your own profile on a phone and on a
desktop. Confirm the text is fully visible and not under the photo on both.
This check takes two minutes and is the step most often skipped.
**Common failures.** Stock imagery unrelated to the work; a slogan that could
belong to anyone; a logo hidden behind the photo; a paragraph of small text;
contact details that duplicate the contact section and will go out of date.
## 7. Photo
The photo appears at thumbnail size beside everything you post or comment on.
It is judged at about the size of a fingernail.
**Mechanics, as of writing.** The product asks for a square image and
recommends at least 400 by 400 pixels; it is displayed in a circle, so the
corners are lost. Verify in the product.
| Check | Pass | Fail |
|-------|------|------|
| Subject | You alone | A cropped group shot with someone's shoulder in frame |
| Framing | Head and shoulders, face filling a good part of the circle | Full-length shot where the face is a few pixels |
| Face | Clearly visible, looking at or near the camera | Sunglasses, heavy shadow, turned away |
| Light | Even, from the front or side; daylight near a window works | Backlit, or harsh overhead light |
| Background | Plain or softly out of focus | Busy scene that competes with the face |
| Recency | You would be recognised from it at a first meeting | Visibly from another decade |
| Treatment | Natural | Heavy filters or retouching that changes how you look |
Dress as you would to meet the audience the profile is for. Expression is a
matter of taste; approachable is a safer default than stern.
Generated or heavily altered portraits are a judgement call. If someone meeting
you would be surprised, the photo is working against you.
Accessibility: thumbnails are small and viewed in both light and dark
interface themes. A face against a mid-tone background survives both.
## 8. Self-assessment for the auditor
`profile_auditor.py` cannot see images. It reads these answers from the profile
JSON, so answer them by looking at the live profile on a phone.
| Field | Question to answer |
|-------|--------------------|
| `photo.present` | Is there a photo at all? |
| `photo.solo` | Are you the only person in it? |
| `photo.face_clear` | Is your face clearly visible at thumbnail size? |
| `photo.plain_background` | Is the background plain or uncluttered? |
| `photo.age_years` | How many years old is it? |
| `banner.present`, `banner.custom` | Is there a banner, and is it yours and not the default? |
| `banner.states_value` | Does it say what you do or what to do next? |
| `banner.text_clear_of_photo` | Is all text clear of the photo overlap? |
| `banner.checked_on_mobile` | Have you looked at it on a phone since uploading? |
| `featured[].type`, `title`, `age_months` | What kind of item is it, what does its title say, how old is it? |
An honest "false" is more useful than an optimistic "true"; the score is only
as good as the answers.
## 9. Review checklist
- [ ] Featured has a proof item, a depth item and a door, in the order the goal calls for
- [ ] Every title states a payoff
- [ ] Thumbnails share one visual treatment and read at phone size
- [ ] Nothing in the row needs a login to understand
- [ ] Banner is custom and says one thing
- [ ] Banner text is clear of the photo on phone and desktop
- [ ] Photo is solo, recent, well lit, face clear at thumbnail size
- [ ] Sizes and overlap re-verified in the product on the day of upload
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |