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.

Quality

77%

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

71%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 lean, well-sequenced, safety-conscious procedure that earns full marks for structure, but its actionability is capped by the total absence of executable commands or example invocations for the core scanning operation. Some generic Limitations boilerplate and compressed compound steps keep conciseness and workflow clarity just below top marks.

Suggestions

Include one concrete example invocation (or the exact command to discover the installed CLI's supported flags) so the core scan step is executable rather than deferred.

Trim the generic Limitations bullets that restate Claude's defaults (scope matching, asking for clarification) and keep only skill-specific limitations like the exercised-pages/rules caveat.

Unpack the compound numbered steps in section 1 into discrete sub-steps so the validation checkpoints (ready selector, revision verification) stand out as explicit gates.

DimensionReasoningScore

Conciseness

The body is dense and directive with no concept explanations ("A fixed sleep is not a readiness check"), but the generic Limitations boilerplate ("Use this skill only when the task clearly matches the scope described above", "Stop and ask for clarification if required inputs… are missing") states things Claude already knows and could be trimmed.

4 / 5

Actionability

The report-format block is a concrete example and the process constraints are specific, but no executable commands or example CLI invocations appear anywhere — "Capture the baseline and candidate using the actual supported CLI flags; do not invent commands" defers the core execution detail (which CLI, what flags) entirely, leaving key details missing. The non-bundled CLI partially justifies the flexibility, keeping this above the purely vague anchors.

3 / 5

Workflow Clarity

Clear snapshot → report → teardown sequence with explicit validation checkpoints ("wait for a deterministic ready selector and verify which revision each page actually serves", "Never promise full restoration without verifying file status and content"), but the numbered steps are compound and compressed and error-recovery guidance lives only in Gotchas rather than as explicit validate → fix → retry loops in the procedure, falling just short of the 5 anchor.

4 / 5

Progressive Disclosure

A 49-line body with well-organized sections (When to Use, three numbered phases, Gotchas, Limitations) and no bundle files; per the rubric's simple-skill guideline this earns a 5, and its single external pointer ("use the available `accesslint-audit` procedure") is clearly signaled and one level deep.

5 / 5

Total

16

/

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 highly specific, well-scoped description with concrete actions and explicit disambiguation from the related full-audit skill. Its main weakness is the absence of an explicit "Use when…" trigger clause and of common synonyms (a11y, WCAG) that users would naturally say.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to compare accessibility findings between two versions/revisions of a page, or to find only newly introduced a11y violations."

Include natural synonyms users actually say — "a11y", "WCAG", "accessibility regressions" — alongside "accessibility violations".

DimensionReasoningScore

Specificity

Quotes multiple specific concrete actions — "Diff a live page's accessibility violations against a baseline", "compares uncommitted changes (stash-based)", "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" — covering both diff modes, all report outputs, and the alternate full-audit command with no coverage gaps.

5 / 5

Completeness

The "what" is explicit and concrete, but there is no "Use when…" clause or equivalent explicit trigger guidance — the "when" is only implied by the what, which caps completeness at 3 per the judging guideline. It is not a 2 because the what is fully clear, and not a 4 because the when is absent rather than merely imprecise.

3 / 5

Trigger Term Quality

Good natural keyword coverage ("accessibility violations", "diff", "baseline", "audit", "branch") but common user synonyms like "a11y", "WCAG", or "accessibility regressions" are absent, so it stops short of comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

A clear niche — accessibility violation diffing against a baseline with stash-based and branch modes — and it explicitly disambiguates from the sibling full-audit skill ("Use `scan` for a full audit with no diffing"), giving minimal conflict risk.

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.