document

Name: document
Author: Owl-Listener

82stars25forks

How to install document?

owl-listener/inclusive-design-skills/document

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

Installs into the current project.

Summary

Document accessibility decisions and tradeoffs for a feature. Chains: decision-documentation, tradeoff-analysis, compliance-mapping. Use when a feature is being designed or shipped and accessibility decisions need to be captured.

Files · 1

View on GitHub

SKILL.md

1	# Document Accessibility Decisions
2
3	Capture all accessibility decisions for a feature in a single,
4	structured record that will survive team changes and redesigns.
5
6	## Process
7
8	### Step 1: Identify Decisions
9	List every design or implementation choice that affects accessibility:
10	- Interaction patterns chosen
11	- Content and language decisions
12	- Visual design decisions
13	- What was included and what was deferred
14	- Tradeoffs made under constraints
15
16	### Step 2: Document Each Decision
17	Using decision-documentation, for each decision record:
18	- Context: what prompted the decision
19	- Decision: what was chosen
20	- Alternatives: what was considered and rejected
21	- Impact: who benefits, who is affected
22	- Evidence: what supported the decision
23
24	### Step 3: Analyse Tradeoffs
25	Using tradeoff-analysis, for any decision where accessibility
26	was compromised or where user needs conflicted:
27	- Who benefits from each option
28	- Who is harmed by each option
29	- Severity asymmetry (blocked vs friction)
30	- Remediation plan for excluded users
31	- Review date
32
33	### Step 4: Map to Standards
34	Using compliance-mapping, map each decision to the relevant
35	WCAG criteria:
36	- Which criteria does this decision satisfy
37	- Which criteria does this decision affect
38	- Are there any conformance risks
39
40	## Output
41
42	Deliver a feature accessibility decision record:
43
44	1. Feature summary — what was built and for whom
45	2. Decision log — each decision in the standard format
46	3. Tradeoff register — any tradeoffs with remediation plans
47	4. Compliance map — WCAG criteria coverage and gaps
48	5. Open items — deferred decisions that need future resolution

People who liked this also viewed

6 picks

Type

document

82stars25forks

View on GitHub

How to install document?

owl-listener/inclusive-design-skills/document

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

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Document Accessibility Decisions
2
3	Capture all accessibility decisions for a feature in a single,
4	structured record that will survive team changes and redesigns.
5
6	## Process
7
8	### Step 1: Identify Decisions
9	List every design or implementation choice that affects accessibility:
10	- Interaction patterns chosen
11	- Content and language decisions
12	- Visual design decisions
13	- What was included and what was deferred
14	- Tradeoffs made under constraints
15
16	### Step 2: Document Each Decision
17	Using decision-documentation, for each decision record:
18	- Context: what prompted the decision
19	- Decision: what was chosen
20	- Alternatives: what was considered and rejected
21	- Impact: who benefits, who is affected
22	- Evidence: what supported the decision
23
24	### Step 3: Analyse Tradeoffs
25	Using tradeoff-analysis, for any decision where accessibility
26	was compromised or where user needs conflicted:
27	- Who benefits from each option
28	- Who is harmed by each option
29	- Severity asymmetry (blocked vs friction)
30	- Remediation plan for excluded users
31	- Review date
32
33	### Step 4: Map to Standards
34	Using compliance-mapping, map each decision to the relevant
35	WCAG criteria:
36	- Which criteria does this decision satisfy
37	- Which criteria does this decision affect
38	- Are there any conformance risks
39
40	## Output
41
42	Deliver a feature accessibility decision record:
43
44	1. Feature summary — what was built and for whom
45	2. Decision log — each decision in the standard format
46	3. Tradeoff register — any tradeoffs with remediation plans
47	4. Compliance map — WCAG criteria coverage and gaps
48	5. Open items — deferred decisions that need future resolution

People who liked this also viewed

6 picks

Type