skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
community-access/accessibility-agents77 installs

severity-mapping

Canonical severity level definitions and cross-domain mapping for web, document, and markdown audits. Score impact ranges, WCAG conformance alignment, and cross-format normalization.

How do I install this agent skill?

npx skills add https://github.com/community-access/accessibility-agents --skill severity-mapping
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill is a purely informational reference for accessibility auditing and does not contain any executable code, network operations, or instructions that could lead to security risks.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

Severity Mapping

Canonical severity definitions shared across web, document, and markdown audit domains.

Canonical Severity Levels

LevelDefinitionWCAG ConformanceScore Impact
CriticalBlocks access entirely for one or more user groups. No workaround exists.Fails Level A-15 to -22 points
SeriousSeverely impairs access; a workaround may exist but is unreasonable.Fails Level A or AA-5 to -10 points
ModerateCauses friction or confusion; most users can still complete the task.Fails Level AA (advisory)-2 to -4 points
MinorPolish issue; no meaningful barrier for most users.Technique deviation-1 point

Cross-Domain Equivalents

Canonical LevelWeb (axe-core / Playwright)Document (Office/PDF)Markdown
Criticalcritical (axe-core)Missing document title; untagged PDF; missing heading structureBroken anchor link leading to dead navigation
Seriousserious (axe-core)Missing alt text on informational image; table has no headersAmbiguous link text (e.g., "click here"); missing alt text on image
Moderatemoderate (axe-core)Merged table cells; color-only data encodingSkipped heading level; missing table caption
Minorminor (axe-core)Decorative image with non-empty alt; redundant bookmarkEmoji in heading; em-dash used as list separator

Score Impact Rules

Score impacts listed above are additive per finding. When the same issue recurs across many elements:

  • First occurrence — full deduction
  • Same issue type, same page/file — no additional deduction (already counted once per issue rule)
  • Same issue type, different page/file — full deduction applies again to the new page/file score

Conversion Rules (Normalizing Cross-Domain Reports)

When generating a unified report that combines web, document, and markdown findings:

  1. Map each finding to the canonical severity level using the table above.
  2. Apply the score impact from the canonical level, not from the domain-specific tool's internal scoring.
  3. For aggregated scores (portfolio or project level), compute each page/file score independently, then average.
  4. Do not double-count a finding that appears in both an axe-core scan and a Playwright behavioral scan -- deduplicate by rule ID and element location.

Confidence Modifier (Web Domain)

For web audits, confidence level modifies the base deduction:

ConfidenceMultiplierSource Signals
Confirmed1.2xaxe-core + agent code review + Playwright behavioral test
High (two sources)1.0xAny two of the three sources above
High (one source)1.0x (reduced base)Single automated tool, high rule reliability
Medium0.7xSingle source, medium rule reliability
Low0.3xSingle source, low rule reliability or heuristic

Document and markdown audits do not use confidence multipliers -- they use the base score impact only.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/community-access/accessibility-agents/severity-mapping">View severity-mapping on skillZs</a>