review

Name: review
Author: Owl-Listener

82stars25forks

How to install review?

owl-listener/inclusive-design-skills/review

$npx -y skills add Owl-Listener/inclusive-design-skills --skill review

Installs into the current project.

Summary

Review and surface undocumented accessibility assumptions in an existing feature or product. Chains: decision-documentation, tradeoff-analysis, compliance-mapping, accessibility-debt-tracking. Use when inheriting a product, joining a team, or auditing a feature where accessibilit

Files · 1

View on GitHub

SKILL.md

1	# Review Accessibility Decisions
2
3	Surface the accessibility decisions that were made — deliberately or
4	by default — in an existing feature, and document them before they
5	get lost.
6
7	## Process
8
9	### Step 1: Identify Implicit Decisions
10	Walk through the feature and list every design choice that affects
11	accessibility, even if nobody explicitly decided it:
12	- How is keyboard navigation handled?
13	- What happens with screen readers?
14	- What colour and contrast choices were made?
15	- How are errors communicated?
16	- What motion and animation exists?
17	- What user preferences are respected?
18
19	Many of these were never consciously decided — they were inherited
20	from a framework, copied from another feature, or left at defaults.
21	Those are still decisions. Document them.
22
23	### Step 2: Assess Each Decision
24	For each identified decision, determine:
25	- Was this intentional or accidental?
26	- Does it meet current accessibility standards?
27	- Who does it serve well? Who does it exclude?
28	- Is there evidence behind it or was it arbitrary?
29
30	### Step 3: Check for Undocumented Tradeoffs
31	Using tradeoff-analysis, identify decisions where accessibility
32	was traded for something else:
33	- Speed: "we didn't have time to make this keyboard accessible"
34	- Complexity: "the accessible version was too hard to build"
35	- Design: "the accessible version didn't look right"
36	- Ignorance: "we didn't know this was an issue"
37
38	Document each with its current impact on users.
39
40	### Step 4: Map Current Compliance
41	Using compliance-mapping, assess the feature's current state
42	against WCAG 2.2 Level AA. Identify conformance gaps.
43
44	### Step 5: Catalogue Debt
45	Using accessibility-debt-tracking, create a debt record for
46	every known issue discovered in this review.
47
48	## Output
49
50	Deliver a decision review report:
51
52	1. Decision inventory — every accessibility-affecting decision
53	found, marked as intentional or accidental
54	2. Undocumented tradeoffs — decisions where accessibility was
55	sacrificed, with current user impact
56	3. Compliance gaps — WCAG criteria not currently met
57	4. Debt register — known issues with severity, owner, and
58	recommended timeline
59	5. Recommendations — which decisions should be revisited first

People who liked this also viewed

6 picks

Type

review

82stars25forks

View on GitHub

How to install review?

owl-listener/inclusive-design-skills/review

$npx -y skills add Owl-Listener/inclusive-design-skills --skill review

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Review Accessibility Decisions
2
3	Surface the accessibility decisions that were made — deliberately or
4	by default — in an existing feature, and document them before they
5	get lost.
6
7	## Process
8
9	### Step 1: Identify Implicit Decisions
10	Walk through the feature and list every design choice that affects
11	accessibility, even if nobody explicitly decided it:
12	- How is keyboard navigation handled?
13	- What happens with screen readers?
14	- What colour and contrast choices were made?
15	- How are errors communicated?
16	- What motion and animation exists?
17	- What user preferences are respected?
18
19	Many of these were never consciously decided — they were inherited
20	from a framework, copied from another feature, or left at defaults.
21	Those are still decisions. Document them.
22
23	### Step 2: Assess Each Decision
24	For each identified decision, determine:
25	- Was this intentional or accidental?
26	- Does it meet current accessibility standards?
27	- Who does it serve well? Who does it exclude?
28	- Is there evidence behind it or was it arbitrary?
29
30	### Step 3: Check for Undocumented Tradeoffs
31	Using tradeoff-analysis, identify decisions where accessibility
32	was traded for something else:
33	- Speed: "we didn't have time to make this keyboard accessible"
34	- Complexity: "the accessible version was too hard to build"
35	- Design: "the accessible version didn't look right"
36	- Ignorance: "we didn't know this was an issue"
37
38	Document each with its current impact on users.
39
40	### Step 4: Map Current Compliance
41	Using compliance-mapping, assess the feature's current state
42	against WCAG 2.2 Level AA. Identify conformance gaps.
43
44	### Step 5: Catalogue Debt
45	Using accessibility-debt-tracking, create a debt record for
46	every known issue discovered in this review.
47
48	## Output
49
50	Deliver a decision review report:
51
52	1. Decision inventory — every accessibility-affecting decision
53	found, marked as intentional or accidental
54	2. Undocumented tradeoffs — decisions where accessibility was
55	sacrificed, with current user impact
56	3. Compliance gaps — WCAG criteria not currently met
57	4. Debt register — known issues with severity, owner, and
58	recommended timeline
59	5. Recommendations — which decisions should be revisited first

People who liked this also viewed

6 picks

Type