CtrlK
BlogDocsLog inGet started
Tessl Logo

generate-run-commands

Generate or modify run commands for the current session. Use when the user wants to set up or update run commands that appear in the session's Run button.

73

Quality

90%

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

93%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 lean skill body: complete executable JSON, exact paths, clear decision logic, and a protective merge rule. The only meaningful improvement would be a brief validation step after writing tasks.json.

Suggestions

Add a quick post-write validation, e.g., re-read .vscode/tasks.json to confirm the merge preserved existing tasks and the JSON parses, which would close the workflow's only checkpoint gap.

The HTML comment on line 5 ('Customize this skill and select save...') is editor boilerplate, not instruction; removing it would trim noise from the body.

DimensionReasoningScore

Conciseness

The ~49-line body contains no concept explanations Claude already knows: it opens with two purposeful sentences, a minimal but complete JSON schema example, decision logic, and write/merge instructions. Every section earns its place, matching the lean anchor 5; there is no padded or over-explained passage to push it down to 4.

5 / 5

Actionability

The guidance is fully executable: a copy-paste-ready tasks.json example, exact file paths (.vscode/tasks.json), concrete project files to inspect (package.json, Makefile, pyproject.toml, Cargo.toml, go.mod, .nvmrc), and named commands (npm install, npm run dev) with the exact runOptions key for each. This matches the 5 anchor's 'copy-paste ready, covers the common cases' standard.

5 / 5

Workflow Clarity

The decision logic gives a clear sequence (read existing tasks.json → modify vs. infer → write/merge → confirm to the user), and the merge instruction plus end-of-task confirmation provide partial checkpoints. It falls short of anchor 5 because there is no explicit validation step (e.g., verifying the written JSON is well-formed or re-reading the file to confirm the merge), leaving a minor validation gap.

4 / 5

Progressive Disclosure

The skill is under 50 lines, self-contained, and has no need for external references (references/, scripts/, assets/ directories are absent, and the body references no such files). Per the rubric's simple-skill guideline, well-organized sections (Understanding the task schema / Decision logic / Writing the file) alone earn the 5 anchor here.

5 / 5

Total

19

/

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 tight, well-formed description: it states what and when explicitly, uses natural trigger language, and stakes out a distinct niche. The only minor gap is that just two action verbs (generate, modify) keep it short of the fullest capability coverage.

Suggestions

Consider mentioning the underlying artifact (e.g., '.vscode/tasks.json' or 'tasks.json') to add one more concrete, searchable trigger term.

Optionally note the setup-vs-run distinction (auto-run on worktree creation) if that distinction is user-relevant, which would broaden capability coverage without padding.

DimensionReasoningScore

Specificity

"Generate or modify run commands for the current session" names the domain and two concrete actions, and "run commands that appear in the session's Run button" grounds them in a concrete UI surface. This sits between anchor 3 (1-2 actions, not comprehensive) and anchor 5 (multiple actions, comprehensive) — the two actions fully cover this skill's scope, so it is above the midpoint but short of the multi-action breadth of the 5-anchor examples.

4 / 5

Completeness

The first sentence explicitly states what ("Generate or modify run commands for the current session") and the second explicitly states when with concrete trigger phrasing ("Use when the user wants to set up or update run commands that appear in the session's Run button"). This matches anchor 5 exactly; it is not anchor 4, where the 'when' is present but could be more specific.

5 / 5

Trigger Term Quality

Natural trigger phrases users would actually say are present: "set up or update run commands", "Run button", "session". A few plausible variations are missing (e.g., "add a task", "tasks.json", "configure the Run button"), matching the 4 anchor of good coverage with a few natural terms absent rather than the comprehensive synonym-and-extension coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The niche is narrow and product-specific — "run commands" tied to "the session's Run button" — with triggers unlikely to collide with other skills. This is a clear niche with distinct triggers and minimal conflict risk, matching anchor 5 rather than the partially-overlapping 4 anchor.

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.