CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

flutter-accessibility

Build or audit Flutter accessibility for semantics, screen readers, focus, keyboard access, text scaling, contrast, target size, and motion preferences. Pair with flutter-responsive-layout when large text causes reflow, clipping, or overflow across constraints.

Quality

82%

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

The canonical home for this skill is thiennc-tesoglobal/flutter-skills

SKILL.md
Quality
Evals
Security

Quality

Content

86%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 well-crafted, token-efficient instruction-only skill: terse audit rules, a coherent audit-implement-verify structure, and exemplary progressive disclosure with condition-triggered references that resolve to real files. The only notable gap is that executable specifics (matcher names, commands, thresholds) live entirely in the references rather than the body.

DimensionReasoningScore

Conciseness

The ~30-line body is lean with no padding or explanation of concepts Claude already knows — "Treat accessibility as behavior to implement and verify, not a label-only cleanup" earns its place as a framing principle, and every rule is a terse directive. Matches anchor 5 (lean, assumes competence, every token earns its place); anchor 4's 'minor instances of over-explanation' does not apply.

5 / 5

Actionability

Concrete directives like "Prefer semantic built-in controls before manually adding `Semantics`" and "Use widget tests with semantics enabled and Flutter's accessibility guideline matchers" give mostly executable guidance, and as an instruction-only skill the absence of code is not penalized. Not a 5 because specifics a user would need to execute — named matchers, test commands, concrete threshold numbers — are deferred to references and "where suitable" hedges the verification advice.

4 / 5

Workflow Clarity

A clear audit → apply rules → verify arc: "Audit the flow" lists what to identify, Rules state what to enforce, and Verification specifies widget tests plus "TalkBack or VoiceOver and keyboard navigation". Matches anchor 4 (clear sequence with most checkpoints present); not a 5 because verification is not woven in as an explicit validate-and-fix loop, and not a 3 because a concrete verification section is present.

4 / 5

Progressive Disclosure

The body is a concise overview with two one-level-deep references, each clearly signal-conditioned: "Read [semantics and screen readers](references/semantics-and-screen-readers.md) when annotating custom widgets..." and "Read [target sizes and contrast](references/target-sizes-and-contrast.md) when auditing WCAG AA contrast ratios...". Both referenced files exist in the bundle with real content, and nothing that belongs in a reference is inlined — matches anchor 5.

5 / 5

Total

18

/

20

Passed

Description

70%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, domain-specific description that clearly states what the skill does and distinguishes it from related skills. Its main gap is the absence of an explicit trigger clause for using this skill itself — the only 'when' guidance concerns pairing with flutter-responsive-layout — and it lacks common synonyms like a11y, VoiceOver, TalkBack, and WCAG.

Suggestions

Add an explicit 'Use when...' clause for this skill, e.g. "Use when the user asks to make a Flutter app accessible, mentions screen readers, a11y, VoiceOver/TalkBack, WCAG, contrast, or text scaling, or reports accessibility audit findings."

Include natural synonyms and tool names users actually say — a11y, VoiceOver, TalkBack, WCAG, screen reader — to broaden trigger term coverage.

Sharpen the 'what' with more distinct concrete actions, e.g. "annotate custom widgets with Semantics, run accessibility-guideline widget tests, and fix contrast and target-size violations" in addition to build/audit.

DimensionReasoningScore

Specificity

"Build or audit Flutter accessibility for semantics, screen readers, focus, keyboard access, text scaling, contrast, target size, and motion preferences" names two concrete actions (build, audit) and enumerates eight specific capability areas. Not a 5 because the action verbs are limited to build/audit while the anchor-5 example shows multiple distinct concrete actions; not a 3 because coverage of the domain is far more comprehensive than 1-2 actions.

4 / 5

Completeness

The "what" is clear ("Build or audit Flutter accessibility for semantics, screen readers, focus..."), but the only when-clause — "Pair with flutter-responsive-layout when large text causes reflow" — governs pairing with another skill, not when to use this skill. Per the guideline that a missing 'Use when...' clause for the skill itself caps completeness at 3, this fits anchor 3 (clear what, when missing or only weakly implied) rather than anchor 4.

3 / 5

Trigger Term Quality

Includes natural terms users would say such as "accessibility", "screen readers", "contrast", "text scaling", "keyboard access", and "target size". Missing common synonyms and tool names like "a11y", "VoiceOver", "TalkBack", or "WCAG" that anchor 5 expects, but coverage is clearly better than anchor 3's partial keyword set.

4 / 5

Distinctiveness Conflict Risk

"Flutter accessibility" plus specific areas (semantics, screen readers, target size, motion preferences) carves a clear niche with minimal overlap risk, and the pairing note "Pair with flutter-responsive-layout when large text causes reflow" explicitly resolves the boundary with the closest neighboring skill. This matches anchor 5's clear-niche example and is well above anchor 4's minor-overlap case.

5 / 5

Total

16

/

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

thienqo/flutter-skills

Path

skills/flutter-accessibility/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.