Skip to content

aiskillstore/marketplace / skills/89jobrien/web-accessibility

web-accessibility

Verified

Web accessibility compliance specialist. Use when conducting WCAG compliance audits, testing screen reader compatibility, validating keyboard navigation, or ensuring inclusive design. Focuses on WCAG 2.1/2.2 standards.

FileKindSize
SKILL.mdskill md3.4 KB
skill-report.jsonconfig16.5 KB

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-07-05T14:20:04.580Z",
    "slug": "89jobrien-web-accessibility",
    "source_url": "https://github.com/89jobrien/steve/tree/main/steve/skills/web-accessibility",
    "source_ref": "main",
    "model": "codex",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "0d4c807834f3f3c6a0f9baf836b13dc9e5687f0de1cf530e7afe22afc3693e80",
    "tree_hash": "77c9a0ed3a576fef30362c5397a2798cb75269fdd7f0087e27cf7dd7665b81a2",
    "provenance": {
      "model_effective": "codex",
      "fallback_chain": [
        {
          "agent": "codex",
          "outcome": "success"
        }
      ],
      "analysis_version": "3.0.0"
    }
  },
  "skill": {
    "name": "web-accessibility",
    "description": "Web accessibility compliance specialist. Use when conducting WCAG compliance audits, testing screen reader compatibility, validating keyboard navigation, or ensuring inclusive design. Focuses on WCAG 2.1/2.2 standards.",
    "summary": "Guides WCAG audits, screen reader checks, keyboard testing, and accessible design remediation.",
    "icon": "📦",
    "version": "1.0.2",
    "author": "Joseph OBrien",
    "license": "MIT",
    "category": "design",
    "tags": [
      "accessibility",
      "wcag",
      "screen-readers",
      "keyboard-navigation",
      "inclusive-design"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "external_commands"
    ]
  },
  "security_audit": {
    "risk_level": "safe",
    "is_blocked": false,
    "safe_to_publish": true,
    "analysis_status": "ok",
    "summary": "Static analysis flagged 11 external command findings, but each cited line is a Markdown code fence or documentation example in SKILL.md. No executable command invocation, prompt injection, data exfiltration intent, or unsafe automation was found.",
    "remediation": [],
    "risk_factor_evidence": [
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 40,
            "line_end": 42
          },
          {
            "file": "SKILL.md",
            "line_start": 42,
            "line_end": 44
          },
          {
            "file": "SKILL.md",
            "line_start": 44,
            "line_end": 46
          },
          {
            "file": "SKILL.md",
            "line_start": 46,
            "line_end": 50
          },
          {
            "file": "SKILL.md",
            "line_start": 50,
            "line_end": 52
          },
          {
            "file": "SKILL.md",
            "line_start": 52,
            "line_end": 88
          },
          {
            "file": "SKILL.md",
            "line_start": 88,
            "line_end": 97
          },
          {
            "file": "SKILL.md",
            "line_start": 97,
            "line_end": 103
          },
          {
            "file": "SKILL.md",
            "line_start": 103,
            "line_end": 111
          },
          {
            "file": "SKILL.md",
            "line_start": 111,
            "line_end": 118
          },
          {
            "file": "SKILL.md",
            "line_start": 118,
            "line_end": 128
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "external_commands:SKILL.md:40:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 40,
        "line_end": 42,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:42:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 42,
        "line_end": 44,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:44:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 44,
        "line_end": 46,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:46:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 46,
        "line_end": 50,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:50:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 50,
        "line_end": 52,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:52:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 52,
        "line_end": 88,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:88:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 88,
        "line_end": 97,
        "snippet": "```markdown"
      },
      {
        "id": "external_commands:SKILL.md:97:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 97,
        "line_end": 103,
        "snippet": "```html"
      },
      {
        "id": "external_commands:SKILL.md:103:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 103,
        "line_end": 111,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:111:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 111,
        "line_end": 118,
        "snippet": "```html"
      },
      {
        "id": "external_commands:SKILL.md:118:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 118,
        "line_end": 128,
        "snippet": "```"
      }
    ],
    "finding_verdicts": [
      {
        "id": "external_commands:SKILL.md:40:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "Line 40 opens a plain Markdown prompt example, not a Ruby or shell command. The fenced text only asks the user to conduct a WCAG audit."
      },
      {
        "id": "external_commands:SKILL.md:42:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "Line 42 closes a Markdown prompt example and contains no executable command. There is no dynamic input or shell invocation around this fence."
      },
      {
        "id": "external_commands:SKILL.md:44:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "Line 44 opens another plain Markdown prompt example for accessibility testing. It is documentation text, not command execution syntax."
      },
      {
        "id": "external_commands:SKILL.md:46:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "Line 46 closes the prompt example for keyboard and screen reader testing. No shell, Ruby, or subprocess behavior is present."
      },
      {
        "id": "external_commands:SKILL.md:50:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "Line 50 opens a Markdown prompt example about color contrast review. The fenced content is inert documentation, not executable code."
      },
      {
        "id": "external_commands:SKILL.md:52:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "Line 52 closes the color contrast prompt example. The surrounding section contains WCAG explanatory text and no command execution mechanism."
      },
      {
        "id": "external_commands:SKILL.md:88:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "Line 88 starts a fenced markdown output example for an accessibility audit report. It documents expected prose output rather than executing commands."
      },
      {
        "id": "external_commands:SKILL.md:97:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "Line 97 starts an HTML example showing before and after image markup. Static analysis mistook the fence marker for backtick execution."
      },
      {
        "id": "external_commands:SKILL.md:103:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "Line 103 closes the HTML example block. It contains only Markdown formatting and does not invoke an interpreter or external process."
      },
      {
        "id": "external_commands:SKILL.md:111:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "Line 111 starts an HTML form accessibility example. The block is documentation for labels and ARIA attributes, not executable shell content."
      },
      {
        "id": "external_commands:SKILL.md:118:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "Line 118 closes the HTML form example. The cited backticks are a Markdown fence with no command execution behavior."
      }
    ],
    "semantic_findings": [],
    "critical_findings": [],
    "high_findings": [],
    "medium_findings": [],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 1,
    "total_lines": 147,
    "audit_model": "codex",
    "audited_at": "2026-07-05T14:20:04.580Z",
    "agent_auto_install_policy": "allowed",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Audit Web Accessibility for WCAG Compliance",
    "value_statement": "Accessibility gaps can block users and create compliance risk. This skill guides WCAG audits, screen reader checks, keyboard testing, and remediation planning.",
    "seo_keywords": [
      "Claude",
      "Codex",
      "Claude Code",
      "web accessibility",
      "WCAG audit",
      "screen reader testing",
      "keyboard navigation",
      "color contrast",
      "inclusive design",
      "ARIA review"
    ],
    "actual_capabilities": [
      "Assess WCAG 2.1 and 2.2 conformance levels for web pages.",
      "Review semantic HTML, headings, landmarks, and ARIA usage.",
      "Check keyboard navigation paths, focus order, and focus visibility.",
      "Identify color contrast issues against Level AA and AAA targets.",
      "Evaluate image text alternatives, form labels, and error messaging.",
      "Produce prioritized accessibility fixes with clear user impact."
    ],
    "limitations": [
      "Does not run automated browser tests unless the host agent provides tools.",
      "Cannot verify screen reader output without access to assistive technology.",
      "Requires page source, screenshots, or a live site for precise findings.",
      "WCAG interpretations may need legal or organizational review for formal compliance."
    ],
    "use_cases": [
      {
        "title": "Audit a Release Candidate",
        "description": "Review key pages before launch and list WCAG issues by severity and user impact.",
        "target_user": "Frontend developer"
      },
      {
        "title": "Improve Inclusive Interaction Design",
        "description": "Check focus states, keyboard flows, labels, and contrast before design handoff.",
        "target_user": "Product designer"
      },
      {
        "title": "Prepare Compliance Evidence",
        "description": "Create a structured issue summary for accessibility tracking and stakeholder review.",
        "target_user": "Product manager"
      }
    ],
    "prompt_templates": [
      {
        "title": "Quick WCAG Check",
        "scenario": "Beginner page review",
        "prompt": "Audit this page for WCAG 2.2 Level AA issues. Focus on headings, links, images, forms, and color contrast."
      },
      {
        "title": "Keyboard Navigation Review",
        "scenario": "Intermediate interaction testing",
        "prompt": "Review this flow for keyboard accessibility. Check tab order, focus visibility, skip links, traps, and operable controls."
      },
      {
        "title": "Component Remediation Plan",
        "scenario": "Advanced component repair",
        "prompt": "Analyze this component for accessibility issues. Provide prioritized fixes for semantics, ARIA, focus management, and error messaging."
      },
      {
        "title": "Full Release Audit",
        "scenario": "Advanced release readiness",
        "prompt": "Perform a WCAG 2.2 audit for these screens. Group findings by severity, criterion, affected users, and recommended remediation."
      }
    ],
    "output_examples": [
      {
        "input": "Audit a product homepage for WCAG Level AA.",
        "output": [
          "Critical: The hero image needs meaningful alternative text.",
          "High: The newsletter field needs a visible label and clear error text.",
          "Medium: Button text contrast should be increased to meet Level AA."
        ]
      },
      {
        "input": "Review keyboard navigation for a checkout flow.",
        "output": [
          "The focus order should follow the visual order from cart summary to payment.",
          "The modal needs a reliable escape path and focus return behavior.",
          "Disabled controls need clear status text for keyboard and screen reader users."
        ]
      },
      {
        "input": "Improve accessibility for a form component.",
        "output": [
          "Add persistent labels for every input.",
          "Connect errors to the related fields in the accessibility tree.",
          "Use clear instructions before validation, not only after failure."
        ]
      }
    ],
    "best_practices": [
      "Provide the page URL, affected components, and target WCAG level before requesting an audit.",
      "Include screenshots or source snippets when visual contrast or semantic structure matters.",
      "Validate recommendations with keyboard testing and assistive technology when possible."
    ],
    "anti_patterns": [
      "Do not rely only on automated scores for accessibility approval.",
      "Do not add ARIA when native HTML already provides the correct semantics.",
      "Do not treat color alone as the only way to communicate state or errors."
    ],
    "faq": [
      {
        "question": "Which WCAG versions does this skill cover?",
        "answer": "It focuses on WCAG 2.1 and 2.2, including Level A, AA, and AAA considerations."
      },
      {
        "question": "Can it replace a full accessibility audit?",
        "answer": "No. It supports review and remediation, but formal audits may require specialist testing and organizational signoff."
      },
      {
        "question": "Does it test with real screen readers?",
        "answer": "Only when the host environment provides access. Otherwise, it reviews semantics and expected screen reader behavior."
      },
      {
        "question": "Can it review designs before code exists?",
        "answer": "Yes. It can review labels, contrast, focus expectations, content structure, and interaction requirements from design materials."
      },
      {
        "question": "What inputs improve the results?",
        "answer": "Provide URLs, screenshots, HTML snippets, component names, user flows, and the required WCAG conformance level."
      },
      {
        "question": "Does it provide remediation guidance?",
        "answer": "Yes. It explains accessibility issues and suggests practical fixes with priority and user impact."
      }
    ]
  },
  "file_structure": [
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 147
    }
  ]
}
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall