CtrlK
BlogDocsLog inGet started
Tessl Logo

upskill

Compares tracked job postings against the candidate profile to identify skill gaps and generate a prioritized learning plan with study resources. Triggers on: /upskill, upskill, skill gaps, what should I learn, learning plan

63

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/upskill/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 thorough, actionable multi-mode workflow with strong sequencing and concrete templates. Its main weaknesses are monolithic structure with no progressive file disclosure and some rationale passages that add tokens without proportional clarity.

Suggestions

Split the full report-format template (Step 8) and the aggregate-mode merge/dedupe logic (Step 3) into reference files (e.g. references/report-template.md, references/merge-logic.md) and link to them from SKILL.md to improve progressive disclosure.

Tighten the guardrail rationale in Step 3.3 and Step 2.3 to one-line rules; move the 'why' into a brief note rather than a paragraph to improve conciseness.

Add an explicit verification checkpoint after the learning plan is assembled (e.g. confirm resource URLs were all retrieved from real WebSearch results before writing the report) to strengthen the workflow's validation loop for this batch operation.

DimensionReasoningScore

Conciseness

The body is mostly efficient procedural instruction without concept over-explanation, but several guardrail rationale passages (e.g. the extended 'Never treat a blank as 0' justification and repeated skip-count reasoning) could be tightened.

3 / 5

Actionability

Provides concrete file paths, explicit weighting formulas, copy-paste WebSearch query templates, and a full report markdown template, but the LLM-synthesis steps (Step 4) and 'be generous/be specific' guidance remain partly judgment-based.

4 / 5

Workflow Clarity

Eight clearly sequenced steps with verification checkpoints (print heatmap before the learning plan, report skipped counts, confirm-to-user after save); the batch cap does not force a 3 because verification is present, though no formal validate→fix→retry loop exists.

4 / 5

Progressive Disclosure

Well-organized into clearly headed sections, but the ~247-line skill is monolithic with no reference files; the report template and merge/dedupe logic are inlined where separate references would aid navigation.

3 / 5

Total

14

/

20

Passed

Description

87%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 that clearly states capability and trigger conditions with natural, user-facing phrasing. Minor specificity and synonym coverage keep it just short of perfect on two dimensions.

DimensionReasoningScore

Specificity

Names the domain (job postings, candidate profile) and several concrete actions — 'Compares', 'identify skill gaps', 'generate a prioritized learning plan with study resources' — with only minor coverage gaps, sitting above the midpoint but short of fully comprehensive enumeration.

4 / 5

Completeness

Explicitly answers both 'what' (compare postings to profile, identify gaps, generate a learning plan with resources) and 'when' via a concrete 'Triggers on:' clause with specific trigger phrases.

5 / 5

Trigger Term Quality

Lists natural phrases users would actually say ('skill gaps', 'what should I learn', 'learning plan') alongside the slash command, giving good coverage though a few synonyms (e.g. 'upskilling', 'training plan') are missing.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear career-upskilling niche with distinct triggers ('/upskill', 'skill gaps', 'learning plan') that are unlikely to fire for unrelated skills.

5 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

relative_links

Relative link issues: 2 missing

Warning

Total

14

/

16

Passed

Repository
MadsLorentzen/ai-job-search
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.