CtrlK
BlogDocsLog inGet started
Tessl Logo

positron-commands

Running Positron IDE commands: changing the window layout, focusing panes (Console, Variables, Plots, Help, Packages), clearing the console, opening a file or data file in the right editor, discovering interpreters, listing, switching, starting, restarting or interrupting sessions, setting up Python, reading, installing or updating a session's packages, running or debugging a web app (Shiny, Flask, Dash, Streamlit, FastAPI, Gradio, marimo), and reading the Data Connections pane -- connections code cannot see -- including a live connection's tables and columns. Use when the user wants Positron itself to act, or to know what is installed, rather than to run R or Python code. Triggers: "show the variables pane", "open data.csv", "what interpreters are available", "switch to my R session", "my session is stuck", "is pandas installed?", "set up a Python environment", "run my shiny app", "what databases am I connected to", "what tables are in my warehouse", "deploy my app to Connect".

79

Quality

100%

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

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

The body is a model router skill: it front-loads the tool-invocation contract and the non-obvious failure modes (opaque ids, VS Code id trap, disabled/not-found semantics), then cleanly dispatches to ten real, well-signaled, one-level-deep reference files with per-area trigger conditions. Everything written is skill-specific knowledge Claude does not already have; there is no padding and no vague guidance.

DimensionReasoningScore

Conciseness

The 130-line body is a lean router: it teaches only what Claude could not know ("copy it, do not retype it from memory", "Some ids... instead open a dialog or a quick-pick and wait for the user to choose", the disabled/not-found error taxonomy, and that runtime/session ids are "opaque handles... not shown anywhere in the Positron UI"). There is no explanation of concepts Claude already knows and no padded sections, matching the 'lean and efficient; every token earns its place' anchor. The mild restatement of 'don't trust memory for ids' across two paragraphs is justified emphasis — the second paragraph adds a distinct failure mode (dialog/quick-pick) rather than repeating the first.

5 / 5

Actionability

For an instruction-only skill the guidance is fully executable: it names the exact tool ("Invoke commands with the `positronCommand` tool"), gives precise argument rules ("fill `args` positionally", "Omit `args` entirely... do not pass an empty object or array", "Never invent an argument value"), and prescribes exact responses to each error mode ("Report this plainly (e.g. 'there's no Data Explorer editor open right now') rather than retrying or guessing at a workaround"). No vague 'use the appropriate command' hand-waving appears; the anchor-5 'copy-paste ready, specific examples cover the common cases' standard is met in guidance form.

5 / 5

Workflow Clarity

The workflow is unambiguous and sequenced: find the area's reference file ("Find the id here before you run it" / "Load the file covering the area in question"), read the id and arguments there, call `positronCommand`, then handle the two documented failure modes with explicit recovery guidance. Error-recovery feedback is present and specific for both `disabled` (report precondition, don't retry) and `not-found` (report, don't substitute a guessed id). No destructive or batch operations exist, so no validation cap applies, and the failure-handling guidance exceeds the anchor-5 bar for a router skill.

5 / 5

Progressive Disclosure

The body is a pure overview; all command ids, arguments, and return values live in 10 linked reference files, each verified to exist in references/. Every link is one level deep (reference files link only back to SKILL.md or to sibling references — no nested chains), and each section carries an explicit "Read when the user asks about..." trigger plus "Read it **before**..." warnings for the high-risk areas (files, packages, interactive apps, publishing). This is the anchor-5 'clear overview with well-signaled one-level-deep references; easy navigation' case.

5 / 5

Total

20

/

20

Passed

Description

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

An exemplary skill description: a comprehensive, concrete inventory of capabilities, an explicit 'Use when' clause with a sharp boundary against running interpreter code, and ten natural trigger phrases covering every capability area. It is long, but every clause is load-bearing (capability or trigger) with no filler or buzzwords.

DimensionReasoningScore

Specificity

The description enumerates a comprehensive list of concrete actions: "changing the window layout, focusing panes (Console, Variables, Plots, Help, Packages), clearing the console, opening a file or data file in the right editor, discovering interpreters, listing, switching, starting, restarting or interrupting sessions... reading, installing or updating a session's packages, running or debugging a web app (Shiny, Flask, Dash, Streamlit, FastAPI, Gradio, marimo)". This matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage' — nothing is left at the vague 'helps with IDE' level. Not a 4 because the coverage has no minor gaps: every capability area of the skill is named.

5 / 5

Completeness

Both questions are explicitly answered: the 'what' is the full capability list, and the 'when' is stated twice — "Use when the user wants Positron itself to act, or to know what is installed, rather than to run R or Python code" plus concrete "Triggers:" phrases. This matches the anchor-5 example structure (what-list + 'Use when...' + trigger phrases). A 'when' clause is present and highly specific, so the anchor-4 'when could be more explicit' case does not apply.

5 / 5

Trigger Term Quality

Ten quoted natural trigger phrases ("show the variables pane", "open data.csv", "my session is stuck", "is pandas installed?", "run my shiny app", "what tables are in my warehouse") plus framework synonyms (Shiny, Flask, Dash, Streamlit, FastAPI, Gradio, marimo) and a file extension ("data.csv"). These are exactly the phrases a user would naturally say, matching the 'comprehensive coverage including synonyms and file extensions' anchor; nothing reads as pure technical jargon.

5 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche (Positron workbench commands) and explicitly draws its boundary: "rather than to run R or Python code", and the data-connections scope is disambiguated as "connections code cannot see". A user or model looking to run code or analyze data would not trigger this skill, so overlap risk with code-execution or data-analysis skills is minimal — the anchor-5 case.

5 / 5

Total

20

/

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: 10 missing, 10 deeper-than-1-level

Warning

Total

15

/

16

Passed

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.