CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

uv-package-manager

Master the uv package manager for fast Python dependency management, virtual environments, and modern Python project workflows. Use when setting up Python projects, managing dependencies, or optimizing Python development workflows with uv.

60

Quality

75%

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 ./plugins/python-development/skills/uv-package-manager/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

68%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 strong, highly actionable command reference for uv with excellent executable examples and a genuine, correctly-scoped progressive-disclosure split to one reference file. Its weaknesses are a padded introductory 'Core Concepts' section of marketing/known material and the absence of validation checkpoints or sequencing across the workflow patterns.

Suggestions

Cut the 'Core Concepts' section (the what-is-uv bullets, key-features list, and 'UV vs Traditional Tools' comparisons) — these are marketing claims and concepts Claude already knows, and they duplicate the description.

Remove the standard venv activation commands (source .venv/bin/activate, Windows variants) and the duplicated 'uv add --upgrade requests' entry in Pattern 6, keeping only the 'uv run' alternative.

Add explicit validation checkpoints after state-changing steps, e.g. 'uv lock --check' after locking, 'uv tree --outdated' after upgrades, and running tests via 'uv run pytest' after syncing, so workflows have feedback loops in the body rather than only in the reference.

DimensionReasoningScore

Conciseness

The bulk of the body is efficient, commented command patterns, but the 'Core Concepts' and 'UV vs Traditional Tools' sections pad with marketing claims ('Blazing fast installation speeds', '10-100x faster') and concept explanations Claude does not need, standard venv activation commands are over-explained, and 'uv add --upgrade requests' appears twice in Pattern 6. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the padded level 2, since the fluff is confined to a minority of sections.

3 / 5

Actionability

Every section is copy-paste-ready executable bash or a complete pyproject.toml example, covering the common cases (init, add/remove/upgrade, lock, venv, python install/pin, sync, migration from requirements.txt). Fully matches the anchor for executable, specific examples covering common cases; not below because there is no pseudocode or vague direction anywhere.

5 / 5

Workflow Clarity

A rough sequence exists (Installation with a 'uv --version' verify step, then Quick Start init -> add), but the task patterns are presented as an unsequenced catalog: there are no validation checkpoints after lock/upgrade operations (e.g. 'uv lock --check') and no error-recovery guidance in the body (troubleshooting is deferred to the reference). This matches 'steps listed but validation gaps; checkpoints missing or implicit'; it does not reach 4 because most checkpoints are absent rather than minor-gapped.

3 / 5

Progressive Disclosure

The bundle structure is real and appropriate: core patterns inline, a single one-level-deep reference (references/advanced-patterns.md) that exists and covers every topic the body claims. It falls short of the anchor-5 'well-signaled, easy navigation' because the pointer is one catch-all sentence at the very end rather than labeled per-topic references at the related sections, and ten distinct topic areas are funneled into a single 470-line file.

4 / 5

Total

15

/

20

Passed

Description

70%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 solid description with an explicit 'Use when...' trigger clause and natural trigger terms anchored to uv. Its main weakness is a generic 'what' built from abstract noun phrases instead of concrete capabilities, which also leaves broad triggers that slightly overlap general Python-tooling skills.

Suggestions

Replace the abstract capability nouns with concrete actions, e.g. 'Install and manage Python dependencies, create virtual environments, manage Python versions, and generate lockfiles with uv'.

Add the most common trigger terms users actually say — 'faster than pip', 'pip replacement', 'migrating from poetry', 'Python package installation' — to the 'Use when' clause to reach comprehensive coverage and sharpen distinctiveness.

DimensionReasoningScore

Specificity

The description names the domain (uv, Python) and three capability areas, but they are abstract noun phrases ('fast Python dependency management, virtual environments, and modern Python project workflows') with no concrete actions — 'Master the uv package manager' is generic. This matches 'names domain and 1-2 concrete actions, but not comprehensive' rather than the level-4 anchor, which requires several specific actions like 'installs packages, creates virtual environments, manages Python versions'.

3 / 5

Completeness

Both parts are explicitly present: a 'what' ('Master the uv package manager for...dependency management, virtual environments...') and a 'when' ('Use when setting up Python projects, managing dependencies, or optimizing Python development workflows with uv'). It falls short of level 5 because the 'what' is generic ('Master...') and the when-triggers omit frequent scenarios like migrating from pip/poetry or lockfiles.

4 / 5

Trigger Term Quality

Natural trigger phrases are present ('setting up Python projects', 'managing dependencies', 'virtual environments', 'uv'), giving good keyword coverage; common user terms like 'pip', 'poetry', 'faster than pip', and 'installing packages' are missing, so it does not reach the comprehensive-synonyms level 5.

4 / 5

Distinctiveness Conflict Risk

The uv/package-manager niche is clear and 'with uv' anchors the when-clause, but broad triggers like 'setting up Python projects' and 'managing dependencies' could also fire a generic pip/poetry/venv skill, giving minor overlap risk with closely related skills rather than the minimal-risk level 5.

4 / 5

Total

15

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

wshobson/agents

Path

plugins/python-development/skills/uv-package-manager/SKILL.md

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.