name: web-severity-scoring
description: Severity scoring, scorecard computation, confidence levels, and remediation tracking for web accessibility audits. Use when computing page accessibility scores (0-100 with A-F grades), tracking remediation progress across audits, or generating cross-page comparison scorecards.
Web Severity Scoring
Severity Scoring Formula
Page Score = 100 - (sum of weighted findings)
Weights:
Critical (high confidence, both sources): -15 points
Critical (high confidence, single source): -10 points
Critical (medium confidence): -7 points
Critical (low confidence): -3 points
Serious (high confidence): -7 points
Serious (medium confidence): -5 points
Serious (low confidence): -2 points
Moderate (high confidence): -3 points
Moderate (medium confidence): -2 points
Moderate (low confidence): -1 point
Minor: -1 point
Floor: 0 (minimum score)
Score Grades
| Score |
Grade |
Meaning |
| 90-100 |
A |
Excellent - minor or no issues, meets WCAG AA |
| 75-89 |
B |
Good - some issues, mostly meets WCAG AA |
| 50-74 |
C |
Needs Work - multiple issues, partial WCAG AA compliance |
| 25-49 |
D |
Poor - significant accessibility barriers |
| 0-24 |
F |
Failing - critical barriers, likely unusable with AT |
Confidence Levels
| Level |
Weight |
When to Use |
| High |
100% |
Confirmed by axe-core + agent, or definitively structural (missing alt, no labels, no lang) |
| Medium |
70% |
Found by one source, likely issue (heading edge cases, questionable ARIA, possible keyboard traps) |
| Low |
30% |
Possible issue, needs human review (alt text quality, reading order, context-dependent link text) |
Source Correlation
Issues found by both axe-core AND agent review are automatically upgraded to high confidence regardless of individual confidence ratings.
Scorecard Format
Single Page
## Accessibility Score
| Metric | Value |
|--------|-------|
| Page | [URL] |
| Score | [0-100] |
| Grade | [A-F] |
| Critical | [count] |
| Serious | [count] |
| Moderate | [count] |
| Minor | [count] |
Multi-Page
## Accessibility Scorecard
| Page | Score | Grade | Critical | Serious | Moderate | Minor |
|------|-------|-------|----------|---------|----------|-------|
| / | 82 | B | 0 | 2 | 3 | 1 |
| /login | 91 | A | 0 | 0 | 2 | 1 |
| /dashboard | 45 | D | 2 | 4 | 3 | 2 |
| **Average** | **72.7** | **C** | **2** | **6** | **8** | **4** |
Cross-Page Pattern Classification
| Pattern Type |
Definition |
Remediation ROI |
| Systemic |
Same issue on every audited page |
Highest - usually layout/nav, fix once |
| Template |
Same issue on pages sharing a component |
High - fix the shared component |
| Page-specific |
Unique to one page |
Normal - fix individually |
Remediation Tracking
Change Classification
| Status |
Definition |
| Fixed |
Issue was in previous report but no longer present |
| New |
Issue not in previous report, appears now |
| Persistent |
Issue remains from previous report |
| Regressed |
Issue was previously fixed but has returned |
Progress Metrics
- Issue reduction:
(fixed / previous_total) * 100
- Score change:
current_score - previous_score
- Pages improved: count of pages with higher scores than previous audit
- Trend: improving (score up 5+), stable (within 5), declining (score down 5+)
Issue Severity Categories
Critical
- No keyboard access to essential functionality
- Missing form labels on required fields
- Images conveying critical information have no alt text
- Color is the sole means of conveying information
- Keyboard traps with no escape
Serious
- Missing skip navigation
- Poor heading hierarchy (skipped levels)
- Focus not visible on interactive elements
- Form errors not programmatically associated
- Missing ARIA on custom widgets
Moderate
- Redundant ARIA on semantic elements
- Suboptimal heading structure (multiple H1s)
- Missing autocomplete on identity fields
- Links to new tabs without warning
- Missing table captions
Minor
- Redundant title attributes
- Suboptimal button text
- Missing landmark roles where semantic elements exist
- Decorative images with non-empty alt text
1---2name: web-severity-scoring-23description: Severity scoring, scorecard computation, confidence levels, and remediation tracking for web accessibility audits. Use when computing page accessibility scores (0-100 with A-F grades), tracking remediation progress across audits, or generating cross-page comparison scorecards.4metadata:5 source: https://skillmd.com/skills/community-access/web-severity-scoring-26---7<!-- CANONICAL SOURCE: .github/skills/web-severity-scoring/SKILL.md -- Edit the canonical source; sync to Gemini via scripts/check-gemini-sync.ps1 -->89# Web Severity Scoring1011## Severity Scoring Formula1213```text14Page Score = 100 - (sum of weighted findings)1516Weights:17 Critical (high confidence, both sources): -15 points18 Critical (high confidence, single source): -10 points19 Critical (medium confidence): -7 points20 Critical (low confidence): -3 points21 Serious (high confidence): -7 points22 Serious (medium confidence): -5 points23 Serious (low confidence): -2 points24 Moderate (high confidence): -3 points25 Moderate (medium confidence): -2 points26 Moderate (low confidence): -1 point27 Minor: -1 point2829Floor: 0 (minimum score)30```3132## Score Grades3334| Score | Grade | Meaning |35|-------|-------|---------|36| 90-100 | A | Excellent - minor or no issues, meets WCAG AA |37| 75-89 | B | Good - some issues, mostly meets WCAG AA |38| 50-74 | C | Needs Work - multiple issues, partial WCAG AA compliance |39| 25-49 | D | Poor - significant accessibility barriers |40| 0-24 | F | Failing - critical barriers, likely unusable with AT |4142## Confidence Levels4344| Level | Weight | When to Use |45|-------|--------|-------------|46| High | 100% | Confirmed by axe-core + agent, or definitively structural (missing alt, no labels, no lang) |47| Medium | 70% | Found by one source, likely issue (heading edge cases, questionable ARIA, possible keyboard traps) |48| Low | 30% | Possible issue, needs human review (alt text quality, reading order, context-dependent link text) |4950### Source Correlation5152Issues found by both axe-core AND agent review are automatically upgraded to **high confidence** regardless of individual confidence ratings.5354## Scorecard Format5556### Single Page5758```markdown59## Accessibility Score6061| Metric | Value |62|--------|-------|63| Page | [URL] |64| Score | [0-100] |65| Grade | [A-F] |66| Critical | [count] |67| Serious | [count] |68| Moderate | [count] |69| Minor | [count] |70```7172### Multi-Page7374```markdown75## Accessibility Scorecard7677| Page | Score | Grade | Critical | Serious | Moderate | Minor |78|------|-------|-------|----------|---------|----------|-------|79| / | 82 | B | 0 | 2 | 3 | 1 |80| /login | 91 | A | 0 | 0 | 2 | 1 |81| /dashboard | 45 | D | 2 | 4 | 3 | 2 |82| **Average** | **72.7** | **C** | **2** | **6** | **8** | **4** |83```8485## Cross-Page Pattern Classification8687| Pattern Type | Definition | Remediation ROI |88|-------------|-----------|-----------------|89| Systemic | Same issue on every audited page | Highest - usually layout/nav, fix once |90| Template | Same issue on pages sharing a component | High - fix the shared component |91| Page-specific | Unique to one page | Normal - fix individually |9293## Remediation Tracking9495### Change Classification9697| Status | Definition |98|--------|-----------|99| Fixed | Issue was in previous report but no longer present |100| New | Issue not in previous report, appears now |101| Persistent | Issue remains from previous report |102| Regressed | Issue was previously fixed but has returned |103104### Progress Metrics105106- **Issue reduction:** `(fixed / previous_total) * 100`107- **Score change:** `current_score - previous_score`108- **Pages improved:** count of pages with higher scores than previous audit109- **Trend:** improving (score up 5+), stable (within 5), declining (score down 5+)110111## Issue Severity Categories112113### Critical114- No keyboard access to essential functionality115- Missing form labels on required fields116- Images conveying critical information have no alt text117- Color is the sole means of conveying information118- Keyboard traps with no escape119120### Serious121- Missing skip navigation122- Poor heading hierarchy (skipped levels)123- Focus not visible on interactive elements124- Form errors not programmatically associated125- Missing ARIA on custom widgets126127### Moderate128- Redundant ARIA on semantic elements129- Suboptimal heading structure (multiple H1s)130- Missing autocomplete on identity fields131- Links to new tabs without warning132- Missing table captions133134### Minor135- Redundant title attributes136- Suboptimal button text137- Missing landmark roles where semantic elements exist138- Decorative images with non-empty alt text