CtrlK
BlogDocsLog inGet started
Tessl Logo

act-on-feedback

Act on user feedback attached to the current session. Use when the user submits feedback on the session's changes via the Submit Feedback button.

65

Quality

78%

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

Fix and improve this skill with Tessl

tessl review fix ./src/vs/sessions/skills/act-on-feedback/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%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 lean, well-sequenced workflow with concrete tool invocations, explicit scoping rules, and a final verification step — an exemplary instruction-only skill body. The only minor gaps are the unspecified choice between resolving and deleting comments and the absence of a recovery step if verification fails.

DimensionReasoningScore

Conciseness

The ~15-line body contains zero concept explanations and no padding — every step is functional instruction ("Use the `listComments` tool", "match them by their comment id", "Verify your changes are consistent with the rest of the codebase"). It fully assumes Claude's competence, matching anchor 5 ("Lean and efficient; assumes Claude's competence; every token earns its place").

5 / 5

Actionability

The guidance names concrete tools (`listComments`, `resolveComments`, `deleteComments`) and gives a specific matching rule ("match them by their comment id") plus scoping options in step 2, making it mostly executable. It falls short of anchor 5 because step 5 offers resolve vs. delete with no criteria for choosing between them — a minor gap in concrete guidance.

4 / 5

Workflow Clarity

A clear 6-step numbered sequence with conditional handling in step 2 (attached-only vs. all vs. user-specified subset) and a final verification checkpoint in step 6. It falls short of anchor 5 because there is no error-recovery loop (what to do if step 6's verification fails) and the destructive resolve/delete actions in step 5 occur before verification, a minor validation-ordering gap.

4 / 5

Progressive Disclosure

This is a simple single-purpose skill under 50 lines with no bundle files (no references/, scripts/, or assets/ directories exist) and no content that warrants external files. The single well-organized section satisfies the rubric's simple-skill guideline ("For skills under 50 lines with no need for external references, progressive disclosure can score 5 with just well-organized sections").

5 / 5

Total

18

/

20

Passed

Description

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

The description excels at completeness and distinctiveness, with an explicit and well-targeted "Use when" trigger clause anchored to a concrete UI action. Its weakness is specificity — the action verb "act on" is generic and the description omits the concrete sub-actions the skill actually performs.

Suggestions

Replace or augment the generic "Act on" verb with 2-3 concrete actions, e.g. "Retrieve user feedback comments for the current session, make the requested changes, and resolve or delete the comments once addressed."

Add natural keyword variations users might say, such as "feedback comments", "address feedback", or "review my changes", to improve trigger matching beyond the single "feedback" term.

Consider naming the tools involved (listComments, resolveComments, deleteComments) to sharpen the what-clause without adding much length.

DimensionReasoningScore

Specificity

"Act on user feedback attached to the current session" names the domain but offers only the single generic action "act on" — it does not state the concrete sub-actions (retrieving comments, making changes, resolving/deleting comments). This matches the anchor "Names the domain but actions are minimal or generic"; it falls short of anchor 3 because no second concrete action is explicitly stated.

2 / 5

Completeness

The "what" is explicitly stated ("Act on user feedback attached to the current session") and the "when" is explicit and concrete ("Use when the user submits feedback on the current session's changes via the Submit Feedback button"). Both are clearly answered with a concrete trigger phrase, matching anchor 5; anchor 4 would require a less specific "when" clause, which is not the case here.

5 / 5

Trigger Term Quality

The description includes natural phrases a user would say ("user feedback", "submits feedback", "Submit Feedback button"), but misses common variations and synonyms such as "comments", "review changes", or "address feedback". This sits at anchor 3 ("Some relevant keywords but missing common variations or synonyms") rather than anchor 4, which expects broader keyword coverage.

3 / 5

Distinctiveness Conflict Risk

References to "the current session's changes" and the "Submit Feedback button" carve out a clear niche tied to a specific UI action, minimizing overlap with general feedback- or code-review-related skills. This matches anchor 5 ("Clear niche with distinct triggers; minimal conflict risk").

5 / 5

Total

15

/

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.