---
title: "/run-audit - Run Accessibility Audit"
description: "Execute a comprehensive accessibility audit against WCAG guidelines."
type: skill
canonical_url: https://claudary.paisolsolutions.com/skills/run-audit
source: "Claudary"
difficulty: intermediate
author: "Claude Code Knowledge Pack"
date: 2026-07-10T11:46:17.800Z
license: CC-BY-4.0
attribution: "/run-audit - Run Accessibility Audit — Claudary (https://claudary.paisolsolutions.com/skills/run-audit)"
---

# /run-audit - Run Accessibility Audit
Execute a comprehensive accessibility audit against WCAG guidelines.

## Overview

# /run-audit - Run Accessibility Audit

Execute a comprehensive accessibility audit against WCAG guidelines.

## Steps

1. Ask the user for the target URL or component to audit
2. Configure the audit scope: WCAG 2.1 Level A, AA, or AAA
3. Run automated accessibility scanning using axe-core or similar engine
4. Check all WCAG success criteria applicable to the content type
5. Test keyboard navigation: all interactive elements reachable and operable
6. Verify focus management: visible focus indicators, logical focus order
7. Check ARIA usage: proper roles, states, properties, and landmark regions
8. Validate heading hierarchy: logical order without skipping levels
9. Test color contrast ratios: 4.5:1 for normal text, 3:1 for large text
10. Check form accessibility: labels, error messages, required field indicators
11. Verify media accessibility: alt text, captions, audio descriptions
12. Compile findings into a prioritized report by impact level

## Rules

- Test against WCAG 2.1 AA as the minimum standard
- Automated tools catch about 30% of issues; note that manual testing is also needed
- Prioritize issues by user impact: critical (blocks access), serious, moderate, minor
- Include WCAG success criterion reference for each finding
- Test with actual assistive technology when possible (VoiceOver, NVDA)
- Do not flag decorative images that correctly have empty alt attributes
- Include remediation guidance with each finding

---

Source: [Claudary](https://claudary.paisolsolutions.com/skills/run-audit) · https://claudary.paisolsolutions.com