CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

rstudio-update-electron

Use when updating the Electron version in the RStudio repository, e.g. bumping to a new release

Quality

86%

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

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 exemplary procedural skill body: fully executable commands, a clearly sequenced workflow with validation and stop conditions at every step, and lean prose that explains only non-obvious domain facts (Electron has no install script, the allowScripts key must be hand-updated). The only minor cost is a version-stamped npm-gating digression in step 4 that could be shortened.

DimensionReasoningScore

Conciseness

The body is lean and imperative with well-justified rationale (e.g. why --save-exact is required, why the lockfile must be committed), but step 4 inlines a time-sensitive research digression ("Verified on 42.10.1 and 42.11.0; re-check with npm view electron@<NEW_VERSION> scripts...") that could be trimmed. It is not 5 because version-specific verification details are not in a deprecated/old-patterns section; it is well above 3 because nearly every other token earns its place.

4 / 5

Actionability

Every step is fully executable with copy-paste-ready commands (git branch --show-current, npm install --save-dev --save-exact electron@<NEW_VERSION>, cat node_modules/electron/dist/version, npx --no-install install-electron, npm test), and the <NEW_VERSION> parameter is explicitly defined up front in the Arguments section.

5 / 5

Workflow Clarity

A clear 7-step sequence with explicit validation checkpoints at each step: verify the starting branch and stop if not main, confirm the npm install exit code, verify the exact pin in package.json and the lockfile, confirm the on-disk binary version before running tests, and stop on test failures with a defined final report. This matches the anchor's feedback loops and stop-on-failure recovery.

5 / 5

Progressive Disclosure

This is a single-purpose procedural skill (~90 lines) whose entire content belongs in SKILL.md: clean numbered sections, no reference nesting, no bundle files, and no content that would be better split into a separate file. It is above anchor 4 because there are no organization gaps — every section is task-essential and easy to navigate.

5 / 5

Total

19

/

20

Passed

Description

73%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 concise, highly distinctive trigger-focused description with natural phrasing ("updating", "bumping to a new release"). Its main weakness is one-sidedness: it is purely a "Use when" clause, so the "what" is embedded rather than stated, and the scope of the update work is left to the skill body.

Suggestions

Add a brief "what" statement before the "Use when" clause, e.g. "Updates the pinned Electron version across the RStudio codebase (manifest, lockfile, allowScripts) and verifies with tests. Use when updating the Electron version or bumping to a new release."

Include additional natural trigger variations such as "upgrade" or "pin the Electron version" to broaden keyword coverage.

Mention the artifacts touched (package.json, package-lock.json, NEWS.md) so the "what" side is concrete and comprehensive rather than implied.

DimensionReasoningScore

Specificity

The description names the domain ("the Electron version in the RStudio repository") and one concrete action ("updating... bumping to a new release"), but lists no further specific actions such as updating the lockfile, allowScripts entry, or running tests. It matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive) — above anchor 2 because the action is concrete rather than generic, below anchor 4 because it does not list several specific actions.

3 / 5

Completeness

The explicit "Use when..." clause answers when to use the skill, and the same clause conveys what the skill does (updating the Electron version in the RStudio repository). It is not 5 because there is no separate statement of what the skill does or what the update entails; it is above 3 because the "when" is explicit and specific rather than weakly implied.

4 / 5

Trigger Term Quality

Natural trigger phrases users would actually say are present: "updating the Electron version" and "bumping to a new release". It falls short of anchor 5 because common variations like "upgrade Electron" or "pin the Electron version" are missing, but coverage goes beyond anchor 3's single keyword by including both "update" and "bump" phrasings.

4 / 5

Distinctiveness Conflict Risk

"Updating the Electron version in the RStudio repository" carves out a clear niche with distinct triggers and virtually no overlap with other skills — nothing else would plausibly trigger on this phrasing.

5 / 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

rstudio/rstudio

Path

.claude/skills/rstudio-update-electron/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.