LinkedIn Profile Auditor

LinkedIn Profile — audit, then rewrite the parts that pay

by alirezarezvani · MIT license · ★ 26,349 on GitHub · updated Aug 30

LinkedIn Profile — audit, then rewrite the parts that pay cover

Use when someone wants their LinkedIn profile audited or rewritten — headline, About section, experience bullets, Featured, banner, recommendations — or says "fix my headline", "my profile gets views but nothing happens", "optimize my…

---
name: linkedin-profile
description: Use when someone wants their LinkedIn profile audited or rewritten — headline, About section, experience bullets, Featured, banner, recommendations — or says "fix my headline", "my profile gets views but nothing happens", "optimize my LinkedIn profile", "what should my About section say". Scores the headline on five dimensions, audits the whole profile 0-100 and ranks fixes by points per hour, and assembles an About section that survives the "…see more" fold.
license: MIT
metadata:
  version: 1.0.0
  author: Alireza Rezvani
  category: marketing
  updated: 2026-08-25
---

# LinkedIn Profile — audit, then rewrite the parts that pay

A profile is not a CV. A CV is read by someone who already decided to consider you; a
profile is read by someone deciding whether to. Three readers, in descending volume: the
**scanner** (three seconds, from your comment on someone else's post — sees photo and
headline only), the **evaluator** (forty seconds — headline, half the About, Featured), the
**decider** (minutes — everything). Almost all traffic is the scanner. Almost all conversion

Overview

