CtrlK
BlogDocsLog inGet started
Tessl Logo

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`.

76

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

High

Do not use without reviewing

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.

An exemplary instruction-only skill: lean, fully executable, and sequenced with an explicit verification-and-repair loop appropriate for a batch edit operation. Structure is well-organized with all content legitimately in one file, a distinct edge-cases section, and guardrails ('Do not') that prevent scope creep.

DimensionReasoningScore

Conciseness

Every section carries non-obvious, domain-specific information Claude could not infer (marker format, the authoritative detection regex, base64url payload encoding, the self-closing-element hoisting rule, reverse-line-order rationale). No padding, no explanation of concepts Claude already knows; the decode helper is 5 lines and immediately usable.

5 / 5

Actionability

Fully executable: an exact copy-paste regex, a complete base64url decode function, concrete per-step instructions (sort by descending lineIndex, use the Edit tool, delete marker plus trailing newline), and specific verify commands (typecheck/lint via the project's package manager, with a fallback for scaffolded projects lacking them). No pseudocode anywhere.

5 / 5

Workflow Clarity

A 7-step procedure (identify slides, find markers, understand in context, edit in reverse order, remove markers, verify, report) with an explicit validation checkpoint in step 6 (re-read to confirm only reported-skipped markers remain, check JSX well-formedness, run typecheck/lint) and a feedback loop ("Fix any errors you introduced"). This satisfies the batch/destructive-operation feedback-loop requirement, and edge cases plus a 'Do not' list cover error recovery.

5 / 5

Progressive Disclosure

No bundle files exist and none are needed — the skill is a single cohesive task where marker format, procedure, helper, and edge cases all belong in one file. Sections are clearly headed and navigable, and the one external dependency (the slide-authoring skill) is prominently signalled at the top as a one-level reference rather than buried.

5 / 5

Total

20

/

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 strong description: it states exactly what the skill does and gives multiple concrete, naturally-phrased trigger conditions plus a distinctive file pattern. The only weakness is that a single action verb ('apply') undersells the read/decode/edit/delete workflow the body actually defines.

Suggestions

Add one or two more concrete action verbs to the description (e.g. 'reads, decodes, and applies pending @slide-comment markers... then removes them') to lift specificity toward comprehensive coverage.

Include a common user synonym such as 'slide annotations' or 'inspector feedback' in the trigger clause to broaden natural-term coverage.

DimensionReasoningScore

Specificity

"Apply pending @slide-comment markers written by the open-slide inspector tool" names a concrete artifact and mechanism with no fluff, but describes a single action — the fuller read/edit/delete cycle is only implied, leaving minor gaps in coverage. It clearly exceeds the '1-2 concrete actions' anchor (3) but doesn't list multiple distinct actions for a 5.

4 / 5

Completeness

Explicitly answers what ("Apply pending @slide-comment markers written by the open-slide inspector tool") and when ("Use when the user asks to 'apply comments', 'process slide comments', 'apply the inspector comments', or references markers left inside `slides/<id>/index.tsx`") with concrete trigger phrases. Matches the anchor-5 example structure exactly; third person voice is used correctly.

5 / 5

Trigger Term Quality

Natural phrases users would actually say are quoted directly ("apply comments", "process slide comments", "apply the inspector comments") plus the concrete file-path pattern `slides/<id>/index.tsx`. Coverage is good; a few natural variants (e.g. 'slide annotations', 'apply feedback') are missing, so it falls just short of the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

The @slide-comment marker format, the open-slide inspector tool, and the slides/<id>/index.tsx path form a clear niche with distinct triggers that no generic editing or document skill would match. Minimal conflict risk.

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
1weiho/open-slide
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.