Agent skill

Linkedin Optimizer

by aipoch in aipoch/medical-research-skills

A skill your agent uses when optimizing LinkedIn profiles for doctors, physicians, nurses, healthcare professionals, or medical researchers.

MITAuto-check passedResearch & Science

Install Linkedin Optimizer

skills CLI
$ npx skills add aipoch/medical-research-skills --skill linkedin-optimizer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aipoch/medical-research-skills linkedin-optimizer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aipoch/medical-research-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/'scientific-skills/Academic Writing/linkedin-optimizer' .claude/skills/linkedin-optimizer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
linkedin-optimizer
GitHub stars
2k
Token cost
~2.7k tokens
SKILL.md length
989 words
Files
4 (incl. scripts, references)
Skills in repo
567
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when optimizing LinkedIn profiles for doctors, physicians, nurses, healthcare professionals, or medical researchers.

  • Works in 4 steps: Headline Optimization → About Section Writing → Keyword Integration → …
  • Optimizing LinkedIn profiles for doctors
  • SKILL.md covers When to Use, Key Features, Dependencies and Example Usage, plus 14 more sections
  • Runs Python scripts from its folder; calls python

What it does

Linkedin Optimizer is an agent skill from aipoch/medical-research-skills. Use when optimizing LinkedIn profiles for doctors, physicians, nurses, healthcare professionals, or medical researchers. Crafts compelling headlines, writes professional summaries, integrates healthcare keywords, and builds personal branding for medical careers.

Its SKILL.md is about 2.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts and reference files (for example `linkedin-optimizer_audit_result_v2.json`, `references/guidelines.md` and `scripts/main.py`).

It sits in Research & Science, covering Resume and CV writing. It works with LinkedIn. The repository describes itself as: Hundreds of agent skills for medical research, including protocol design, data analysis, evidence insights, and academic writing. The licence is MIT.

When your agent uses it

  • Optimizing LinkedIn profiles for doctors
  • Healthcare professionals
  • Medical researchers

Example prompts

  • “/linkedin-optimizer”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Headline Optimization
  2. About Section Writing
  3. Keyword Integration
  4. Experience Section Optimization

What it can do on your machine

Read from SKILL.md and the folder at commit 686e09d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Linkedin Optimizer loads about 2.7k tokens when it runs, and up to ~2.7k if it reads all its reference files. Until then it costs about 70 tokens; SKILL.md has 989 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~70
When it runs · the whole SKILL.md, loaded when a task matches
~2.7k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from aipoch/medical-research-skills at commit 686e09d, republished under its MIT licence (© aipoch). 989 words, ~2,687 tokens.

Download SKILL.mdSave it as .claude/skills/linkedin-optimizer/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
linkedin-optimizer
description
Use when optimizing LinkedIn profiles for doctors, physicians, nurses, healthcare professionals, or medical researchers. Crafts compelling headlines, writes professional summaries, integrates healthcare keywords, and builds personal branding for medical careers.
license
MIT
author
AIPOCH

Source: https://github.com/aipoch/medical-research-skills

LinkedIn Optimizer for Healthcare Professionals

Optimize LinkedIn profiles for doctors, physicians, nurses, and healthcare professionals to enhance professional visibility and career opportunities.

When to Use

  • Use this skill when the task needs Use when optimizing LinkedIn profiles for doctors, physicians, nurses, healthcare professionals, or medical researchers. Crafts compelling headlines, writes professional summaries, integrates healthcare keywords, and builds personal branding for medical careers.
  • Use this skill for other tasks that require explicit assumptions, bounded scope, and a reproducible output format.
  • Use this skill when the response must stay inside the documented task boundary instead of expanding into adjacent work.

Key Features

  • Scope-focused workflow aligned to: Use when optimizing LinkedIn profiles for doctors, physicians, nurses, healthcare professionals, or medical researchers. Crafts compelling headlines, writes professional summaries, integrates healthcare keywords, and builds personal branding for medical careers.
  • Packaged executable path(s): scripts/main.py.
  • Reference material available in references/ for task-specific guidance.
  • Structured execution path designed to keep outputs consistent and reviewable.