A profile is not a CV. A CV is read by someone who already decided to consider you; a profile is read by someone deciding whether to. Three readers, in descending volume: the scanner (three seconds, from your comment on someone else's post — sees photo and headline only), the evaluator (forty seconds — headline, half the About, Featured), the decider (minutes — everything). Almost all traffic is the scanner. Almost all conversion is the decider.

Manual install (npx, ZIP)
Claude Codenpx skills add alirezarezvani/claude-skills --skill linkedin-profile -g -a claude-code
Claude Code (degit)npx degit alirezarezvani/claude-skills/marketing/linkedin/skills/linkedin-profile#main ~/.claude/skills/linkedin-profile-2
Claude.ai / desktopZip the folder and upload it under Settings → Capabilities → Skills.
Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

  • SKILL.md4.9 KB
Read SKILL.md here
alirezarezvani/main1 file shown
SKILL.md
Show the full text99 lines

LinkedIn Profile — audit, then rewrite the parts that pay

A profile is not a CV. A CV is read by someone who already decided to consider you; a profile is read by someone deciding whether to. Three readers, in descending volume: the scanner (three seconds, from your comment on someone else's post — sees photo and headline only), the evaluator (forty seconds — headline, half the About, Featured), the decider (minutes — everything). Almost all traffic is the scanner. Almost all conversion is the decider.

Workflow

1. Audit before rewriting. Ask them to describe their profile section by section, or have them fill assets/profile_worksheet.md, then:

python3 scripts/profile_completeness_auditor.py --input profile.json --output human

Exit 0 STRONG / 2 INCOMPLETE / 3 WEAK. It ranks every gap by points per hour and prints a first-hour plan — usually Featured, Open To, and skills, which cost minutes and recover real points. Start there, not with the About section they wanted to agonise over.

2. Headline next — it is the only string that travels. It rides along with every comment, search result, and invitation.

python3 scripts/headline_scorer.py --headline "..." --output human

Five dimensions at 20 points: audience, outcome, proof, searchability, clarity. Exit 0 SHIP (≥75) / 2 SHARPEN / 3 REWRITE. It also checks the 220-character cap and whether the first ~60 characters — the part that survives in search results and invitation previews — carry anything.

Iterate here. Two or three passes is normal; the stop condition is exit 0, or the user saying they would say it out loud to a peer.

3. About section — write to the fold. LinkedIn collapses it after roughly 265-300 characters. Collect the five parts from the user, then assemble:

python3 scripts/about_section_builder.py --input about.json --output human

It refuses a fold that cuts mid-sentence, a fold carrying no audience and no proof, a missing call to action, and anything over 2,600 characters.

4. Experience, Featured, recommendations. Rewrite duty lists as outcomes. Pin one artifact a stranger could evaluate in sixty seconds. Ask for two specific recommendations by naming the project and offering a first draft.

Rules

  • Never invent a credential, a metric, or a role. Every number on a profile is checkable by someone. If the proof does not exist, the claim is qualitative or it is absent.
  • First person. A profile in third person reads as a press release someone else wrote.
  • The fold is the section. Whatever sits above "…see more" is what most readers get.
  • Front-load the headline. The strongest segment first; everything after is a bonus.
  • Do not fetch anything. The user describes their own profile; nothing is scraped.

Scripts

Script Role
scripts/headline_scorer.py Headline 0-100 on audience / outcome / proof / searchability / clarity, plus the 220-char cap and front-load check.
scripts/profile_completeness_auditor.py Whole profile 0-100 across 14 weighted checks; fixes ranked by points per hour with a first-hour plan.
scripts/about_section_builder.py Assembles the About section from named parts and refuses a broken fold, a missing CTA, or an over-length section.

References and assets

Distinct from

  • linkedin-strategy — what to post and how often. This is who you are before you post. If the audience answer is fuzzy, run positioning_brief.py there first; the headline falls out of a good brief in ten minutes.
  • product-team/, c-level-advisor/ — career and role strategy. This writes the profile, not the career plan.

Version: 1.0.0

1---
2name: linkedin-profile
3description: Use when someone wants their LinkedIn profile audited or rewritten — headline, About section, experience bullets, Featured, banner, recommendations — or says "fix my headline", "my profile gets views but nothing happens", "optimize my LinkedIn profile", "what should my About section say". Scores the headline on five dimensions, audits the whole profile 0-100 and ranks fixes by points per hour, and assembles an About section that survives the "…see more" fold.
4license: MIT
5metadata:
6 version: 1.0.0
7 author: Alireza Rezvani
8 category: marketing
9 updated: 2026-08-25
10---
11 
12# LinkedIn Profile — audit, then rewrite the parts that pay
13 
14A profile is not a CV. A CV is read by someone who already decided to consider you; a
15profile is read by someone deciding whether to. Three readers, in descending volume: the
16**scanner** (three seconds, from your comment on someone else's post — sees photo and
17headline only), the **evaluator** (forty seconds — headline, half the About, Featured), the
18**decider** (minutes — everything). Almost all traffic is the scanner. Almost all conversion
19is the decider.
20 
21## Workflow
22 
23**1. Audit before rewriting.** Ask them to describe their profile section by section, or
24have them fill [`assets/profile_worksheet.md`](assets/profile_worksheet.md), then:
25 
26```bash
27python3 scripts/profile_completeness_auditor.py --input profile.json --output human
28```
29 
30Exit 0 STRONG / 2 INCOMPLETE / 3 WEAK. It ranks every gap by **points per hour** and prints
31a first-hour plan — usually Featured, Open To, and skills, which cost minutes and recover
32real points. Start there, not with the About section they wanted to agonise over.
33 
34**2. Headline next — it is the only string that travels.** It rides along with every comment,
35search result, and invitation.
36 
37```bash
38python3 scripts/headline_scorer.py --headline "..." --output human
39```
40 
41Five dimensions at 20 points: audience, outcome, proof, searchability, clarity. Exit 0 SHIP
42(≥75) / 2 SHARPEN / 3 REWRITE. It also checks the 220-character cap and whether the first
43~60 characters — the part that survives in search results and invitation previews — carry
44anything.
45 
46Iterate here. Two or three passes is normal; the stop condition is exit 0, or the user
47saying they would say it out loud to a peer.
48 
49**3. About section — write to the fold.** LinkedIn collapses it after roughly 265-300
50characters. Collect the five parts from the user, then assemble:
51 
52```bash
53python3 scripts/about_section_builder.py --input about.json --output human
54```
55 
56It refuses a fold that cuts mid-sentence, a fold carrying no audience and no proof, a
57missing call to action, and anything over 2,600 characters.
58 
59**4. Experience, Featured, recommendations.** Rewrite duty lists as outcomes. Pin one
60artifact a stranger could evaluate in sixty seconds. Ask for two specific recommendations by
61naming the project and offering a first draft.
62 
63## Rules
64 
65- **Never invent a credential, a metric, or a role.** Every number on a profile is checkable
66 by someone. If the proof does not exist, the claim is qualitative or it is absent.
67- **First person.** A profile in third person reads as a press release someone else wrote.
68- **The fold is the section.** Whatever sits above "…see more" is what most readers get.
69- **Front-load the headline.** The strongest segment first; everything after is a bonus.
70- **Do not fetch anything.** The user describes their own profile; nothing is scraped.
71 
72## Scripts
73 
74| Script | Role |
75|---|---|
76| [`scripts/headline_scorer.py`](scripts/headline_scorer.py) | Headline 0-100 on audience / outcome / proof / searchability / clarity, plus the 220-char cap and front-load check. |
77| [`scripts/profile_completeness_auditor.py`](scripts/profile_completeness_auditor.py) | Whole profile 0-100 across 14 weighted checks; fixes ranked by points per hour with a first-hour plan. |
78| [`scripts/about_section_builder.py`](scripts/about_section_builder.py) | Assembles the About section from named parts and refuses a broken fold, a missing CTA, or an over-length section. |
79 
80## References and assets
81 
82- [`references/profile_architecture.md`](references/profile_architecture.md) — what each section is for, and the three readers (7 sources)
83- [`references/headline_and_positioning.md`](references/headline_and_positioning.md) — the 220 characters that follow you everywhere (7 sources)
84 
85- [`assets/profile_worksheet.md`](assets/profile_worksheet.md) — fillable section-by-section worksheet
86- [`assets/example_profile.json`](assets/example_profile.json) — input shape for the auditor
87 
88## Distinct from
89 
90- **`linkedin-strategy`** — what to post and how often. This is who you are before you post.
91 If the audience answer is fuzzy, run `positioning_brief.py` there first; the headline
92 falls out of a good brief in ten minutes.
93- **`product-team/`, `c-level-advisor/`** — career and role strategy. This writes the profile,
94 not the career plan.
95 
96---
97 
98**Version:** 1.0.0
99 
View all files on GitHub →

Details

Updated
Aug 30, 2026
License
MIT
Stars on the repo
★ 26,349
Checked
Source
alirezarezvani/claude-skills ↗
Creator
alirezarezvani · 363 listings
View creator

Similar skills

See all →
Competitor Ad AnalyzerScrapeCreators/social-media-research-skills · by ScrapeCreatorsUse when the user wants to analyze active ads from Meta/Facebook, Google, or LinkedIn ad libraries; tear down a competitor's messaging; extract hooks, offers, CTAs, video transcripts, landing page claims, and test ideas from public ads.★ 2.6k GitHub starsProduct Listing Visual Creatorfeichanggege/ecommerce-visual-copywriting-skill · by feichanggegeTurn product materials into listing visuals for Taobao, JD, Douyin, Amazon, Shopify and TikTok Shop: main-image and detail-page storyboards, in-image copy, image prompts, plus an evidence and ad-compliance check.★ 985 GitHub starsPricing Page Builderboraoztunc/skills · by Meng ToTell us about your plans and prices, and get back a ready-to-build pricing page: plan layout, what each tier includes, buttons, and answers to common buyer questions.★ 361 GitHub starsArticle Opening Hookssamber/cc-skills · by samberWrites opening hooks and post titles for long-form articles in EN or FR — blog posts, Substack/Medium/dev.to, LinkedIn long-form, newsletters, essays. Trigger whenever the user asks for a hook, opening, lede, intro, first sentence/paragraph, opener, accroche, attaque, phrase d'accroche, or première phrase — including punching up a flat intro or draft opening — or for a post title, titre d'article, or headline. Do NOT trigger for social posts (LinkedIn feed, Twitter/X, TikTok, Bluesky), READMEs, taglines, email subjects, ad copy, landing-page headlines, press releases, SEO meta, or body rewrites. Do NOT use for end-of-article CTAs — use samber/cc-skills@copywriting-cta instead.★ 222 GitHub starsCopy Improvement Specialistcoreyhaines31/marketingskills · by coreyhaines31When the user wants to edit, review, or improve existing marketing copy, or refresh outdated content. Also use when the user mentions 'edit this copy,' 'review my copy,' 'copy feedback,' 'proofread,' 'polish this,' 'make this better,' 'copy sweep,' 'tighten this up,' 'this reads awkwardly,' 'clean up this text,' 'too wordy,' 'sharpen the messaging,' 'refresh this content,' 'update this page,' 'this content is outdated,' or 'content audit.' Use this when the user already has copy and wants it improved or refreshed rather than rewritten from scratch. For writing new copy, see copywriting.★ 51.1k GitHub starsConversion Copy Writercoreyhaines31/marketingskills · by coreyhaines31Tell us about your business and what page you need. Get back a full set of headlines, section copy, and buttons written to make people take action.★ 51.1k GitHub stars

More from alirezarezvani

Experiment Resume Toolalirezarezvani/claude-skills · by alirezarezvaniResume a paused experiment. Checkout the experiment branch, read results history, continue iterating. Use when the user runs /ar:ar-resume or asks to pick up a previously started autoresearch experiment.★ 26.3k GitHub starsExperiment Dashboard Vieweralirezarezvani/claude-skills · by alirezarezvaniShow experiment dashboard with results, active loops, and progress. Use when the user runs /ar:ar-status or asks how an autoresearch experiment is going.★ 26.3k GitHub starsAutonomous Experiment Runneralirezarezvani/claude-skills · by alirezarezvaniStart an autonomous experiment loop with user-selected interval (10min, 1h, daily, weekly, monthly). Uses CronCreate for scheduling. Use when the user runs /ar:loop or asks to run an autoresearch experiment continuously on a schedule.★ 26.3k GitHub starsSingle Experiment Iteratoralirezarezvani/claude-skills · by alirezarezvaniRun a single experiment iteration. Edit the target file, evaluate, keep or discard. Use when the user runs /ar:run or asks for one manual autoresearch iteration.★ 26.3k GitHub starsAutoresearch Experiment Setupalirezarezvani/claude-skills · by alirezarezvaniSet up a new autoresearch experiment interactively. Collects domain, target file, eval command, metric, direction, and evaluator. Use when the user runs /ar:setup or asks to start optimizing a file with the autoresearch loop.★ 26.3k GitHub starsExecutive Boardroom Deliberatoralirezarezvani/claude-skills · by alirezarezvani/cs:boardroom <brief> — 6-phase multi-role deliberation across the C-suite with Phase 2 isolation, critic pre-screen, and synthesis. Outputs a board memo. Use when a decision spans multiple executive domains — e.g. a pricing change touching finance, positioning, and product, or a raise-vs-cut runway call.★ 26.3k GitHub stars