quarto-alt-text

Generate accessible alt text for data visualizations in Quarto documents.

1|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/nq-rdl/agent-extensions --skill quarto-alt-text
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: quarto-alt-text
Source: https://github.com/nq-rdl/agent-extensions/tree/main/skills/quarto-alt-text
Command: npx skills add https://github.com/nq-rdl/agent-extensions --skill quarto-alt-text

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generate accessible alt text for data visualizations in Quarto documents to help readers who rely on screen readers understand charts and figures.

Core Features & Use Cases

  • Generate alt text that describes chart type, axes, data mappings, color encodings, and panel structure.
  • Adapt alt text for single figures and multi-panel faceted visuals across multiple .qmd files.
  • Use case: a technical writer adds alt text for a set of charts in a quarterly report to improve accessibility.

Quick Start

Generate accessible alt text for the primary chart in a Quarto document by describing its type, axes, data mappings, panel structure, and the key insight.

Frequently Asked Questions about quarto-alt-text

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

FAQPage Schema
How do I generate accessible alt text for data visualizations in Quarto?

To generate accessible alt text for Quarto data visualizations, you automate text generation across .qmd files. This produces screen-reader friendly descriptions referencing chart type, axis labels, data mappings, color encodings, and panel structure for single and faceted visuals.

What should alt text for charts include to be screen-reader friendly?

Screen-reader friendly alt text for charts should include the chart type, axis labels, data mappings, color encodings, and panel structure. For multi-panel faceted visuals, the text must also describe the panel layout to convey the complete visual context.

Can I apply automated alt text generation to multi-panel faceted visuals in .qmd files?

Yes, you can apply automated alt text generation to multi-panel faceted visuals across multiple .qmd files. The process adapts the descriptive text to capture the panel structure, ensuring screen readers accurately interpret complex multi-figure layouts.

Does Quarto alt text generation work for both single figures and faceted charts?

Quarto alt text generation works for both single figures and faceted charts across .qmd documents. It adapts the descriptive output to reference the specific chart type, data mappings, and panel structure, ensuring accurate accessibility coverage for either format.

What is the best way to add chart descriptions to Quarto documents for accessibility?

The best way to add chart descriptions to Quarto documents for accessibility is automating the generation of descriptive alt text. This directly references axes, color encodings, and data mappings, ensuring technical reports remain screen-reader friendly without manual effort.

Why does my Quarto chart need descriptive text referencing color encodings and axes?

Your Quarto chart needs descriptive text referencing color encodings and axes because screen readers cannot interpret visual data. Referencing these visual encodings in alt text translates the graphical data mappings into an accessible textual format for visually impaired readers.