CtrlK
BlogDocsLog inGet started
Tessl Logo

plain-language

Use when reviewing rendered HTML, interactive components, or design-system patterns related to Write in plain language. Check native semantics first, then inspect keyboard behavior, focus flow, accessible names, and screen-reader output where relevant.

56

Quality

63%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/plain-language/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 clean, well-structured overview with an appropriately placed one-level reference to real implementation detail, and its Check/Fix sequence is easy to follow. Its weaknesses are internal redundancy (Quick Reference, Fix, and Explain repeat the same guidance) and abstract, example-free instructions in the body itself — the concrete examples and tools all live in the reference file.

Suggestions

Merge the Quick Reference bullets into the Check/Fix sections (or vice versa) — "Define technical terms when first used" and "Write in active voice" currently appear twice, and the Explain section repeats the intro sentence verbatim.

Add one compact before/after rewrite example and a concrete readability checkpoint (e.g. sentence-length threshold or 8th-grade target with a named tool) to the body so the core guidance is actionable without opening the reference.

State the verification step concretely in Check or Fix (e.g. "re-check sentence length after rewriting") instead of the abstract "Verify reading level is appropriate".

DimensionReasoningScore

Conciseness

The body is short and sectioned, but it is padded by duplication: "Fix" restates the Quick Reference bullets nearly verbatim ("Define technical terms when first used", "Write in active voice", "Target a reading level"), and "Explain" repeats the opening sentence word-for-word ("users with cognitive disabilities, learning differences, attention disorders, non-native speakers...") — a concept Claude already knows. This fits the anchor for mostly efficient but with unnecessary explanation that could be tightened; it is not 4 because the repetition spans multiple sections.

3 / 5

Actionability

The guidance gives concrete principles ("Use short sentences and common words", "Write in active voice", "Target reading level appropriate for your audience (often 8th grade)") but no examples or executable methods — "Verify reading level is appropriate" names no tool or threshold, and no before/after rewrite is shown in the body. This matches the anchor for some concrete guidance but incomplete with missing key details, not 4 since nothing in the body is directly actionable without opening the reference.

3 / 5

Workflow Clarity

The Check → Fix → Explain → Code Review sections form a clear single-purpose sequence, and the Code Review section includes a verification cue ("note how to verify the fix with browser accessibility tooling or assistive tech"). It is not 5 because the validation step is abstract — no concrete checkpoint for verifying reading level or confirming the fix — which fits the anchor for a clear sequence with minor validation gaps.

4 / 5

Progressive Disclosure

The body is a well-organized overview with clearly signaled one-level-deep references: "For full implementation details, code examples, and framework-specific guidance, see `references/rule.md`" — and that file exists with substantive content (examples, Avoid/Use table, checklist, verification steps). This matches the anchor for a clear overview with well-signaled one-level-deep references and easy navigation.

5 / 5

Total

15

/

20

Passed

Description

63%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 has an explicit Use-when clause and a concrete list of review actions, but it reads like a mismatched template: the actions and triggers describe generic accessibility inspection rather than the plain-language content work the skill actually covers, and the linking clause is garbled. It communicates when to fire reasonably well but poorly describes what this particular skill does.

Suggestions

Rewrite the description around the skill's actual purpose with natural trigger phrases users would say, e.g. "Review and rewrite content for jargon, sentence complexity, passive voice, and reading level (8th grade). Use when the user mentions plain language, jargon, readability, or simplifying text."

Replace the generic accessibility boilerplate (keyboard behavior, focus flow, screen-reader output) with plain-language-specific actions so the description doesn't collide with sibling accessibility skills that share this template.

Fix the malformed clause "design-system patterns related to Write in plain language", which reads as a template artifact and undermines both trigger clarity and distinctiveness.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Check native semantics first, then inspect keyboard behavior, focus flow, accessible names, and screen-reader output" — which matches the anchor for several specific actions. It falls short of 5 because coverage has a real gap: none of the skill's actual plain-language actions (jargon review, simplifying sentences, reading-level checks) are stated, and the garbled clause "design-system patterns related to Write in plain language" muddies the action list.

4 / 5

Completeness

Both parts are explicitly present: a clear what ("Check native semantics first, then inspect keyboard behavior, focus flow, accessible names, and screen-reader output") and an explicit when ("Use when reviewing rendered HTML, interactive components, or design-system patterns..."). It is not 5 because the when clause is malformed ("...related to Write in plain language") and its triggers don't align with the stated actions, leaving the when-specificity below the clear-and-explicit anchor.

4 / 5

Trigger Term Quality

There are relevant keywords ("rendered HTML", "interactive components", "screen-reader output") but the natural phrases a user would say when needing this skill — "plain language", "jargon", "readability", "reading level", "simplify text" — are missing except for the awkwardly embedded "Write in plain language". This matches the anchor for some relevant keywords missing common variations or synonyms, rather than 4 where only a few natural terms are missing.

3 / 5

Distinctiveness Conflict Risk

The body of the description is generic accessibility-review boilerplate (semantics, keyboard, focus, screen readers) that would equally describe nearly any accessibility skill, creating overlap risk with sibling accessibility rules. Only the embedded "Write in plain language" phrase differentiates it, which fits the anchor for somewhat specific but still overlapping with similar skills — not 4, since the differentiator is garbled rather than a clean distinct trigger.

3 / 5

Total

14

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
thedaviddias/Front-End-Checklist
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.