| name | linkedin-personal-branding |
| description | Comprehensive LinkedIn personal branding analysis, profile optimization, and visibility improvement skill using Claude for Chrome browser tools. Use when users request LinkedIn profile analysis, personal branding audit, profile optimization recommendations, LinkedIn visibility improvement, headline optimization, About section review, content strategy guidance, engagement analysis, or Social Selling Index improvement. Works with Claude for Chrome to analyze profile photos, banners, headlines, About sections, experience, skills, recommendations, featured content, activity/posts, and network engagement directly from the user's browser. |
LinkedIn Personal Branding Skill
โ ๏ธ CRITICAL: Mandatory Requirements
Every audit MUST include these elements - no exceptions:
| Requirement | What | Why |
|---|
| Industry Classification | Identify user's industry/sector | Determines which benchmarks to apply |
| Profile Type | Employee / Consultant / Freelancer / Entrepreneur / Job Seeker | Affects recommendations (e.g., Services section) |
| Target Audience | Recruiters / Clients / Peers / Investors / Partners | Shapes content and positioning strategy |
| Engagement Rate | CALCULATED: (R+C+S)/Impressionsร100 | Raw numbers alone are meaningless |
| SSI Score | Actual score OR estimation with note | Key performance indicator |
These fields appear in the report header and metrics section. Do not skip them.
Overview
This skill enables comprehensive LinkedIn profile analysis, personal branding assessment, and actionable optimization recommendations using Claude for Chrome browser automation. It helps professionals improve their visibility, engagement, and professional positioning on LinkedIn.
Works for ANY industry: Tech, Finance, Healthcare, Legal, Marketing, HR, Consulting, Creative, Nonprofit, and more. See references/metrics_benchmarks.md for industry-specific benchmarks.
Requirements:
- Claude for Chrome extension installed and connected
- User has LinkedIn profile open in their browser
- User is logged into LinkedIn (for access to private metrics like profile views)
Core Workflow
Step 1: Determine Analysis Type
Identify what type of LinkedIn work is needed:
A. Full Profile Audit
- Comprehensive analysis of all profile elements
- Output: Complete audit report with scores and recommendations
B. Quick Profile Review
- Fast assessment of key profile elements
- Output: Priority action items and quick wins
C. Content Strategy Analysis
- Focus on posts, engagement, and content performance
- Output: Content recommendations and posting strategy
D. Visibility Optimization
- Focus on discoverability and search appearances
- Output: Keyword and SEO optimization recommendations
Step 1b: MANDATORY - Profile Classification
โ ๏ธ REQUIRED: Before any analysis, you MUST identify and document:
| Field | How to Determine | Example Values |
|---|
| Industry/Sector | Job titles, company types, content topics | Tech, Finance, Healthcare, Consulting, etc. |
| Profile Type | Current role structure | Employee, Consultant/Freelancer, Entrepreneur, Job Seeker |
| Target Audience | Who they want to reach | Recruiters, Clients, Peers, Investors, Partners |
| Geographic Focus | Location + language | Local, Regional, Global |
Classification Questions to Answer:
- What industry does this person work in? (Check job titles, skills, content)
- Are they an employee, consultant, freelancer, or entrepreneur?
- Who is their target audience on LinkedIn?
- What is their primary language/market?
This information MUST appear in the audit report header:
**Industry/Sector:** [IDENTIFIED INDUSTRY]
**Profile Type:** [Employee / Consultant / Freelancer / Entrepreneur / Job Seeker]
**Target Audience:** [Recruiters / Clients / Peers / Investors / Partners]
Why This Matters:
- Benchmarks vary significantly by industry (see metrics_benchmarks.md)
- Recommendations differ for employees vs. consultants
- Content strategy depends on target audience
Step 2: Gather Profile Information
Use Claude for Chrome browser tools to access the LinkedIn profile. The user should have LinkedIn open in their browser.
Chrome DevTools MCP Tools for LinkedIn Analysis:
| Tool | MCP Tool Name | Use For |
|---|
| List Pages | mcp__chrome-devtools__list_pages | Get browser tabs, find LinkedIn tab by URL |
| Select Page | mcp__chrome-devtools__select_page | Select LinkedIn tab for operations |
| Snapshot | mcp__chrome-devtools__take_snapshot | Extract accessibility tree with element UIDs |
| Screenshot | mcp__chrome-devtools__take_screenshot | Capture visual elements (photo, banner) |
| Navigate | mcp__chrome-devtools__navigate_page | Navigate to URLs or back/forward |
| Click | mcp__chrome-devtools__click | Click elements using UID from snapshot |
| Wait For | mcp__chrome-devtools__wait_for | Wait for text to appear (lazy content) |
| Hover | mcp__chrome-devtools__hover | Scroll element into view |
Workflow:
- Call
mcp__chrome-devtools__list_pages โ find pageId where URL contains "linkedin.com/in/"
- Call
mcp__chrome-devtools__select_page with the pageId to focus LinkedIn tab
- Call
mcp__chrome-devtools__take_snapshot โ returns accessibility tree with UIDs (e.g., [uid1], [uid2])
- Call
mcp__chrome-devtools__take_screenshot โ analyze profile photo and banner quality
- For lazy-loaded sections:
mcp__chrome-devtools__hover to scroll โ re-snapshot to get new content
Key sections to analyze:
Profile Foundation
- Profile photo (quality, professionalism, approachability)
- Banner/background image (branded, relevant, memorable)
- Headline (value proposition, keywords, impact)
- About section (storytelling, keywords, call-to-action)
- Custom URL (clean, professional)
Professional Story
- Experience section (completeness, achievements, metrics)
- Education (relevance, completeness)
- Skills (relevance, endorsements count, top 3 pinned)
- Certifications (industry relevance, credibility)
- Recommendations (quantity, quality, recency)
Visibility & Engagement
- Featured section (portfolio, links, media)
- Activity/posts (frequency, engagement rates)
- Followers count
- Connections (500+ indicator)
- Publications and articles
Network Signals
- Groups membership
- Newsletter subscriptions
- Interests followed
Step 3: Score Profile Elements
Use the scoring framework from references/scoring_framework.md to evaluate each element.
Scoring Categories (1-10 scale):
| Category | Weight | Key Factors |
|---|
| Visual Identity | 15% | Photo quality, banner relevance, visual consistency |
| Headline | 15% | Value proposition, keywords, memorability |
| About Section | 15% | Story structure, keywords, CTA |
| Experience | 20% | Completeness, achievements, metrics |
| Skills & Endorsements | 10% | Relevance, endorsement count |
| Recommendations | 10% | Quality, diversity, recency |
| Activity & Content | 15% | Posting frequency, engagement rate |
Overall Score Interpretation:
- 90-100: Elite (Top 1% of LinkedIn profiles)
- 80-89: Excellent (Strong personal brand)
- 70-79: Good (Solid foundation, room for improvement)
- 60-69: Average (Missing key optimizations)
- Below 60: Needs Work (Significant improvements required)
Step 4: Analyze Key Metrics
Track and benchmark these metrics (see references/metrics_benchmarks.md):
Visibility Metrics
- Profile views (weekly/monthly trend)
- Search appearances
- Post impressions
Engagement Metrics
- Engagement rate (target: 2-8% for B2B)
- Comments per post
- Share rate
โ ๏ธ MANDATORY: Calculate Actual Engagement Rate
You MUST calculate and report the engagement rate, not just show raw numbers:
Engagement Rate = (Reactions + Comments + Shares) / Impressions ร 100
Example Calculation:
Post data: 1,376 impressions, 15 reactions, 1 comment, 0 shares
Engagement Rate = (15 + 1 + 0) / 1,376 ร 100 = 1.16%
Interpretation: ๐ก Average (1-2%) - needs improvement
Target: 3%+ for good engagement
Always include in the report:
| Metric | Raw Value | Calculated | Benchmark | Status |
|---|
| Engagement Rate | 16 interactions / 1,376 impressions | 1.16% | 3%+ | ๐ก Below target |
Growth Metrics
- Follower growth rate (target: 10%+ monthly)
- Connection acceptance rate (target: 40%+)
โ ๏ธ MANDATORY: Social Selling Index (SSI)
The SSI score is critical for measuring LinkedIn effectiveness. You MUST either:
Option A - User provides SSI:
Ask user to visit linkedin.com/sales/ssi and share their score, then document:
| SSI Component | Score | Target |
|---------------|-------|--------|
| Establish professional brand | X/25 | 20+ |
| Find the right people | X/25 | 15+ |
| Engage with insights | X/25 | 18+ |
| Build relationships | X/25 | 18+ |
| **TOTAL SSI** | **X/100** | **70+** |
Option B - SSI not available:
If user cannot access SSI, document in report:
**SSI Score:** Not available (user should visit linkedin.com/sales/ssi to check)
**Estimated SSI Range:** [X-Y] based on profile completeness and activity
SSI Estimation Guide (when actual score unavailable):
| Profile Characteristics | Estimated SSI |
|---|
| All-Star profile + active posting + engaged network | 70-85 |
| Complete profile + regular posting | 55-70 |
| Basic profile + occasional activity | 40-55 |
| Incomplete profile + minimal activity | Below 40 |
Step 4b: Advanced Analysis Areas
Keyword/SEO Analysis
- Identify target keywords for user's industry/role
- Check keyword presence in: Headline, About, Experience, Skills
- Assess search visibility for target terms
- Recommend keyword additions for discoverability
Profile Completeness Check
Multilingual Profile Analysis (if applicable)
- Primary language alignment with target audience
- Secondary language profile completeness
- Consistency across language versions
- Keyword optimization in both languages
- Recommendation: Keep both versions equally updated
LinkedIn Features Assessment
| Feature | Status | Recommendation |
|---|
| Creator Mode | On/Off | Enable if posting 3+/week |
| Open to Work | On/Off | Enable if job seeking (visible to recruiters only) |
| Providing Services | On/Off | Enable if freelancer/consultant |
| Newsletter | On/Off | Consider if 1000+ followers |
| Custom URL | Set/Default | Always customize |
| Verification Badge | Yes/No | Add if available |
Network Quality Assessment
- Connection diversity (industries, roles, seniority)
- Percentage of 1st-degree connections in target audience
- Key influencers/decision-makers in network
- Group membership relevance
Step 5: Generate Recommendations
Provide actionable recommendations using the priority framework:
Priority Matrix:
- Quick Wins (High impact, Low effort): Do immediately
- Strategic Initiatives (High impact, High effort): Plan carefully
- Nice-to-haves (Low impact, Low effort): Do when possible
- Avoid (Low impact, High effort): Not worth resources
Recommendation Categories:
-
Profile Optimization
- Photo and banner improvements
- Headline rewriting
- About section restructuring
- Skills reorganization
-
Content Strategy
- Posting frequency (target: 3x/week minimum)
- Content pillars definition
- Best posting times
- Content formats (carousels, videos, polls)
-
Engagement Strategy
- Comment engagement tactics
- Network growth approaches
- Recommendation requests
- Group participation
-
Visibility Enhancement
- Keyword optimization
- Featured section curation
- Publication strategy
- Creator mode activation
Step 6: Create Actionable Report
โ ๏ธ MANDATORY: Pre-Report Validation Checklist
Before generating any audit report, verify ALL mandatory fields are completed:
โก Industry/Sector identified and documented
โก Profile Type classified (Employee/Consultant/Freelancer/Entrepreneur/Job Seeker)
โก Target Audience identified (Recruiters/Clients/Peers/Investors/Partners)
โก Engagement Rate CALCULATED (not just raw numbers)
โก SSI Score captured OR noted as unavailable with estimation
โก Industry-specific benchmarks applied (from metrics_benchmarks.md)
If any field is missing, go back and complete it before proceeding.
Generate output using templates from assets/:
Report Sections:
- Executive Summary
- Mandatory Classification (Industry, Profile Type, Target Audience)
- Profile Score Card
- Mandatory Calculated Metrics (Engagement Rate, SSI)
- Element-by-Element Analysis
- Quick Wins (Immediate Actions)
- Strategic Recommendations
- 30-60-90 Day Action Plan
Profile Element Best Practices
Profile Photo
- High-quality headshot (400x400px minimum)
- Professional attire appropriate to industry
- Friendly, approachable expression
- Clean, neutral background
- Face occupies 60-70% of frame
- Good lighting (natural preferred)
Banner Image (1584x396px)
- Branded or industry-relevant imagery
- Include value proposition or tagline
- Showcase expertise or work
- Use brand colors if applicable
- Avoid clutter and small text
Headline (220 characters max)
Formula: Who you are + What problems you solve + Benefits you provide
Bad: "Marketing Manager"
Good: "Marketing Manager | Helping B2B Companies Grow Through Data-Driven Strategies | 45% Revenue Increase Specialist"
Industry-Specific Examples:
| Industry | Example Headline |
|---|
| Tech | "Senior Software Engineer |
| Finance | "Investment Analyst |
| Healthcare | "Nurse Practitioner |
| Legal | "Corporate Attorney |
| HR | "Talent Acquisition Leader |
| Sales | "Enterprise Account Executive |
| Creative | "UX Designer |
| Consulting | "Strategy Consultant |
| Nonprofit | "Development Director |
| Startup | "Founder & CEO @ [Company] |
Include:
- Primary role/expertise
- Target audience
- Key differentiator or result
- Relevant keywords
About Section (2,600 characters max)
Structure (Problem-Solution-Proof-CTA):
- Hook (first 2-3 lines visible before "see more")
- Your story/journey
- What you do and who you help
- Key achievements with metrics
- Skills and expertise
- Call-to-action
Tips:
- Write in first person
- Use short paragraphs
- Include relevant keywords
- Add emojis sparingly for visual breaks
- End with clear CTA
Experience Section
For each role include:
- Quantified achievements (%, $, #)
- Scope of responsibility
- Key projects and outcomes
- Skills demonstrated
- Media attachments if relevant
Skills Section
- List 50+ relevant skills
- Pin top 3 most important skills
- Request endorsements from colleagues
- Align with target job keywords
Featured Section
Curate 3-6 items:
- Portfolio pieces
- Case studies
- Articles/publications
- Media appearances
- Key achievements
- Lead magnets or "work with me" links
Services Section (for Consultants/Freelancers)
If user offers services:
- List 3-5 core service offerings
- Use keyword-rich service names
- Ensure services align with headline positioning
- Link to service page if available
Content Performance Patterns
Analyze the user's posting history to identify:
- Best-performing content types (text, carousel, video, poll)
- Optimal posting times based on their engagement data
- Topic resonance - which subjects get most engagement
- Hook effectiveness - first-line patterns that work
- CTA performance - which calls-to-action drive action
Calculate actual engagement rate:
Engagement Rate = (Total Reactions + Comments + Shares) / Impressions ร 100
Benchmark: 2-5% is good, 5-8% is excellent, 8%+ is exceptional
Reference Files
references/scoring_framework.md
Detailed scoring criteria for each profile element with examples and benchmarks.
When to load: For any profile audit or analysis requiring detailed scoring.
references/metrics_benchmarks.md
Industry benchmarks for LinkedIn metrics including SSI scores, engagement rates, and growth targets.
When to load: When analyzing metrics or setting targets for improvement.
references/content_strategy.md
Content pillars, posting schedules, format recommendations, and engagement tactics.
When to load: When developing content strategy or analyzing posting performance.
Asset Templates
assets/profile_audit_template.md
Complete profile audit report template with scoring cards and recommendations.
assets/quick_review_template.md
Rapid assessment checklist with priority actions.
assets/action_plan_template.md
30-60-90 day improvement roadmap template.
Usage Examples
Example 1: Full Profile Audit
User: "Analyze my LinkedIn profile and give me recommendations"
Steps:
- User has their LinkedIn profile open in Chrome
- Call
mcp__chrome-devtools__list_pages โ find pageId for LinkedIn tab
- Call
mcp__chrome-devtools__select_page with pageId
- Call
mcp__chrome-devtools__take_snapshot โ extract profile structure with UIDs
- Call
mcp__chrome-devtools__take_screenshot โ analyze photo and banner visually
- Load
references/scoring_framework.md for scoring criteria
- Score each profile element (Visual, Headline, About, Experience, Skills, etc.)
- Load
references/metrics_benchmarks.md for industry comparison
- Use
assets/profile_audit_template.md for report format
- Provide prioritized recommendations with quick wins first
Example 2: Headline Optimization
User: "Help me improve my LinkedIn headline"
Steps:
- Call
mcp__chrome-devtools__take_snapshot โ find headline in accessibility tree
- Extract current headline text from snapshot
- Identify target audience and value proposition from profile context
- Apply headline formula from SKILL.md (Who + Problems Solved + Benefits)
- Provide 3-5 optimized alternatives with keywords
- Include industry-specific examples
Example 3: Content Strategy
User: "Help me create a LinkedIn content strategy"
Steps:
- Call
mcp__chrome-devtools__navigate_page (url: linkedin.com/in/[user]/recent-activity/)
- Call
mcp__chrome-devtools__wait_for (text: "reactions") โ wait for posts to load
- Call
mcp__chrome-devtools__take_snapshot โ extract recent posts data
- Analyze posting patterns and engagement metrics
- Load
references/content_strategy.md for strategy framework
- Define content pillars based on expertise
- Create posting schedule with optimal times
- Set engagement targets based on industry benchmarks
Example 4: Quick Profile Check
User: "Take a quick look at my LinkedIn profile"
Steps:
- Call
mcp__chrome-devtools__list_pages โ find LinkedIn tab
- Call
mcp__chrome-devtools__select_page โ focus the tab
- Call
mcp__chrome-devtools__take_snapshot โ quick structure scan
- Check key elements (photo, headline, about, experience) in snapshot
- Use
assets/quick_review_template.md for rapid assessment
- Provide top 5 quick wins with specific actions
Example 5: Deep Analytics Review
User: "Analyze my LinkedIn analytics and engagement metrics"
Steps:
- Call
mcp__chrome-devtools__navigate_page (url: "https://www.linkedin.com/analytics/")
- Call
mcp__chrome-devtools__wait_for (text: "Profile viewers") โ verify dashboard loads
- Call
mcp__chrome-devtools__take_snapshot โ capture analytics overview
- Navigate to SSI:
mcp__chrome-devtools__navigate_page (url: "https://www.linkedin.com/sales/ssi")
- Call
mcp__chrome-devtools__wait_for (text: "Social Selling Index") โ check access
- Call
mcp__chrome-devtools__take_snapshot โ capture SSI scores (or note unavailable)
- Navigate back to Activity to analyze recent posts
- Calculate engagement rate from visible metrics using formula
- Compare against industry benchmarks from
references/metrics_benchmarks.md
- Provide improvement recommendations with specific targets
Chrome DevTools MCP Workflows
Step-by-Step: Extracting Profile Data
Step 1: Get browser tabs
โ mcp__chrome-devtools__list_pages
โ Response includes array of pages with: pageId, url, title
โ Find page where url contains "linkedin.com/in/"
Step 2: Select LinkedIn tab
โ mcp__chrome-devtools__select_page (pageId: [found_id])
โ Page is now the active context for subsequent operations
Step 3: Take accessibility snapshot
โ mcp__chrome-devtools__take_snapshot
โ Returns text representation of page with element UIDs like [uid1], [uid2]
โ UIDs are used for click, hover, and other interactions
Step 4: Take screenshot for visual analysis
โ mcp__chrome-devtools__take_screenshot
โ Returns image of current viewport
โ Analyze profile photo quality, banner design, visual branding
Step 5: Extract specific text (optional)
โ mcp__chrome-devtools__evaluate_script
โ function: "() => document.body.innerText"
โ Returns all visible text on page
Step-by-Step: Navigating Profile Sections
LinkedIn lazy-loads content. To access sections below the fold:
Step 1: Take initial snapshot
โ mcp__chrome-devtools__take_snapshot
โ Identify UID for section you need (e.g., "Skills" heading)
Step 2: Scroll to section
โ mcp__chrome-devtools__hover (uid: "[skills_uid]")
โ OR mcp__chrome-devtools__click (uid: "[show_more_uid]")
โ Element scrolls into view
Step 3: Wait for content to load
โ mcp__chrome-devtools__wait_for (text: "Show all", timeout: 5000)
โ LinkedIn AJAX content finishes loading
Step 4: Re-snapshot for new content
โ mcp__chrome-devtools__take_snapshot
โ Now includes previously hidden elements
Step-by-Step: Analyzing Activity/Posts
Step 1: Navigate to Activity section
โ From profile, find "Activity" or "Posts" link UID in snapshot
โ mcp__chrome-devtools__click (uid: "[activity_uid]")
โ OR mcp__chrome-devtools__navigate_page (url: "linkedin.com/in/[username]/recent-activity/")
Step 2: Wait for posts to load
โ mcp__chrome-devtools__wait_for (text: "reactions", timeout: 5000)
Step 3: Snapshot activity page
โ mcp__chrome-devtools__take_snapshot
โ Extract post content, reaction counts, comment counts
Step 4: Calculate engagement metrics
โ For each visible post: (reactions + comments + reposts) / impressions ร 100
โ Note: Impressions may not be visible to non-authors
Step-by-Step: Accessing LinkedIn Analytics Dashboard
LinkedIn Analytics provides key metrics only visible to the profile owner.
Step 1: Navigate to Analytics
โ mcp__chrome-devtools__navigate_page (url: "https://www.linkedin.com/analytics/")
Step 2: Wait for dashboard to load
โ mcp__chrome-devtools__wait_for (text: "Profile viewers", timeout: 10000)
โ If timeout: User may not have analytics access - ask them to navigate manually
Step 3: Capture analytics snapshot
โ mcp__chrome-devtools__take_snapshot
โ Extract: Profile views (7d, 90d), Post impressions, Search appearances, Follower count
Step 4: Navigate to detailed views (optional)
โ Click "Profile viewers" UID for viewer demographics
โ Click "Post impressions" UID for content performance breakdown
โ Click "Search appearances" UID for keyword visibility
Step-by-Step: Capturing SSI Score
The Social Selling Index is a key LinkedIn metric (mandatory in audits).
Step 1: Navigate to SSI page
โ mcp__chrome-devtools__navigate_page (url: "https://www.linkedin.com/sales/ssi")
Step 2: Check for access
โ mcp__chrome-devtools__wait_for (text: "Social Selling Index", timeout: 5000)
โ If timeout: SSI may require Sales Navigator - document as unavailable
Step 3: Capture SSI data
โ mcp__chrome-devtools__take_snapshot
โ Extract: Overall score (/100), 4 component scores (/25 each)
โ Components: Professional Brand, Find Right People, Engage Insights, Build Relationships
Step 4: Capture rankings (if visible)
โ Industry rank, Network rank (percentile position)
Step-by-Step: Individual Post Analytics
For detailed engagement data on specific posts (author-only view).
Step 1: From Activity page, find target post
โ mcp__chrome-devtools__take_snapshot
โ Locate post by content or date in the snapshot
Step 2: Click to view post details
โ mcp__chrome-devtools__click (uid: "[post_uid]")
โ OR click "View analytics" link UID if visible
Step 3: Wait for analytics overlay
โ mcp__chrome-devtools__wait_for (text: "impressions", timeout: 5000)
Step 4: Capture post-level metrics
โ mcp__chrome-devtools__take_snapshot
โ Extract: Impressions, Unique views, Reactions (by type), Comments, Reposts
โ Extract: Top companies, Top job titles (viewer demographics)
Step-by-Step: Follower Analytics
For audience understanding and growth tracking.
Step 1: Navigate to Follower Analytics
โ mcp__chrome-devtools__navigate_page (url: "https://www.linkedin.com/analytics/profile-viewers/followers/")
โ OR from Analytics dashboard, click "Followers" tab UID
Step 2: Wait for data to load
โ mcp__chrome-devtools__wait_for (text: "followers", timeout: 5000)
Step 3: Capture follower data
โ mcp__chrome-devtools__take_snapshot
โ Extract: Total followers, Growth (7d, 30d), Top companies, Top job titles, Top locations
Step 4: Scroll for historical data (if needed)
โ mcp__chrome-devtools__hover (uid: "[chart_uid]") to scroll down
โ Re-snapshot to capture growth chart data
Playwright MCP Fallback
If Chrome DevTools MCP is unavailable, use Playwright MCP:
| Chrome DevTools | Playwright Equivalent |
|---|
mcp__chrome-devtools__list_pages | mcp__playwright__browser_tabs action: "list" |
mcp__chrome-devtools__select_page | mcp__playwright__browser_tabs action: "select" |
mcp__chrome-devtools__take_snapshot | mcp__playwright__browser_snapshot |
mcp__chrome-devtools__take_screenshot | mcp__playwright__browser_take_screenshot |
mcp__chrome-devtools__navigate_page | mcp__playwright__browser_navigate |
mcp__chrome-devtools__click | mcp__playwright__browser_click |
mcp__chrome-devtools__hover | mcp__playwright__browser_hover |
mcp__chrome-devtools__wait_for | mcp__playwright__browser_wait_for |
Error Handling Patterns
| Error | Detection | Recovery |
|---|
| LinkedIn tab not found | list_pages returns no matching URL | Ask user: "Please open your LinkedIn profile in Chrome" |
| Element UID not in snapshot | Click/hover fails with invalid UID | Re-take snapshot, search for alternative element |
| Content not loading | wait_for times out | Scroll manually, increase timeout, try page refresh |
| Rate limited by LinkedIn | Page shows CAPTCHA or error | Pause 30+ seconds, inform user, proceed slowly |
| SSI page requires Sales Navigator | linkedin.com/sales/ssi shows paywall | Note as "SSI unavailable" and provide estimation based on profile |
| Profile is private | Snapshot shows limited content | Document as "Limited visibility - private profile" |
| Analytics page access denied | Page shows "upgrade" or paywall | Note limited metrics access, use visible profile data only |
| Post analytics not available | No "View analytics" option on post | User is not post author - can only see public engagement counts |
| Follower data unavailable | Analytics follower tab empty or restricted | Use visible follower count from profile, note demographics unavailable |
Tips for Effective Analysis
- Use Chrome DevTools MCP: Ensure the user has LinkedIn open in Chrome before starting analysis
- List Pages First: Always call
mcp__chrome-devtools__list_pages to verify LinkedIn tab exists
- Snapshot Before Actions: Always
take_snapshot before clicking or hovering - you need UIDs
- Visual + Text Analysis: Combine
take_screenshot for visual analysis with take_snapshot for text
- Handle Lazy Loading: LinkedIn loads content on scroll - use
hover to scroll, then re-snapshot
- Consider Industry Context: Benchmarks vary by industry and role - always classify first
- Focus on Quick Wins: Prioritize high-impact, low-effort improvements first
- Be Specific: Provide concrete examples and rewrites, not just general advice
- Set Measurable Goals: Include specific targets for metrics improvement
- Handle Private Metrics: Some metrics (profile views, SSI) are only visible to profile owner
- Respect Rate Limits: Avoid rapid navigation that might trigger LinkedIn's bot detection
- Use Playwright Fallback: If Chrome DevTools MCP fails, fall back to
mcp__playwright__* tools
Industry-Specific Guidance
This skill works for ANY professional profile. Always identify the user's industry context first to apply relevant benchmarks.
Step 1: Identify Industry Context
Ask or infer from the profile:
- What industry/sector?
- B2B, B2C, or internal-facing?
- Employee, consultant/freelancer, or entrepreneur?
- Target audience (recruiters, clients, peers, investors)?
Step 2: Apply Relevant Benchmarks
The references/metrics_benchmarks.md file contains benchmarks for 15+ industries:
| Category | Industries Covered |
|---|
| Technology | Software, Web3/Blockchain, Data Science |
| Business | Finance, Consulting, Sales, Marketing |
| Professional | Legal, Healthcare, HR, Education |
| Creative | Design, Creative, Media |
| Other | Manufacturing, Nonprofit, Real Estate, Startups |
Step 3: Adjust Recommendations
Different industries have different norms:
| Factor | Conservative Industries | Progressive Industries |
|---|
| Tone | Formal, reserved | Casual, personable |
| Photo | Traditional headshot | Can be more creative |
| Content | Thought leadership, insights | Stories, behind-the-scenes |
| Posting | 2-3x/week | 4-5x/week |
| Emojis | Minimal | Acceptable |
| Examples | Legal, Finance, Healthcare | Tech, Marketing, Startups |
Industry Detection Cues
Look for these signals in the profile:
- Job titles and company types
- Skills listed
- Content topics
- Industry groups
- Certifications
- Education background
Competitor Analysis Workflow
When conducting competitive analysis for positioning:
Step 1: Identify Aspirational Profiles
Ask user to provide 3-5 LinkedIn profiles of:
- Direct competitors
- Industry leaders they admire
- People in similar roles with strong presence
Step 2: Analyze Each Profile
For each competitor, capture:
- Headline structure and keywords
- About section hook and CTA
- Content frequency and formats
- Engagement levels (reactions, comments)
- Follower count and growth
Step 3: Gap Analysis
Create comparison table showing:
- Where user is stronger
- Where competitors excel
- Specific elements to replicate/adapt
Step 4: Differentiation Strategy
Recommend how user can:
- Match competitor strengths
- Differentiate with unique positioning
- Capitalize on untapped opportunities
Visual Analysis Criteria
When analyzing profile photos and banners:
Profile Photo Scoring (0-10)
| Score | Criteria |
|---|
| 9-10 | Professional headshot, perfect lighting, confident expression, clean background, face fills 60-70% of frame |
| 7-8 | Good quality, professional appearance, minor improvements possible |
| 5-6 | Acceptable but dated, lighting issues, or unprofessional background |
| 3-4 | Low quality, inappropriate setting, or face not clearly visible |
| 1-2 | No photo, logo instead of face, or severely inappropriate |
Red Flags:
- Cropped from group photos
- Sunglasses or obscured face
- Outdated (>5 years old)
- Poor lighting/resolution
- Distracting background
Banner Image Scoring (0-10)
| Score | Criteria |
|---|
| 9-10 | Custom branded banner with value proposition, professional design, proper dimensions (1584ร396) |
| 7-8 | Custom image, relevant to role/industry, minor optimization possible |
| 5-6 | Generic image, somewhat relevant but no branding or messaging |
| 3-4 | Default LinkedIn background or low-quality image |
| 1-2 | Distracting, inappropriate, or broken/stretched image |
Effective Banner Elements:
- Clear value proposition text
- Brand colors if applicable
- Relevant imagery (industry, role, achievements)
- Contact info or CTA (optional)
- Professional design quality
Handling Multilingual Profiles
When user has profiles in multiple languages:
Analysis Approach
- Identify primary language (where most connections are)
- Analyze both versions for completeness
- Check consistency across languages
- Ensure keywords optimized for each language market
Recommendations Format
Provide recommendations for:
- Primary language profile: Full optimization
- Secondary language profile: Key gaps to address
- Content strategy: Which language to post in (consider audience split)
Common Multilingual Issues
- Secondary profile is outdated
- Keywords not localized
- About section only translated, not adapted
- Different positioning across languages (confusing)
