html-accessibility
Installation
SKILL.md
HTML Accessibility Skill
Purpose
Ensure websites meet WCAG 2.1 Level AA accessibility standards for inclusive user experience.
Core Principles (POUR)
Perceivable
- Text alternatives for images
- Captions for audio/video
- Sufficient color contrast
- Text resizable without loss
Operable
- Keyboard accessible
- Enough time to interact
- No seizure-inducing content
- Easy navigation
Understandable
- Readable text
- Predictable behavior
- Input assistance
- Error prevention
Robust
- Compatible with assistive tech
- Valid HTML
- Proper ARIA usage
Best Practices
Semantic HTML
<!-- ✅ Good: Semantic -->
<header>
<nav aria-label="Main navigation">
<ul>
<li><a href="/">Home</a></li>
</ul>
</nav>
</header>
<!-- ❌ Bad: Non-semantic -->
<div class="header">
<div class="nav">...</div>
</div>
Alt Text
<!-- ✅ Good: Descriptive alt -->
<img src="chart.png" alt="Bar chart showing 60% increase in usage">
<!-- ❌ Bad: Missing or useless alt -->
<img src="chart.png" alt="chart">
Color Contrast
/* ✅ Good: WCAG AA compliant */
.text {
color: #333; /* Contrast ratio: 12.6:1 */
background: #fff;
}
/* ❌ Bad: Insufficient contrast */
.text {
color: #777; /* Contrast ratio: 4.4:1 - fails for small text */
background: #fff;
}
Keyboard Navigation
/* ✅ Good: Visible focus */
a:focus, button:focus {
outline: 2px solid #007bff;
outline-offset: 2px;
}
/* ❌ Bad: Removed focus */
*:focus {
outline: none; /* NEVER DO THIS */
}
Testing
- Keyboard-only navigation
- Screen reader testing
- Color contrast checking
- HTML validation
- Automated tools (axe, WAVE)
References
Related skills
More from hack23/riksdagsmonitor
osint-methodologies
OSINT collection, source evaluation, data integration, verification techniques for Swedish political intelligence
40economic-policy-analysis
Fiscal policy, budget analysis, economic forecasting, monetary policy, trade policy for political journalists
31electoral-analysis
Election forecasting models, campaign analysis, coalition prediction, voter behavior analysis for Swedish elections
25vulnerability-management
Vulnerability scanning, assessment, prioritization, and remediation processes following NIST and CIS Controls
25nist-csf-mapping
NIST Cybersecurity Framework 2.0 mapping for static HTML/CSS websites
24testing-strategy
Comprehensive testing strategy covering unit, integration, E2E, security, accessibility, and performance testing
23