CtrlK
BlogDocsLog inGet started
Tessl Logo

linkedin-skills

Use when someone wants to grow an organic LinkedIn presence — a content strategy for a career change or consulting or thought leadership, a rewritten profile or headline, post drafts and hooks, a posting cadence or newsletter plan, connection notes and outreach, a commenting strategy, repurposing an article or talk into posts, or a read on why their reach dropped. Triggers on "grow my LinkedIn", "fix my headline", "write a LinkedIn post", "what should I post about", "LinkedIn strategy", "connection request", "my reach dropped". Forks context to route to one of five sub-skills, and refuses automation, scraping, pods, and bulk DMs before any drafting starts.

69

Quality

87%

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

The canonical home for this skill is linkedin-skills in alirezarezvani/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

77%Weight 40%Scale 1-5

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

A well-structured orchestrator body with a genuine validation-first workflow, exit-code-driven branching, and lean token usage. The main defects are that none of the referenced bundle files (2 scripts, 2 references, 1 asset) are actually present, and the post-routing step — invoking a lane sub-skill — lacks executable detail.

Suggestions

Ship the referenced bundle files (scripts/linkedin_policy_gate.py, scripts/linkedin_goal_router.py, references/linkedin_platform_canon.md, references/policy_and_account_safety.md, assets/linkedin_operating_agreement.md) or remove/trim the references so no path in the body dangles.

Add one concrete line for Step 2's outcome — the path or invocation pattern for the five lane sub-skills (e.g. where linkedin-profile lives and how to load it) so 'invoke that lane' is executable.

Reconcile the '17 stdlib-only Python scripts' claim with the 2 scripts documented, or move the full script inventory into a referenced file the bundle actually contains.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence: no explaining what LinkedIn is, no library tutorials — just a gate command, router command, exit-code semantics, a lane table, five forcing questions, and hard rules. Not 5: minor trimmable content exists — the editorial framing 'The five lanes cover what actually moves' and a 'Distinct from' section that duplicates the frontmatter's distinct_from field.

4 / 5

Actionability

Concrete copy-paste commands with flags and placeholders ('python3 scripts/linkedin_policy_gate.py --text "<the user's own words>" --output human'), branch-by-exit-code instructions, and a lane-to-ask table. Not 5: after routing, the main action 'invoke that lane' has no path or command for the five sub-skills, '/cs:grill-linkedin' is referenced without saying where it lives, and only 2 of the claimed 17 scripts are shown — so the common cases aren't fully covered by executable guidance.

4 / 5

Workflow Clarity

Clear three-step sequence (gate → route → forcing questions) with an explicit validation checkpoint before any drafting, prescribed error-recovery per branch (exit 4 REFUSE: name the rule and route to the printed substitute; exit 2: ask one question with a recommendation; exit 3: ask what they want), and a hard-rules checklist. Feedback loops and 'A REFUSE outranks any route below' precedence are explicit.

5 / 5

Progressive Disclosure

The in-file structure is good — a lean overview with clearly signaled, one-level-deep references (scripts table, references list with one-line descriptions). But scored against the actual bundle: no scripts/, references/, or assets/ directories exist, so every referenced path (linkedin_policy_gate.py, linkedin_platform_canon.md, linkedin_operating_agreement.md) is dangling and the '17 stdlib scripts' claim is unverifiable. Not 4 because navigation to the referenced material is broken as delivered; not 2 because the SKILL.md itself is well organized and references are not buried or nested.

3 / 5

Total

16

/

20

Passed

Description

96%Weight 40%Scale 1-5

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

A strong description: explicit 'Use when' clause, comprehensive concrete capabilities across all five lanes, natural verbatim trigger phrases, and a stated safety boundary. The only weakness is a handful of platform-agnostic trigger terms that create minor overlap risk with sibling growth skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete deliverables — 'a rewritten profile or headline', 'post drafts and hooks', 'a posting cadence or newsletter plan', 'connection notes and outreach', 'repurposing an article or talk into posts', 'a read on why their reach dropped' — comprehensively covering all five lanes. Not 4 because coverage spans profile, strategy, content, engagement, and analytics with no material gaps.

5 / 5

Completeness

Explicitly answers both questions: 'Use when someone wants to grow an organic LinkedIn presence' states when, and the enumerated deliverables plus 'Forks context to route to one of five sub-skills, and refuses automation, scraping, pods, and bulk DMs before any drafting starts' state what (including boundary behavior). Both are concrete, not implied.

5 / 5

Trigger Term Quality

Triggers are verbatim natural user phrases — 'grow my LinkedIn', 'fix my headline', 'write a LinkedIn post', 'what should I post about', 'my reach dropped' — covering growth, profile, content, engagement, and analytics asks with synonyms ('connection request' alongside 'connection notes'). Not 4: even the informal phrasings users would actually say are present; only trivial variants (e.g. 'personal brand') are absent.

5 / 5

Distinctiveness Conflict Risk

The niche (one person's organic LinkedIn presence) is clear and most triggers carry the 'LinkedIn' brand, but 'fix my headline', 'what should I post about', 'connection request', and 'my reach dropped' are platform-agnostic and could match sibling growth skills (e.g. x-twitter-growth) or the five sub-skills this orchestrator routes to. Not 5 because of that minor overlap risk; not 3 because the platform scope and refusal boundary make wrong-skill triggering unlikely.

4 / 5

Total

19

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 5 missing

Warning

referenced_paths_exist

Referenced path issues: 12 missing

Warning

Total

13

/

16

Passed

Repository
alirezarezvani/claude-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.