CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

drive-positron

Launch Positron dev server in an isolated, disposable profile and control the Electron workbench. Use to reproduce UI bugs, verify UI changes, inspect the DOM, take screenshots, interact with the workbench, or attach a debugger without first writing an end-to-end test. Do not use to provide a persistent app instance for a person; use the launch-positron command for that. Only runs when a person invokes it explicitly.

Quality

94%

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

96%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 exceptionally well-crafted operational skill: dense, non-obvious, product-specific guidance delivered almost entirely through executable commands, with validation checkpoints woven into the launch/attach/cleanup workflow. The only structural blemish is a small number of dangling or out-of-bundle references.

Suggestions

Fix or inline the CONTRIBUTING.md link — it does not resolve relative to the skill directory in the bundle.

Consider moving the .agents/skills/launch and author-e2e-tests cross-references into a short 'related skills' note so the main workflow does not depend on paths outside the skill bundle.

DimensionReasoningScore

Conciseness

Lean and dense throughout: detail is deferred to the bundle ('Each helper's header comment is the reference… --help prints it'), and every section states non-obvious product facts ('The app runs with umask 077, so files it saves are mode 600'; 'a rebase that bumps one is enough') with no padding explaining concepts Claude already knows. Fits the 5 anchor; 4 would require over-explanation instances worth trimming, and none stand out.

5 / 5

Actionability

Fully executable, copy-paste-ready commands with exact paths, flags, and exit-code semantics (launch.sh with --folder-uri, playwright-cli attach with --cdp, the DRIVE_POSITRON_LOG export, the curl liveness check), plus a 30+ row 'To do X, use Y' dispatch table. Matches the 5 anchor: specific examples cover the common cases.

5 / 5

Workflow Clarity

'Launch, attach, clean up' gives a clear sequence with explicit validation checkpoints: keep pid/cdpPort/runDir/logFile, a pre-stop checklist ('copy any logs you need… read the browser console… confirm every screenshot exists, and run listeners.sh --diff'), 'Run stop.sh in a command of its own', and a Troubleshoot section with recovery loops (window.sh reload clears stuck keys). The destructive cleanup is guarded by verification steps, so no cap applies.

5 / 5

Progressive Disclosure

Good one-level-deep structure: the dispatch table navigates the 47-script bundle, --help supplies per-helper detail, and references/reading-ui-state.md is real and clearly signalled. However [CONTRIBUTING.md](CONTRIBUTING.md) dangles (not present in the bundle) and .agents/skills/launch/SKILL.md and author-e2e-tests point outside the bundle — minor organization gaps that fit anchor 4 rather than 5.

4 / 5

Total

19

/

20

Passed

Description

92%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: concrete action list, explicit positive and negative 'use when' guidance, and clear separation from the neighboring launch-positron command. The only gap is limited synonym coverage of natural trigger phrases.

Suggestions

Add one or two natural synonyms for the trigger phrases, e.g. 'manually test the UI' or 'drive a running Positron build', so users phrasing the need differently still match.

No other changes needed; the negative trigger and explicit invocation constraint ('Only runs when a person invokes it explicitly') are exemplary.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions — 'Launch Positron dev server in an isolated, disposable profile and control the Electron workbench', 'reproduce UI bugs, verify UI changes, inspect the DOM, take screenshots, interact with the workbench, or attach a debugger' — with comprehensive coverage of the domain. Fits the 5 anchor rather than 4 because the action list covers the domain without minor gaps.

5 / 5

Completeness

Explicitly answers both: what ('Launch Positron dev server in an isolated, disposable profile and control the Electron workbench') and when ('Use to reproduce UI bugs, verify UI changes, inspect the DOM, take screenshots, interact with the workbench, or attach a debugger without first writing an end-to-end test'), plus a negative trigger ('Do not use to provide a persistent app instance'). Clearly matches the 5 anchor; 4 would require a less explicit 'when', which is not the case.

5 / 5

Trigger Term Quality

Natural phrases a user would say are present ('reproduce UI bugs', 'verify UI changes', 'take screenshots', 'inspect the DOM', 'attach a debugger'), but there are no synonyms or variations (e.g. 'manually test the UI', 'drive the app'). Anchor 4 ('good keyword coverage; a few natural terms missing') fits better than 5, which requires synonyms and file extensions.

4 / 5

Distinctiveness Conflict Risk

Names the specific product (Positron, Electron workbench) and explicitly disambiguates from the sibling skill ('use the launch-positron command for that'), giving a clear niche with distinct triggers and minimal conflict risk.

5 / 5

Total

19

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

posit-dev/positron

Path

.claude/skills/drive-positron/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.