Dependencies

  • Python: 3.10+. Repository baseline for current packaged skills.
  • Third-party packages: not explicitly version-pinned in this skill package. Add pinned versions if this skill needs stricter environment control.

Example Usage

bash
cd "20260318/scientific-skills/Academic Writing/linkedin-optimizer"
python -m py_compile scripts/main.py
python scripts/main.py --help

Example run plan:

  1. Confirm the user input, output path, and any required config values.
  2. Edit the in-file CONFIG block or documented parameters if the script uses fixed settings.
  3. Run python scripts/main.py with the validated inputs.
  4. Review the generated output and return the final artifact with any assumptions called out.

Implementation Details

See ## Workflow above for related details.

  • Execution model: validate the request, choose the packaged workflow, and produce a bounded deliverable.
  • Input controls: confirm the source files, scope limits, output format, and acceptance criteria before running any script.
  • Primary implementation surface: scripts/main.py.
  • Reference guidance: references/ contains supporting rules, prompts, or checklists.
  • Parameters to clarify first: input path, output path, scope filters, thresholds, and any domain-specific constraints.
  • Output discipline: keep results reproducible, identify assumptions explicitly, and avoid undocumented side effects.

Quick Check

Use this command to verify that the packaged script entry point can be parsed before deeper execution.

bash
python -m py_compile scripts/main.py

Audit-Ready Commands

Use these concrete commands for validation. They are intentionally self-contained and avoid placeholder paths.

bash
python -m py_compile scripts/main.py
python scripts/main.py

Workflow

  1. Confirm the user objective, required inputs, and non-negotiable constraints before doing detailed work.
  2. Validate that the request matches the documented scope and stop early if the task would require unsupported assumptions.
  3. Use the packaged script path or the documented reasoning path with only the inputs that are actually available.
  4. Return a structured result that separates assumptions, deliverables, risks, and unresolved items.
  5. If execution fails or inputs are incomplete, switch to the fallback path and state exactly what blocked full completion.

Quick Start

python
from scripts.linkedin_optimizer import LinkedInOptimizer

optimizer = LinkedInOptimizer()

# Generate optimized profile content
profile = optimizer.optimize(
    role="Cardiologist",
    specialty="Interventional Cardiology",
    achievements=["Published 15+ peer-reviewed papers", "Led clinical trial for novel stent"],
    years_experience=12
)

print(profile.headline)
print(profile.about_section)

Core Capabilities

1. Headline Optimization
python
optimizer = LinkedInOptimizer()
headline = optimizer.generate_headline(
    title="Board-Certified Cardiologist",
    specialty="Heart Failure & Transplant",
    differentiator="Clinical Researcher"
)

# Output: "Board-Certified Cardiologist | Heart Failure & Transplant Specialist | Clinical Researcher"

Headline Formulas:

  • Title | Specialty | Differentiator
  • Role | Key Skill | Mission
  • Credentials | Focus Area | Value Proposition
2. About Section Writing
python
about = optimizer.write_about_section(
    role="Oncologist",
    approach="Patient-centered care with precision medicine",
    expertise=["Immunotherapy", "Clinical trials", "Palliative care"],
    achievements=["Treated 1000+ patients", "Principal investigator on 5 trials"]
)

About Section Structure:

  1. Opening Hook (2-3 sentences) - Who you help and how
  2. Expertise Areas (bullet points) - Key skills and specialties
  3. Key Achievements (bullet points) - Quantified accomplishments
  4. Call to Action - How to connect

Example:

I'm a board-certified oncologist dedicated to advancing cancer treatment through precision medicine and immunotherapy. With over 10 years of experience, I specialize in developing personalized treatment plans that improve patient outcomes while maintaining quality of life.

Areas of Expertise:

  • Immunotherapy and targeted therapy
  • Clinical trial design and implementation
  • Palliative care integration
  • Multi-disciplinary team leadership

