agentleFS
matteotittamatteotitta/genesys-skills/skills/linkedin-profile/SKILL.md

linkedin-profile

Skill53 starsChanged 5 days agoMITView on GitHub

Audits a LinkedIn profile section by section with a scoring table, then rewrites the headline, about, experience and featured sections. Use when asked to review, audit, optimise or rewrite a LinkedIn profile.

5 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

12 rules. 0 are common, 9 are distinctive, and 3 are very specific to this project.

  • 0

    Common

    Most of the 5 edited versions we read keep these.

  • 9

    Distinctive

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    If inputs are missing: Ask for LinkedIn URL and ICP description at minimum.

    line 48
  2. Distinctive:

    Remove irrelevant skills (e.g.

    line 86
  3. Distinctive:

    Keep the top 3 pinned skills directly aligned to the ONE offer (the one thing you want to be hired for).

    line 87
  4. Very specific:

    Never invent client metrics, results, or proof points: Only use data provided or mark as [PLACEHOLDER: need real metric]

    line 108
  5. Distinctive:

    Don't fabricate recommendations or testimonials: If none exist, note the gap and provide the request template

    line 109
  6. Distinctive:

    No invented company descriptions: Use scraped data or ask for clarification

    line 110
  7. Distinctive:

    Mark assumptions clearly: Use "Example:" prefix for illustrative scenarios

    line 111
  8. Distinctive:

    Verify proof points are real: Ask user to confirm before including specific numbers in banner/about

    line 112
  9. Very specific:

    Search for LinkedIn profile scraper: search-actors with query "LinkedIn profile scraper"

    line 129
  10. Very specific:

    Run actor: call-actor with the LinkedIn profile URL as input

    line 131
  11. Distinctive:

    If scraping fails or is unavailable:

    line 136
  12. Distinctive:

    Ask user to copy-paste each profile section manually

    line 137

“Common” is measured: kept by at least 6 in 10 of the 5 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

LinkedIn Profile Optimization

Audit a client's LinkedIn profile and generate optimized copy for every section — headline, about, banner, experience, featured, recommendations. Combines Apify scraping for structured profile data with user-provided screenshots for visual assessment, then applies proven profile optimization frameworks.

Why this matters: LinkedIn's algorithm reads your entire profile as text context to decide content distribution. A misaligned profile suppresses reach regardless of content quality. This skill ensures profile-content alignment before any content program begins.

Source: Nick Broekema (Content Design) — profile optimization methodology.

Claude Code Triggers

Invoke this skill when user says:

  • "Optimize [client name]'s LinkedIn profile"
  • "LinkedIn profile audit for [person]"
  • "Rewrite [person]'s LinkedIn headline/about/bio"
  • "Profile optimization for [client]"
  • "Help [name] improve their LinkedIn profile"
  • "[Client] needs a better LinkedIn presence"

Do NOT invoke when the user wants to write a LinkedIn post, comments, an infographic or a carousel.


Inputs

Required

InputDescriptionSource
LinkedIn profileURL or full name + companyUser provides
ICP descriptionWho is this profile trying to attract?User provides

Optional (improve quality)

InputHow It Helps
TOV guidelinesVoice patterns to match in copy generation
Company contextPositioning, value props, proof points to reference
ICP profileDetailed pain points and buyer language
ScreenshotsVisual assessment of banner and profile picture
Current positioningMessaging anchors and differentiators
Proof pointsSpecific metrics, results, client names for banner/about

If inputs are missing: Ask for LinkedIn URL and ICP description at minimum. Request screenshots for banner/profile pic assessment.


Audit scoring table (8 sections)

This table is the load-bearing decision surface for the audit phase. Every audit fills it in.

SectionMax ScoreKey Criteria
Profile picture/10Color (not b/w), smile, eye contact, zoom, branded background, contrast
Banner/15Branded whitespace, clear category, proof points, ICP resonance
Headline/15Formula fit, ICP clarity, desire/outcome, buyer language
About/20PAIS structure, hook strength, CTA, specificity, proof
Featured/10Links (not posts), CTA quality, friction level (3 max)
Experience/15Current role depth, story, ideal client described, results
Recommendations/10Problem-solution-outcome structure, relevance, recency
Bio-link/5Presence, CTA coverage, number of links
TOTAL/100

Status flags: ✓ Good (>70%) | ⚠ Needs work (40-70%) | ✗ Critical (<40%)


Process

3-phase flow: Profile Data Gathering → Profile Audit (using the 8-section scoring table above) → Optimized Copy Generation. Full step-by-step in the premium reference.


Endorsement Strategy

Skill endorsements signal ICP relevance to LinkedIn's search algorithm and 360brew's semantic map. Include this as a quick-win recommendation in all profile audits.

Approach:

  • Endorse 10–15 relevant contacts proactively. Most reciprocate within 1-2 weeks.
  • Focus on contacts who are ICP-adjacent (peers, past colleagues, complementary service providers).
  • Prioritise skills that match ICP search terms: GTM, B2B SaaS, positioning, go-to-market, product marketing, content strategy, pipeline generation.
  • Remove irrelevant skills (e.g. "Microsoft Excel", "Photoshop") that dilute semantic topic signal.
  • Keep the top 3 pinned skills directly aligned to the ONE offer (the one thing you want to be hired for).

Why it matters: LinkedIn's member embedding system weighs skill endorsements as signals of expertise in specific topic clusters. Endorsements from relevant contacts reinforce your semantic profile faster than self-selected skills alone.


Profile clarity tenets

Voice-locked rules — these stay in body. Source: Nick Broekema / Content Design, March 2026.

  • Headline = one sentence — Who you help + what they get + how fast. Not a laundry list of capabilities.
  • Banner = single static message — Not a carousel of rotating promises. One clear line.
  • About section: mobile readability — Shorter lines, breathing room, dynamics. No big blocks of text on mobile.
  • About section: less is more — Keep ICP language but cut without losing meaning. Wordy = weaker.
  • Profile-recommendation alignment — Does the profile reflect what clients consistently say? If all recs say "fast, high quality," the profile should lead with speed + quality.
  • ICP specificity — Does the profile name the actual ICP role + company stage? Don't be everything to everyone.

Anti-Hallucination Guardrails

  1. Never invent client metrics, results, or proof points. Only use data provided or mark as [PLACEHOLDER: need real metric]
  2. Don't fabricate recommendations or testimonials. If none exist, note the gap and provide the request template
  3. No invented company descriptions. Use scraped data or ask for clarification
  4. Mark assumptions clearly. Use "Example:" prefix for illustrative scenarios
  5. Verify proof points are real. Ask user to confirm before including specific numbers in banner/about

MCP Data Integration

Level: 0 — Context (heavy data gathering)

Pulls fresh

SourceWhat to pullToolWhen
ApifyLinkedIn profile data (headline, about, experience, skills, recommendations)search-actors → fetch-actor-details → call-actorAlways
FirecrawlCompany website (for messaging alignment)firecrawl_scrapeIf no company notes are provided

Apify workflow

  1. Search for LinkedIn profile scraper: search-actors with query "LinkedIn profile scraper"
  2. Get actor details: fetch-actor-details for the selected actor
  3. Run actor: call-actor with the LinkedIn profile URL as input
  4. Get results: get-actor-output for structured profile data

Fallback (no Apify/scraping)

If scraping fails or is unavailable:

  • Ask user to copy-paste each profile section manually
  • Request screenshots for visual elements
  • Proceed with manual data — all frameworks still apply

Quality

Pre-delivery checklist covers audit quality (verbatim evidence, score sums correct), copy quality (formula adherence, PAIS completeness, proof points real), voice quality (matches the person's tone of voice), and the Profile Clarity Tenets restated for review. Worked example + anti-examples in the premium reference.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.