CtrlK
BlogDocsLog inGet started
Tessl Logo

linkedin-profile-optimizer

Optimize LinkedIn profile for searchability, recruiter visibility, and engagement

35

Quality

30%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/linkedin-profile-optimizer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

27%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill reads more like a comprehensive LinkedIn optimization blog post than a focused skill file for Claude. It is excessively verbose, explaining many concepts Claude already knows (photo tips, banner sizes, posting frequency), and packs everything into a single monolithic file. The strongest elements are the concrete examples (headline formulas, about section template, experience format) and the structured output format, but these are buried in excessive advisory content.

Suggestions

Cut the content by at least 60%: remove photo/banner advice, content strategy, posting frequency, and the LinkedIn vs Resume comparison table—these are general knowledge Claude already has. Focus on the headline formula, about section structure, keyword strategy, and output format.

Split detailed reference content (keyword optimization strategies, recruiter visibility settings, content strategy) into separate files and reference them from a concise overview in SKILL.md.

Add an explicit workflow with validation: e.g., Step 1: Gather user's current profile/resume → Step 2: Identify target roles → Step 3: Generate optimized sections → Step 4: Verify character limits (220 for headline, 2600 for about) → Step 5: Present output.

Add a character-count validation step in the workflow to ensure generated headlines stay under 220 characters and about sections under 2,600 characters—this is a concrete constraint that matters for actionability.

DimensionReasoningScore

Conciseness

Extremely verbose at ~400+ lines. Explains things Claude already knows (what a LinkedIn profile photo is, what a background banner is, basic advice like 'friendly expression, slight smile'). The LinkedIn vs Resume table, photo requirements, banner pixel sizes, and content strategy sections are general knowledge that don't need to be in a skill file. Much of this reads like a blog post rather than actionable instructions for Claude.

1 / 3

Actionability

Provides concrete examples of headlines, about sections, and experience entries which are useful templates. However, much of the content is advisory rather than executable (e.g., 'post 3-5x per week', 'get endorsements'). The output format template is a good actionable element, but many sections describe what to do rather than showing Claude exactly how to do it.

2 / 3

Workflow Clarity

The output format section provides a clear sequence of action items and a structured template for delivering results. However, there's no explicit workflow for how to gather information from the user, no validation steps (e.g., checking character limits against the optimized text), and no feedback loop for iterating on the optimization. The process of actually optimizing a profile is implicit rather than explicitly sequenced.

2 / 3

Progressive Disclosure

Monolithic wall of text with no references to external files and no content splitting. All content—from photo tips to keyword strategy to content posting frequency—is inlined in a single massive document. Much of this (e.g., content strategy, recommendation tips, recruiter settings) could be split into separate reference files, with the main skill focusing on the core optimization workflow.

1 / 3

Total

6

/

12

Passed

Description

32%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description identifies a clear domain (LinkedIn profile optimization) but is too brief and lacks the specificity and explicit trigger guidance needed for reliable skill selection. It reads more like a tagline than a functional description, missing concrete actions and a 'Use when...' clause.

Suggestions

Add a 'Use when...' clause with trigger terms like 'LinkedIn', 'profile optimization', 'recruiter', 'job search', 'professional branding', 'LinkedIn headline', 'LinkedIn summary'.

List specific concrete actions such as 'rewrite headlines, craft compelling summaries, optimize keyword placement, improve experience descriptions, recommend skills endorsements'.

Include common user phrasing variations like 'improve my LinkedIn', 'make my profile stand out', 'get noticed by recruiters', or 'LinkedIn SEO'.

DimensionReasoningScore

Specificity

Names the domain (LinkedIn profile) and some actions (optimize for searchability, recruiter visibility, engagement), but doesn't list specific concrete actions like rewriting headlines, crafting summaries, selecting keywords, or restructuring experience sections.

2 / 3

Completeness

Provides a partial 'what' (optimize LinkedIn profile) but completely lacks a 'when' clause or any explicit trigger guidance. Per rubric guidelines, a missing 'Use when...' clause caps completeness at 2, and the 'what' is also not very detailed, warranting a 1.

1 / 3

Trigger Term Quality

Includes relevant keywords like 'LinkedIn profile', 'searchability', 'recruiter visibility', and 'engagement', but misses common user variations like 'LinkedIn', 'resume', 'job search', 'SEO', 'headline', 'summary', or 'professional profile'.

2 / 3

Distinctiveness Conflict Risk

The LinkedIn-specific focus provides some distinctiveness, but 'optimize for searchability and engagement' could overlap with general SEO or social media optimization skills. The lack of explicit triggers increases conflict risk.

2 / 3

Total

7

/

12

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
paramchoudhary/resumeskills
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.