CtrlK
BlogDocsLog inGet started
Tessl Logo

positron-pull-vscode-server

Use when pulling changes from rstudio/vscode-server into Positron — fetching upstream, triaging commits, and applying diffs

72

Quality

88%

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

88%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.

An unusually well-executed procedural skill: every step carries project-specific knowledge Claude could not infer, commands are copy-paste ready, and validation with recovery loops is woven through a batch operation. The only refinement opportunities are tightening a few explanatory asides and potentially moving the PR-body formatting conventions to a reference file.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious, repo-specific knowledge (PWB vs Positron marker rules, version/distro baseline parity, backport direction checks, full-qualified reference rules) and explains nothing Claude already knows at length. A few spots could be tightened — e.g., the explanation that 'GitHub-flavored markdown does not render native list syntax inside a table cell' and the long PR-body template in Step 5 — landing it at anchor 4 rather than the lean anchor 5.

4 / 5

Actionability

Fully executable throughout: copy-paste commands (the two bundle scripts with arguments, `git rev-parse upstream/main`, `npm run build-ps/build-check/precommit --`, `gh pr list ... --search "upstream merge from vscode-server in:title"`), a literal commit-message template, and a concrete PR-body markdown template. Specific examples cover the common cases, matching anchor 5.

5 / 5

Workflow Clarity

Steps 1–6 are clearly sequenced with explicit validation checkpoints and feedback loops for a batch operation: stop conditions on baseline divergence (version/distro mismatch, Microsoft-author commits), build-check with recovery ('if watch-client is stopped, run build-start first'), precommit scoped to touched lines, `git status` churn exclusion before committing, and a 'files you ported compile clean' acceptance criterion. This matches anchor 5's explicit validation with error-recovery loops; the destructive/batch cap of 3 does not apply since validation is thorough.

5 / 5

Progressive Disclosure

Both script paths referenced in the body (`scripts/enumerate-upstream.sh`, `scripts/check-backlog.sh`) exist in the bundle and are clearly signaled as executable helpers at the point of use, and the SKILL.md itself serves as the workflow overview. Scored against the actual bundle structure, this is good structure (anchor 4) — though the ~40 lines of PR-body formatting rules and reference conventions in Step 5 are arguably bulk material that could live in a reference file, keeping it short of anchor 5's clean overview-plus-references split.

4 / 5

Total

18

/

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, tight description in third-person gerund voice: concrete actions, explicit 'Use when' trigger, and repo names that make it highly distinguishable. The only minor gap is synonym coverage (e.g., 'port', 'upstream merge') in the trigger phrasing.

DimensionReasoningScore

Specificity

The description names the domain ("pulling changes from rstudio/vscode-server into Positron") and three concrete actions ("fetching upstream, triaging commits, and applying diffs"). This matches anchor 4 — several specific actions with minor coverage gaps (verification, commit bundling, and PR creation are part of the skill but not mentioned). It falls short of anchor 5's comprehensive coverage but clearly exceeds anchor 3's '1-2 concrete actions.'

4 / 5

Completeness

It explicitly answers both questions in one sentence: 'what' via "fetching upstream, triaging commits, and applying diffs" and 'when' via the explicit "Use when pulling changes from rstudio/vscode-server into Positron" clause with a concrete trigger phrase. This matches anchor 5's pattern; anchor 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Natural trigger terms a user would say are present: "pulling changes from rstudio/vscode-server into Positron", "fetching upstream", "triaging commits", "applying diffs", plus the concrete repo names. Anchor 5 requires comprehensive synonym coverage; variations like "port", "backport", or "upstream merge" that users of this workflow would plausibly say are absent, so it sits between anchor 4 and 5 — closer to 4.

4 / 5

Distinctiveness Conflict Risk

Naming both repositories ("rstudio/vscode-server" → "Positron") gives this a clear niche with distinct triggers and minimal conflict risk against other skills. It is far more specific than anchor 4's 'minor overlap risk with closely related skills.'

5 / 5

Total

18

/

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
posit-dev/positron
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.