write-alt-text

To generate accessible alt text for ggplot2 charts, the Skill analyzes your R plotting source code and surrounding figure context. It interprets axis variables, geoms, transformations, and faceting structures to compose screen-reader-friendly descriptions for QMD documents.

Writing alt text that complements the figure caption (fig-cap) requires analyzing chart code to extract specific encodings and geoms. This Skill produces non-redundant descriptions by interpreting the plotting source directly, ensuring the alt text adds specific visual context rather than repeating the caption.

Yes, you can use this to describe complex ggplot2 charts for screen readers. It specifically handles facets, overlays, and color encodings by reading the available R code, identifying the chart structure, and generating accurate alt text tailored to those specific visual variables.

Analyzing plotting source code improves alt text by using the available ggplot2 commands to identify exact axes, variables, and chart types. This code-informed understanding ensures the generated descriptions are specific to the visual encoding rather than generic placeholder text.

You do not need to manually find figure chunks first. The Skill includes a figure discovery workflow that helps you locate figure chunks, read the surrounding context and code, and generate consistent alt text across multiple plots in your QMD documents automatically.

Generating alt text from ggplot2 source code is limited by the availability of the plotting code and surrounding context. It requires interpreting axis variables, chart geoms, transformations, and faceting structure from the R/QMD document, meaning charts lacking accessible source code cannot be accurately described.