CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

testland/screen-reader-test-author

Use when a feature needs manual screen-reader testing before sign-off: step-by-step scripts for NVDA, JAWS, VoiceOver or TalkBack with keystrokes and expected announcements, WCAG 2.2 checklists per page type, widget keystroke matrices and a guided session with a signed report.

Quality

94%

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

Overview
Quality
Evals
Security
Files

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.

The body is a highly actionable, well-sequenced authoring workflow: concrete keystroke/announcement tables, executable templates, explicit pass criteria, failure-cause mappings, and session checkpoints with sign-off. Structure and progressive disclosure are exemplary, with the only real criticism being minor duplication of VoiceOver shortcut listings and external links that could be trimmed.

DimensionReasoningScore

Conciseness

The body is dense with tables, keystroke matrices, and copy-paste templates rather than padded explanation, and it does not re-explain basics like what a screen reader is. Minor trimming is possible: the VoiceOver shortcut list appears twice (Step 3 table and the "Build the session package" bullets), and the References list repeats inline-linked external docs — matching level 4 ("efficient; minor instances that could be trimmed") rather than level 5's every-token-earns-its-place.

4 / 5

Actionability

Guidance is fully executable: concrete keystroke + expected-announcement tables (e.g., "H → 'Edit profile, heading level 2'"), a YAML flow format, four numbered PASS criteria, a failure-to-likely-cause table, copy-paste markdown templates for the checklist and session report, and an explicit output path convention (a11y-sessions/<component>-<YYYY-MM-DD>-<sr>.md). This matches level 5 for an instruction-only skill; it is not level 4 because there are no meaningful gaps in executable detail.

5 / 5

Workflow Clarity

Steps 1–5 are clearly sequenced, and "Running the session" adds explicit validation checkpoints: per-step PASS/FAIL/BLOCKED checkboxes, a focus-return checkpoint per the APG dialog pattern, a timing checkpoint per WCAG SC 4.1.3, a failure table mapping observed failure to likely cause for error recovery, and a "stop and ask" guard when the rendered URL is missing. This matches level 5 (explicit validation, feedback for recovery, checklists), not level 4.

5 / 5

Progressive Disclosure

The body is a clear overview that keeps only worked excerpts inline and defers full material to three real, one-level-deep reference files (references/screen-reader-scripts.md, references/wcag-checklist.md, references/widget-matrix.md), each linked with its purpose and when to use it, and each file verified to point back to SKILL.md and external docs rather than nesting further. This matches level 5 (well-signaled one-level-deep references, easy navigation), not level 4.

5 / 5

Total

19

/

20

Passed

Description

92%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 that clearly and concretely states both what the skill produces and when to use it, with specific tool names and artifact types giving it a distinct trigger niche. The only gap is missing common synonyms such as "accessibility" or "a11y" that a user might naturally say.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete actions and artifacts: "step-by-step scripts for NVDA, JAWS, VoiceOver or TalkBack with keystrokes and expected announcements, WCAG 2.2 checklists per page type, widget keystroke matrices and a guided session with a signed report" — naming all four tools and each output shape. It is comprehensive rather than having minor gaps, so it matches the level-5 anchor and not level 4.

5 / 5

Completeness

It explicitly answers "when" ("Use when a feature needs manual screen-reader testing before sign-off") and "what" (scripts with keystrokes/expected announcements, WCAG checklists, widget matrices, guided session with signed report). Both are explicit and concrete, matching the level-5 anchor; it is not level 4 because the when-clause is specific rather than one that "could be more explicit".

5 / 5

Trigger Term Quality

Natural phrases a user would say are present ("manual screen-reader testing", "sign-off", "NVDA", "JAWS", "VoiceOver", "TalkBack", "WCAG 2.2"), but common synonyms like "accessibility", "a11y", or "accessibility audit" are absent. This fits level 4 ("good keyword coverage; a few natural terms missing") rather than level 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The niche is narrow and distinct — manual screen-reader testing against named tools (NVDA, JAWS, VoiceOver, TalkBack) with keystroke-level scripts — with little overlap risk against automated-scan or generic accessibility skills. The triggers are specific enough that it would not fire for the wrong skill, matching the level-5 anchor.

5 / 5

Total

19

/

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.

Reviewed

On this page