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

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/upskill/SKILL.md

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-step workflow with concrete formulas, file paths, and templates. Its main weaknesses are redundancy between the Important Rules and the inline steps, and a lack of progressive disclosure into reference files for the longer templates.

Suggestions

Remove or de-duplicate Important Rules 3, 8, and 9, which restate targeted-mode and stored-gaps guidance already specified in Steps 2 and 3 — keep the rules only where they add information not already in the steps.

Move the verbose report-assembly template (Step 8) and the learning-plan example entry (Step 6) into a reference file (e.g. references/report-template.md) and link to it, reducing inline bulk and improving progressive disclosure.

Consolidate the two slugification mentions (Step 1 and Step 8) into a single canonical location to avoid restating the rule.

Dimension	Reasoning	Score
Conciseness	Mostly efficient and purposeful, but the 'Important Rules' section substantially duplicates guidance already embedded in Steps 2–3 (e.g. rules 3, 8, 9 restate targeted-mode and stored-gaps handling), adding padding that could be trimmed.	3 / 5
Actionability	Provides concrete, executable guidance — exact CSV columns, the weighting formula `(100 - fit_rating) / 100`, ready-to-use WebSearch query templates, and copy-paste markdown table/entry formats — with only minor gaps in coverage.	4 / 5
Workflow Clarity	An explicit 8-step sequence with an intermediate checkpoint ('Print this table to the terminal ... before continuing') and clear mode branching; it lacks a validate-fix-retry feedback loop, but the operation is a read/analyze/write pipeline rather than a destructive or batch one, so no cap applies.	4 / 5
Progressive Disclosure	Well-organized into labeled sections, but it is a monolithic 247-line file with all detail inlined and no bundle/reference files to offload the table formats, example entries, or templates that would benefit from being one level deep.	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, third-person description that concretely states what the skill does and gives explicit trigger guidance. Minor specificity gaps (heatmap, study order) keep it just short of perfect on coverage.

Dimension	Reasoning	Score
Specificity	Lists several concrete actions — 'Compares tracked job postings against the candidate profile', 'identify skill gaps', 'generate a prioritized learning plan with study resources' — but omits notable outputs like the gap heatmap and suggested study order, leaving minor coverage gaps.	4 / 5
Completeness	Explicitly answers both 'what' (compares postings to profile, identifies gaps, generates a prioritized learning plan) and 'when' via the explicit 'Triggers on:' clause with concrete trigger phrases.	5 / 5
Trigger Term Quality	Includes natural phrases users would say ('skill gaps', 'what should I learn', 'learning plan') plus the slash command, but is missing some common synonyms and variations that would push it to comprehensive.	4 / 5
Distinctiveness Conflict Risk	Occupies a clear niche (job-search skill-gap analysis with a named command and domain-specific triggers) that is unlikely to fire for unrelated skills.	5 / 5
	Total	18 / 20 Passed

Validation

87%

Warnings & errors only

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

Validation — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
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
Path: .claude/skills/upskill/SKILL.md
Commit: 5c423b4

Reviewed: about 16 hours ago

Table of Contents

Discovery Implementation Validation

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.