a11y-issue-writer

Convert axe-core violations into standardized Jira-ready issue reports.

1|Updated Dec 17, 2025
One-click install
npx skills add https://github.com/joe-watkins/a11y-devkit --skill a11y-issue-writer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: a11y-issue-writer
Source: https://github.com/joe-watkins/a11y-devkit/tree/main/packages/a11y-issue-writer
Command: npx skills add https://github.com/joe-watkins/a11y-devkit --skill a11y-issue-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill converts axe-core violations into standardized, Jira-ready issue reports using the accessibility-issues-template-mcp, enabling consistent triage and remediation workflows across projects.

Core Features & Use Cases

  • Template-driven formatting: Transform axe-core violations into Jira-ready issues using the accessibility-issues-template-mcp.
  • Validation & guidance: Validate formatted issues for completeness and include essential fields (title, description, steps, evidence) for efficient triage.
  • Integration-ready: Works with MCP-backed reference data to enrich issues and supports automated or manual formatting from test results.
  • Use Case: A testing suite reports 15 violations; automatically generate a standardized Jira issue for each to streamline developer assignment.

Quick Start

Use the a11y-issue-writer to format axe-core violations into Jira-ready issues using the accessible templates and MCP server.

Frequently Asked Questions about a11y-issue-writer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I format axe-core violations into Jira issues?

Formatting axe-core violations into Jira issues involves converting automated test results into standardized reports with essential fields like title, description, steps, and evidence for efficient triage.

What is the best way to convert automated accessibility test results into standardized Jira reports?

Converting accessibility test results into standardized Jira reports is done using template-driven formatting that validates issues for completeness, ensuring consistent triage and remediation workflows across projects.

Do I need the accessibility-issues-template-mcp server to generate Jira-ready accessibility issues?

Yes, generating and validating Jira-ready accessibility issues requires the accessibility-issues-template-mcp server, which provides helper tools like format_axe_violation and validate_issue to ensure proper formatting.

Can I manually format accessibility violations for Jira or does it only work with automated test results?

Formatting manually collected accessibility violations is supported alongside automated test results, enabling consistent triage and remediation across projects regardless of how the violations were identified.

What fields are included in a standardized Jira issue generated from axe-core violations?

Standardized Jira issues generated from axe-core violations include essential fields such as title, description, steps, and evidence, which are validated for completeness to support efficient triage and developer assignment.