CtrlK
BlogDocsLog inGet started
Tessl Logo

linkedin-url-lookup

Resolve LinkedIn profile URLs from name + company with strict identity validation to avoid false positives.

40

Quality

37%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/linkedin-url-lookup/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

35%

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

This skill is essentially a thin routing/delegation document that points to other skills and recipes without providing any substantive content about LinkedIn URL lookup itself. It lacks any concrete, actionable guidance—no code, no examples, no validation steps, and no actual instructions for resolving LinkedIn profiles. While the conciseness and structure are acceptable for a delegation pattern, the near-total absence of actionable content severely limits its utility as a standalone skill.

Suggestions

Add concrete, actionable content about the LinkedIn URL lookup process—at minimum, describe the identity validation criteria and expected inputs/outputs so the skill has standalone value.

Include at least one example showing expected input (name + company) and expected output (validated LinkedIn URL) to make the skill actionable.

Add validation/verification steps for identity matching to prevent false positives, as described in the skill's own description.

If this skill is purely a routing shim, consider whether it needs to exist as a separate SKILL.md at all, or consolidate it into the parent meta-skill's routing logic.

DimensionReasoningScore

Conciseness

Reasonably brief but includes some unnecessary explanation (e.g., 'This is a recipe shortcut' and 'The recipe only covers one part of the task' are somewhat redundant given the instructions). Could be tighter.

2 / 3

Actionability

The skill provides no concrete code, commands, or executable guidance. It is entirely a delegation/routing document that tells Claude to invoke another skill and read another file, with no actual LinkedIn URL lookup instructions or examples.

1 / 3

Workflow Clarity

There is a numbered sequence (invoke meta-skill, follow routing, read recipe), but there are no validation checkpoints, no error handling, and no concrete details about what happens at each step. The workflow is essentially 'go read other files.'

2 / 3

Progressive Disclosure

References a meta-skill and a recipe file with a relative path, which is reasonable structure. However, with no bundle files provided, we cannot verify the referenced paths exist. The skill itself contains almost no substantive content, making it feel like an empty shell rather than a well-structured overview.

2 / 3

Total

7

/

12

Passed

Description

40%

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, distinctive capability (LinkedIn profile URL resolution with identity validation) but lacks explicit trigger guidance ('Use when...') and could benefit from more natural user-facing keywords. It is concise and specific to its niche, but incomplete in guiding Claude on when to select this skill.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user asks to find someone's LinkedIn profile, look up a LinkedIn URL, or locate a person on LinkedIn.'

Include natural trigger term variations users might say, such as 'find LinkedIn', 'LinkedIn link', 'look up on LinkedIn', 'social profile URL'.

DimensionReasoningScore

Specificity

Names the domain (LinkedIn profile URL resolution) and a key action (resolve URLs from name + company with identity validation), but doesn't list multiple concrete actions beyond the single core capability.

2 / 3

Completeness

Describes what the skill does but has no explicit 'Use when...' clause or equivalent trigger guidance, and per the rubric guidelines, a missing 'Use when' clause caps completeness at 2. However, the 'when' is entirely absent—not even implied through trigger phrasing—so it scores a 1.

1 / 3

Trigger Term Quality

Includes relevant terms like 'LinkedIn', 'profile URLs', 'name + company', but misses common user variations like 'find LinkedIn', 'look up someone on LinkedIn', 'LinkedIn link', or 'social profile'.

2 / 3

Distinctiveness Conflict Risk

Very specific niche—resolving LinkedIn profile URLs from name and company with identity validation is a clearly distinct capability unlikely to conflict with other skills.

3 / 3

Total

8

/

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
getaero-io/gtm-eng-skills
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.