# LinkedIn Human Guide

## What This Is For
LinkedIn profile optimization and content creation. It gives the agent a clearer input/output frame for social content: what context to ask for, what decisions to make, and what usable artifact to return.

Use this as a human-readable version of the LinkedIn agent skill. It is meant for marketers, operators, founders, and other non-coders who want the workflow without reading agent-specific implementation instructions.

## When To Use This
- Use this when you need a repeatable process for LinkedIn.
- Use this when the task needs judgment, examples, constraints, or a clear output format rather than a one-off prompt.
- Use this when you want to hand an AI assistant enough context to produce a usable marketing artifact.

## When Not To Use This
- Do not use this when you only need a quick factual answer.
- Do not use this when the work depends on private data you cannot share with the assistant.
- Do not use this as a replacement for legal, compliance, financial, or medical review.

## What You Need Before Starting
- The goal or business outcome you want.
- The audience, customer segment, or market context.
- Any source material the assistant should respect, such as notes, briefs, examples, URLs, or brand guidance.
- Constraints such as tone, length, channel, deadline, region, or approval requirements.
- A clear definition of what a good final answer should look like.

## Step-By-Step Workflow
1. State the job clearly: "Use the LinkedIn guide to help me with..."
2. Add context: audience, goal, offer, channel, source material, and constraints.
3. Ask the assistant to identify missing inputs before producing the final output.
4. Have the assistant follow the skill-specific guidance below.
5. Review the result against the final checklist and ask for revisions where needed.

## Skill-Specific Guidance
- **Profile Audit** — analyze and optimize your LinkedIn profile (photo, headline, About, experience, skills, SSI, engagement rate)
- **Content Creation** — write high-engagement posts, build thought leadership, grow your audience
- **Full Profile Audit** — all elements, complete report with scores
- **Quick Profile Review** — priority action items and quick wins only
- **Visibility Optimization** — keyword/SEO discoverability
- **Content Strategy Analysis** — posting frequency, engagement performance
- User visits `linkedin.com/sales/ssi` to share actual score, OR
- Estimate: All-Star + active + engaged network → 70–85; complete + regular posting → 55–70; basic + occasional → 40–55
- ✅ "Marketing Manager | Helping B2B Companies Grow Through Data-Driven Strategies | 45% Revenue Increase Specialist"
- Classification (Industry, Profile Type, Target Audience)
- Calculated Metrics (Engagement Rate, SSI)
- Quick Wins (high impact, low effort)

## Decision Points And Nuance
The original skill emphasizes: Workspace Context, Operating Contract, Mode 1: Profile Audit, Analysis Types, Accessing LinkedIn via Chrome DevTools, Profile Scoring, Mandatory Metrics, Profile Element Best Practices, Audit Report Structure, Mode 2: Content Creation.

Use these questions to steer the work:
- What is the intended audience or buyer?
- What source material must be preserved?
- What should the assistant optimize for: clarity, persuasion, accuracy, speed, creativity, or conversion?
- What examples represent the desired quality bar?
- What should the assistant avoid?

## Common Mistakes
- Admitting what you don't know
- Rules: one sentence per line, blank lines between paragraphs, numbered lists for tips, 3–5 hashtags at the very end (never inline), one emoji max.
- **Don't share when:** The wound is still fresh, you're seeking sympathy not providing value.
- **Avoid:** "Comment YES if...", "Share this with 3 people", "Follow me for more" — engagement bait destroys trust.
- **Posting schedule:** Tue–Thu 7–8 AM, 12 PM, or 5–6 PM; avoid posting >1x/day
- | **Industry/Sector** | [INDUSTRY] | *Required - determines benchmarks* |
- | **Profile Type** | [Employee / Consultant / Freelancer / Entrepreneur / Job Seeker] | *Required - affects recommendations* |
- | **Target Audience** | [Recruiters / Clients / Peers / Investors / Partners] | *Required - shapes strategy* |

## Copy-And-Paste Prompt
```text
Use the LinkedIn human guide.

My goal:
[Describe the business outcome]

Audience:
[Describe who this is for]

Context and source material:
[Paste notes, examples, links, or existing copy]

Constraints:
[Tone, length, channel, timeline, must-include items, must-avoid items]

Before producing the final output, ask me for any missing information that would materially improve the result.
```

