CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

accesslint-diff

Diff a live page's accessibility violations against a baseline — by default compares uncommitted changes (stash-based), or pass --branch [<name>] to diff against a branch. Reports only new violations introduced, violations fixed, and pre-existing count. Use `scan` for a full audit with no diffing.

64

Quality

80%

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 ./plugins/agentic-awesome-skills-claude/skills/accesslint-diff/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

A tight, well-structured, safety-conscious report-only workflow with explicit verification checkpoints embedded at every phase, scoring highly across all dimensions. The only soft spots are generic disclaimer boilerplate in Limitations and the absence of any example commands or error-recovery feedback loops, the former justified by not bundling the CLI.

DimensionReasoningScore

Conciseness

The core phases are lean and imperative, assume Claude's competence (e.g., "A fixed sleep is not a readiness check"; no explanation of what accessibility or WCAG is), and pack dense, useful constraints into single lines. The generic "Limitations" boilerplate ("Do not treat the output as a substitute for environment-specific validation, testing, or expert review") is minor padding that could be trimmed, which fits the 'efficient; minor instances of over-explanation' anchor rather than the every-token-earns-its-place anchor above.

4 / 5

Actionability

Specific, actionable directives throughout — separate local ports, "wait for a deterministic ready selector", "Keep private snapshots in a fresh owner-only directory", verbatim selectors with "file:line (symbol)", "never fabricate" — plus a concrete report template. It contains no executable commands, but that is explicitly justified ("This package does not bundle the CLI or browser... do not invent commands when integration is unavailable"), and per the scoring notes an instruction-only skill is not penalized for lacking code when the guidance is actionable. It still falls short of the copy-paste-ready anchor 5.

4 / 5

Workflow Clarity

A clear three-phase sequence (establish isolated snapshots → report → tear down) with explicit validation checkpoints: "verify which revision each page actually serves", "A fixed sleep is not a readiness check", "Never promise full restoration without verifying file status and content", and "verify with the same controlled baseline". It lacks explicit validate→fix→retry feedback loops, so it matches the 'clear sequence with most checkpoints present; minor validation gaps' anchor rather than the feedback-loops anchor. The destructive/batch cap does not apply since the skill is explicitly report-only ("Don't edit").

4 / 5

Progressive Disclosure

The body is under 50 lines with no bundle files and no content that belongs in a separate file — the report template is small and appropriately inline. Sections are well organized (When to Use / three numbered phases / Gotchas / Limitations), and per the rubric guideline a sub-50-line skill with no need for external references scores 5 on well-organized sections alone.

5 / 5

Total

17

/

20

Passed

Description

75%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 specific, distinctive, third-person description whose 'what' is excellent, held back only by the absence of an explicit 'Use when...' trigger clause, which caps completeness at 3 per the rubric. Keyword coverage is good but misses natural synonyms like 'a11y' or 'WCAG'.

Suggestions

Add an explicit trigger clause, e.g. "Use when comparing accessibility findings between two versions of a page, or when asked what a11y issues a change introduced or fixed."

Include natural synonyms users actually say — 'a11y', 'WCAG', 'accessibility audit' — alongside 'accessibility violations' to broaden trigger matching.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions: "Diff a live page's accessibility violations against a baseline", "by default compares uncommitted changes (stash-based)", "pass --branch [<name>] to diff against a branch", "Reports only new violations introduced, violations fixed, and pre-existing count", and "Use `scan` for a full audit with no diffing". Coverage spans the default mode, the branch mode, the exact output contents, and the sibling skill, so it matches the comprehensive anchor rather than the 'minor gaps' anchor below.

5 / 5

Completeness

The 'what' is explicit and concrete, but there is no "Use when..." clause or equivalent trigger guidance for invoking this skill — "Use `scan` for a full audit with no diffing" is a pointer to the sibling skill, not a when-to-use trigger. Per the rubric guideline, a missing 'Use when' clause caps completeness at 3; the 'when' is only weakly implied by the 'what', which fits the score-3 anchor rather than the score-4 anchor that requires both to be present.

3 / 5

Trigger Term Quality

Good natural keyword coverage ("accessibility violations", "diff", "baseline", "branch", "audit", "scan") that users would plausibly say, but common synonyms such as "a11y", "WCAG", "contrast", or "screen reader" are absent. This matches the 'good keyword coverage; a few natural terms missing' anchor rather than the comprehensive-synonyms anchor above.

4 / 5

Distinctiveness Conflict Risk

It carves out a clear niche (diffing accessibility violations between two revisions of a page) and even differentiates its own sibling mode ("Use `scan` for a full audit with no diffing"), so it is unlikely to trigger the wrong skill. This matches the 'clear niche with distinct triggers; minimal conflict risk' anchor; the neighboring anchor would require overlap risk with related skills, which is absent.

5 / 5

Total

17

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

sickn33/agentic-awesome-skills

Path

plugins/agentic-awesome-skills-claude/skills/accesslint-diff/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.