CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

apply-comments

Apply pending @slide-comment markers written by the open-slide inspector tool. Use when the user asks to "apply comments", "process slide comments", "apply the inspector comments", or references markers left inside `slides/<id>/index.tsx`.

72

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

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: authoritative regex, executable helper code, a numbered workflow with explicit validation and error-recovery, and thoughtful edge-case and scope-limit sections. The only nit is minor wordiness in a few explanatory asides.

DimensionReasoningScore

Conciseness

The body is dense with genuinely non-obvious, project-specific facts (the authoritative marker regex, rect semantics on the 1920x1080 canvas, reverse-line-order rationale) and wastes few tokens on general knowledge. A few sentences could still be trimmed — e.g. the 'shouldn't happen — the inspector won't write one' aside and slight overlap between step 5's marker-removal caveats and step 6's verification — so it sits just below the lean-every-token-earns-its-place anchor.

4 / 5

Actionability

It provides a copy-paste-ready detection regex ('use exactly this'), an executable base64url decode helper, and concrete commands and tools for each step (Edit tool, node -e, /s/<id>/preview?p=N, package-manager typecheck/lint). The guidance is fully executable and covers the common cases (element targets, dragged rects, stacked markers), with no gaps found.

5 / 5

Workflow Clarity

The 7-step procedure is clearly sequenced with an explicit verification step (re-read for leftover markers, typecheck/lint, screenshot) and a feedback loop ('Fix any errors you introduced'), plus a dedicated edge-cases section with skip/report rules. Since this is a batch, partially destructive operation, the present validation loop satisfies the cap and matches the top anchor.

5 / 5

Progressive Disclosure

There are no bundle files; the single SKILL.md is well-organized into Marker format / Procedure / helper / Edge cases / Do not, and it delegates slide-structure detail to the clearly signaled slide-authoring skill one level deep rather than duplicating it. Nothing that belongs in a separate file is inlined, so navigation is easy and structure is appropriate.

5 / 5

Total

19

/

20

Passed

Description

82%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 well-formed description with an explicit 'Use when...' clause full of natural quoted trigger phrases and a clearly distinct niche. Its only weakness is thin capability coverage: it states a single action, leaving the read/decode/edit/remove-marker workflow implicit in the body.

Suggestions

List the concrete sub-actions in the description, e.g. 'Read each @slide-comment marker, apply the described edit, and remove the marker' — this would raise specificity from one action to several.

Add one or two more natural trigger variations users might say, such as 'resolve the comments' or 'clear the slide markers', to broaden trigger coverage.

Optionally name the workflow boundary explicitly (single slide vs. all slides) so the description alone conveys the scope of an invocation.

DimensionReasoningScore

Specificity

The description names its domain ('@slide-comment markers written by the open-slide inspector tool') and one concrete action ('Apply pending @slide-comment markers'), matching the 1-2-concrete-actions anchor. It does not list several specific actions, so it falls below the score-4 anchor; the decode/edit/delete-marker sub-steps exist only in the body.

3 / 5

Completeness

It explicitly answers both what ('Apply pending @slide-comment markers written by the open-slide inspector tool') and when (a 'Use when...' clause with multiple quoted trigger phrases), matching the top anchor. The 'when' is already maximally explicit with concrete trigger phrases, so 4 does not fit.

5 / 5

Trigger Term Quality

It quotes several natural user phrases ('apply comments', 'process slide comments', 'apply the inspector comments') and adds a concrete file-path trigger ('references markers left inside slides/<id>/index.tsx'), giving good coverage. It misses common phrasings like 'resolve the comments', 'review the comments', or 'clear the markers', so it is not comprehensive enough for a 5.

4 / 5

Distinctiveness Conflict Risk

The triggers are tightly scoped to slide-comment markers, the inspector tool, and slides/<id>/index.tsx — a clear niche with minimal overlap risk against generic editing or presentation skills. Even the related slide-authoring skill would not be wrongly triggered by these phrases.

5 / 5

Total

17

/

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

1weiho/open-slide

Path

packages/core/skills/apply-comments/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.