Content
82%Weight 40%Scale 1-5Reviews 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.
| Dimension | Reasoning | Score |
|---|---|---|
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 |