## Final Checklist
- [ ] The output matches the original goal.
- [ ] The audience and context are reflected in the answer.
- [ ] Important constraints and source material were preserved.
- [ ] The assistant made the relevant decisions explicit.
- [ ] The final artifact is ready to use, review, or hand to the next person.

## Source
This guide was generated from the manojbajaj95/claude-gtm-plugin skill entry for `linkedin`.

## Source Skill Notes
These notes preserve the nuance from the original skill. Use them as supporting reference when the workflow above feels too generic.

# LinkedIn

## Workspace Context

Read bootstrap context before asking questions: `strategy/brand.md` for brand, audience, offer, channels, tools, constraints, and metrics; `about/me.md` for personal voice; `content/ideas.md` and `content/calendar.md` for content planning. Use legacy product-marketing context files only as fallback. Save generated drafts to `content/<platform>/drafts/YYYY-MM-DD_short-topic-slug.md`, and route durable learnings back to `strategy/brand.md`, `about/me.md`, or `content/ideas.md`.

## Operating Contract

This skill is self-contained for its frontmatter scope: use its local instructions, references, scripts, and assets as the playbook; ask only for missing task-specific inputs; hand off to adjacent skills instead of expanding scope; and return an actionable artifact, decision, plan, draft, or diagnostic.


Two modes — often used together:

1. **Profile Audit** — analyze and optimize your LinkedIn profile (photo, headline, About, experience, skills, SSI, engagement rate)
2. **Content Creation** — write high-engagement posts, build thought leadership, grow your audience

Check for `strategy/brand.md` and `about/me.md` before starting. If they exist, use them to calibrate voice, audience, and positioning.

---

## Mode 1: Profile Audit

### Analysis Types

- **Full Profile Audit** — all elements, complete report with scores
- **Quick Profile Review** — priority action items and quick wins only
- **Visibility Optimization** — keyword/SEO discoverability
- **Content Strategy Analysis** — posting frequency, engagement performance

### Accessing LinkedIn via Chrome DevTools

Requires LinkedIn profile open in Chrome, user logged in.

| Tool | MCP Name | Use For |
|------|----------|---------|
| List Pages | `mcp__chrome-devtools__list_pages` | Find LinkedIn tab |
| Select Page | `mcp__chrome-devtools__select_page` | Focus tab |
| Snapshot | `mcp__chrome-devtools__take_snapshot` | Accessibility tree with UIDs |
| Screenshot | `mcp__chrome-devtools__take_screenshot` | Photo and banner analysis |
| Navigate | `mcp__chrome-devtools__navigate_page` | Go to URLs |
| Click/Hover | `mcp__chrome-devtools__click` / `hover` | Interact with elements |

**Workflow:** `list_pages` → find `linkedin.com/in/` → `select_page` → `take_snapshot` → `take_screenshot` → hover lazy-loaded sections → re-snapshot.

**Playwright fallback:** If Chrome DevTools unavailable, use `mcp__playwright__browser_*` equivalents.

**Sections to analyze:** photo, banner, headline, About, custom URL, experience, education, skills/endorsements, recommendations, featured section, activity/posts, followers/connections, groups.

**Common errors:**

| Error | Recovery |
|-------|----------|
| LinkedIn tab not found | Ask user to open LinkedIn in Chrome |
| Content not loading | Scroll, increase timeout, refresh |
| Rate limited/CAPTCHA | Pause 30+ seconds, proceed slowly |
| SSI requires Sales Navigator | Note unavailable, provide estimation |

### Profile Scoring

| Category | Weight | Key Factors |
|----------|--------|-------------|
| Visual Identity | 15% | Photo quality, banner, consistency |
| Headline | 15% | Value proposition, keywords, memorability |
| About Section | 15% | Story, keywords, CTA |
| Experience | 20% | Completeness, achievements, metrics |
| Skills & Endorsements | 10% | Relevance, count, endorsements |
| Recommendations | 10% | Quality, diversity, recency |
| Activity & Content | 15% | Posting frequency, engagement rate |

**Score guide:** 90–100 Elite · 80–89 Excellent · 70–79 Good · 60–69 Average · <60 Needs Work

### Mandatory Metrics

**Engagement Rate:**
```
(Reactions + Comments + Shares) / Impressions × 100
```
Target: 3%+. Example: (15+1+0)/1,376×100 = 1.16% → below target.

**SSI Score (target: 70+/100):**