CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

python-environment

Detect, configure, and use the project's Python environment (uv by default, conda-compatible tool as a fallback). Use before tasks that need the project environment, such as importing project code, running tests, building docs, or invoking repo tooling.

Quality

84%

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

SKILL.md
Quality
Evals
Security

Quality

Content

82%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 highly actionable, well-structured skill body: every command is executable, the decision logic (when the env is needed, reuse-before-create, worktree handling) is explicit, and troubleshooting includes error recovery. It could be tightened slightly (a duplicated command, dated version numbers) and the conda fallback could be split into a reference file.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — it never explains what Python, uv, or conda are, and every section is task-focused. Minor extras keep it from level 5: the run command "$CONDA_EXE run -n CausalPy <command>" is stated twice in consecutive lines, and the time-sensitive line "As of 2026-02-13, current versions are conda 26.1.0, mamba/micromamba 2.5.0" is version information that will drift and is not in an old-patterns section.

4 / 5

Actionability

All guidance is copy-paste ready: exact flags ("uv sync --locked --extra dev --extra docs --extra test --extra lint"), runnable commands ("uv run pytest", "$CONDA_EXE env update --file environment.yml --prune"), a working shell snippet for detecting the conda tool, and concrete error-recovery commands. The common cases (setup, run, update, troubleshoot) are all covered with executable examples.

5 / 5

Workflow Clarity

The sequence is clear and well-gated: a decision step for whether the env is needed, "Reuse before creating" logic with explicit re-sync conditions, a default path and fallback path, and an error-recovery loop in Troubleshooting ("run -n fails → env list → run -p → keep using run -p"). It falls short of level 5 because there is no explicit post-setup verification step (e.g. confirming the env can import the package), so validation is implicit (--locked fail-fast) rather than an explicit checkpoint.

4 / 5

Progressive Disclosure

There are no bundle files; all content is inline in a single 135-line SKILL.md with well-organized, clearly headed sections (decide, uv default, conda fallback, troubleshooting) that are easy to navigate. Minor gap: the ~70-line conda fallback path is only used when uv is unavailable and could live in a one-level-deep reference file, which is the kind of minor organization gap described at level 4 rather than the well-signaled multi-file split of level 5.

4 / 5

Total

17

/

20

Passed

Description

78%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 and explicitly states both what it does and when to use it, with concrete trigger examples and named tools. Its main weakness is that the action verbs (detect, configure, use) are generic rather than concrete outcomes, and a few natural trigger synonyms are missing.

DimensionReasoningScore

Specificity

The description names the domain and three actions ("Detect, configure, and use the project's Python environment") plus tool specifics ("uv by default, conda-compatible tool as a fallback"), but the verbs themselves are generic and it does not enumerate concrete outcomes like running tests or building docs as actions. This matches the anchor 'names domain and 1-2 concrete actions, but not comprehensive' better than level 4, whose examples list several concrete, outcome-level actions.

3 / 5

Completeness

It explicitly answers both: what ("Detect, configure, and use the project's Python environment (uv by default, conda-compatible tool as a fallback)") and when ("Use before tasks that need the project environment, such as importing project code, running tests, building docs, or invoking repo tooling"). The 'when' clause includes four concrete trigger phrases, matching the level-5 anchor.

5 / 5

Trigger Term Quality

Natural terms include "Python environment", "uv", "conda", "running tests", "building docs", and "importing project code" — phrases users would actually say. A few common variations are missing (e.g. "virtualenv", ".venv", "pip"), so it falls just short of the comprehensive-synonym coverage of level 5.

4 / 5

Distinctiveness Conflict Risk

The Python-environment scope with explicit tool names (uv, conda) gives it a clear niche with distinct triggers, but phrases like "running tests" or "building docs" could overlap with general run/build or test-execution skills. This is minor overlap risk with closely related skills, matching level 4 rather than the minimal-conflict level 5.

4 / 5

Total

16

/

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

pymc-labs/CausalPy

Path

.agents/skills/python-environment/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.