Key Achievements:

  • Treated 1000+ cancer patients with 85% positive outcomes
  • Principal investigator on 5 Phase II/III clinical trials
  • Published 20+ peer-reviewed papers on novel treatment protocols

Let's Connect: Open to collaborations on clinical research and discussing innovative treatment approaches.

Show full SKILL.md (392 more words)Show less
3. Keyword Integration
python
keywords = optimizer.suggest_keywords(
    specialty="Emergency Medicine",
    role="ER Physician",
    target_audience=["Recruiters", "Hospital administrators", "Medical device companies"]
)

High-Value Keywords by Specialty:

SpecialtyPrimary KeywordsSecondary Keywords
CardiologyCardiologist, Interventional Cardiology, Heart FailureClinical Cardiology, Cardiac Catheterization
OncologyOncologist, Medical Oncology, Cancer TreatmentImmunotherapy, Precision Medicine
SurgerySurgeon, General Surgery, Minimally InvasiveRobotic Surgery, Laparoscopic
PediatricsPediatrician, Child Health, Developmental MedicineNeonatology, Pediatric Emergency
ResearchClinical Research, Principal Investigator, FDA TrialsDrug Development, Protocol Design
4. Experience Section Optimization
python
experiences = optimizer.optimize_experiences([
    {
        "title": "Attending Physician",
        "organization": "Mayo Clinic",
        "duration": "2019-Present",
        "achievements": ["Reduced readmission rates by 25%", "Implemented new protocol"]
    }
])

Experience Formula:

  • Action verb + What you did + Result/Impact
  • Example: "Implemented early discharge protocol reducing average length of stay by 2.3 days and saving $500K annually"

CLI Usage

text

# Optimize complete profile
python scripts/linkedin_optimizer.py \
  --role "Neurologist" \
  --specialty "Movement Disorders" \
  --achievements "Published 10 papers, Led Parkinson's clinic" \
  --output profile.json

# Generate only headline
python scripts/linkedin_optimizer.py \
  --mode headline \
  --title "Emergency Medicine Physician" \
  --specialty "Trauma & Critical Care"

Common Patterns

See references/linkedin-examples.md for detailed examples:

  • Academic Physician Profile
  • Private Practice Doctor
  • Medical Researcher
  • Healthcare Executive
  • Resident/Fellow Profile

Quality Checklist

Before Optimization:

  • Define target audience (recruiters, patients, collaborators)
  • List 3-5 key achievements with metrics
  • Identify unique value proposition

After Optimization:

  • Headline under 220 characters
  • About section includes keywords naturally
  • All claims are verifiable
  • Call to action is clear

References

  • references/linkedin-examples.md - Profile examples by specialty
  • references/keywords-by-specialty.json - Keyword database
  • references/headline-templates.md - Headline formulas

Skill ID: 201 | Version: 1.0 | License: MIT

Output Requirements

Every final response should make these items explicit when they are relevant:

  • Objective or requested deliverable
  • Inputs used and assumptions introduced
  • Workflow or decision path
  • Core result, recommendation, or artifact
  • Constraints, risks, caveats, or validation needs
  • Unresolved items and next-step checks

Error Handling

  • If required inputs are missing, state exactly which fields are missing and request only the minimum additional information.
  • If the task goes outside the documented scope, stop instead of guessing or silently widening the assignment.
  • If scripts/main.py fails, report the failure point, summarize what still can be completed safely, and provide a manual fallback.
  • Do not fabricate files, citations, data, search results, or execution outcomes.

Input Validation

This skill accepts requests that match the documented purpose of linkedin-optimizer and include enough context to complete the workflow safely.

Do not continue the workflow when the request is out of scope, missing a critical input, or would require unsupported assumptions. Instead respond:

linkedin-optimizer only handles its documented workflow. Please provide the missing required inputs or switch to a more suitable skill.

Response Template

Use the following fixed structure for non-trivial requests:

  1. Objective
  2. Inputs Received
  3. Assumptions
  4. Workflow
  5. Deliverable
  6. Risks and Limits
  7. Next Checks

If the request is simple, you may compress the structure, but still keep assumptions and limits explicit when they affect correctness.

© aipoch, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts, references) in scientific-skills/Academic Writing/linkedin-optimizer of aipoch/medical-research-skills.

  • SKILL.md
  • linkedin-optimizer_audit_result_v2.json
  • references/guidelines.md
  • scripts/main.py

Open the folder on GitHubat commit 686e09d

Compare with similar skills

Linkedin Optimizer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Linkedin Optimizer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Linkedin Optimizer this skillaipoch/medical-research-skills2k—~2.7kAutomated safety check: PassMIT
Build Tailored ResumeSankaiAI/ats-optimized-resume-agent-skill106—~4.4kAutomated safety check: NotesMIT
Job Description Skillyanliudesign/job-description-skill112—~1.8kAutomated safety check: PassNone
Linkedin Profile Optimizersergebulaev/linkedin-skills4.3k1 repos~1.5kAutomated safety check: PassMIT
Offer Toolkit Skillyanliudesign/offer-toolkit-skill520—~1.2kAutomated safety check: PassMIT
Resume Skillyanliudesign/offer-toolkit-skill520—~1.1kAutomated safety check: PassMIT

Similar skills

  • Build Tailored Resume

    SankaiAI/ats-optimized-resume-agent-skill

    A skill your agent uses whenever the user wants to create a tailored resume for a specific job posting.

    106 GitHub stars~4.4k tokensUpdated 6 mo ago
    Business, Finance & HRAuto-check: notes
  • Job Description Skill

    yanliudesign/job-description-skill

    Job Description 解码器 + Offer 策略系统。把任何 JD 翻译成「这家公司到底在招什么人 / 我的匹配度 / Gap 在哪 / 为什么投/不投 / 面试会问什么 / 下一步怎么走」。只有 3 步:贴 JD → 给简历 → 自动生成并打开一份 HTML Offer Strategy Report。是整个求职链路的入口,向下衔接 Resume Skill 和 BQ…

    112 GitHub stars~1.8k tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed
  • Linkedin Profile Optimizer

    sergebulaev/linkedin-skills

    Audit and rewrite a LinkedIn profile end-to-end for 2026: headline, About 7-step, Featured, banner, photo, Experience metrics, Skills, custom URL, recommendations.

    4.3k GitHub starsUsed in 1 repo~1.5k tokens
    Business, Finance & HRAuto-check passed
  • Offer Toolkit Skill

    yanliudesign/offer-toolkit-skill

    求职工具包。把「找岗位 → 签 offer」拆成六个独立子 skill:⓪ Job Hunt 批量发现岗位,① Job Description 解码具体 JD,② Resume 定向简历,③ BQ 准备行为面试,④ Offer Compare 对比多份 offer,⑤ Salary Negotiation 谈 package。任何求职相关请求(找工作、该不该投、改简历、准备面试、选…

    520 GitHub stars~1.2k tokensUpdated 9 days ago
    Business, Finance & HRAuto-check passed
  • Resume Skill

    yanliudesign/offer-toolkit-skill

    简历生成与美化。两种入口:把已有简历(PDF/Word/文本)解析、诊断、套用模板美化;或者还没有简历时,通过 LinkedIn 导入或一问一答的对话帮你从零建出一份。输出单页打印优化的 HTML(浏览器里 Cmd+P 直接存成 PDF),提供 12 套模板,覆盖 ATS 友好、侧栏、衬线、编辑、时间轴与头像版式。关键词:resume, CV, 简历, 美化简历, 做简历, 简历模板…

    520 GitHub stars~1.1k tokensUpdated 9 days ago
    Business, Finance & HRAuto-check passed
  • Email Search

    extruct-ai/gtm-skills

    Get verified emails and phones for contacts found by people-search.

    109 GitHub stars~1.3k tokensUpdated 10 days ago
    Documents & OfficeAuto-check passed

More from aipoch/medical-research-skills

All 567 skills in this repo
  • Academic Poster Generator

    aipoch/medical-research-skills

    Complete workflow for generating academic research posters from PDF literature; use when you need to extract paper content from PDFs and produce a LaTeX-based poster…

    2k GitHub stars~2.2k tokensUpdated 21 days ago
    Auto-check passed
  • Diagnostic Study Quality Assessment Quadas

    aipoch/medical-research-skills

    Analyzes clinical diagnostic accuracy studies for bias using the QUADAS-2 tool.

    2k GitHub stars~1.4k tokensUpdated 21 days ago
    Auto-check passed
  • Exploratory Data Analysis

    aipoch/medical-research-skills

    Perform comprehensive exploratory data analysis on scientific data files across 200+ file formats.

    2k GitHub stars~3.7k tokensUpdated 21 days ago
    Auto-check passed
  • Iso Certification

    aipoch/medical-research-skills

    A toolkit for preparing ISO 13485:2016 certification documentation for medical device QMS.

    2k GitHub stars~1.8k tokensUpdated 21 days ago
    Auto-check passed
  • Journal Skills

    aipoch/medical-research-skills

    Recommends target journals for manuscript submission by analyzing the paper topic/abstract and the journal distribution of similar PubMed literature; use when users ask for journal…

    2k GitHub stars~1.7k tokensUpdated 21 days ago
    Auto-check passed
  • Latex Posters

    aipoch/medical-research-skills

    Creates academic-poster writing packages for LaTeX using beamerposter, tikzposter, or baposter.

    2k GitHub stars~1.3k tokensUpdated 21 days ago
    Auto-check passed

Works with

Questions about Linkedin Optimizer

What does Linkedin Optimizer do?

A skill your agent uses when optimizing LinkedIn profiles for doctors, physicians, nurses, healthcare professionals, or medical researchers. Linkedin Optimizer is an agent skill from aipoch/medical-research-skills. Use when optimizing LinkedIn profiles for doctors, physicians, nurses, healthcare professionals, or medical researchers.

When should I use Linkedin Optimizer?

Linkedin Optimizer fits situations like: optimizing LinkedIn profiles for doctors; healthcare professionals; medical researchers.

How do I install Linkedin Optimizer in Claude Code?

Run `npx skills add aipoch/medical-research-skills --skill linkedin-optimizer -a claude-code`. Or copy the skill folder (scientific-skills/Academic Writing/linkedin-optimizer in aipoch/medical-research-skills) into .claude/skills/linkedin-optimizer in your project. Claude Code loads it when a task matches its description.

How do I install Linkedin Optimizer in Codex?

Run `npx skills add aipoch/medical-research-skills --skill linkedin-optimizer -a codex`. Or copy the skill folder (scientific-skills/Academic Writing/linkedin-optimizer in aipoch/medical-research-skills) into .agents/skills/linkedin-optimizer in your project. Codex loads it when a task matches its description.

Can I use Linkedin Optimizer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aipoch/medical-research-skills --skill linkedin-optimizer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/linkedin-optimizer, .gemini/skills/linkedin-optimizer, .github/skills/linkedin-optimizer and .opencode/skills/linkedin-optimizer in your project.

What does Linkedin Optimizer need to run?

Going by SKILL.md and its folder, Linkedin Optimizer needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Linkedin Optimizer access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Linkedin Optimizer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Linkedin Optimizer use?

Linkedin Optimizer is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Linkedin Optimizer use?

About 2.7k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 30 tokens, read only when the agent opens those files.

What are the alternatives to Linkedin Optimizer?

Skills that share tags, products or a category with Linkedin Optimizer: Build Tailored Resume (SankaiAI/ats-optimized-resume-agent-skill, 106 stars), Job Description Skill (yanliudesign/job-description-skill, 112 stars), Linkedin Profile Optimizer (sergebulaev/linkedin-skills, 4.3k stars) and Offer Toolkit Skill (yanliudesign/offer-toolkit-skill, 520 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Linkedin Optimizer?

aipoch (a GitHub organization) maintains it in aipoch/medical-research-skills, which has 1,974 GitHub stars. The repository holds 567 skills in this directory. The repository was last updated on September 17, 2026.

Source: aipoch/medical-research-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.