alt-text SKILL.md skillA

alt-text from posit-dev/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add posit-dev/skills/alt-text@v1.0

Pins v1.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
posit-dev/skills
Path
alt-text/SKILL.md
Versions recorded
1
Latest version
v1.0, committed Apr 28, 2026
Size
6,862 bytes
Repository stars
552
License
MIT

Generate and improve accessible alt text for data visualizations and images in R packages and Quarto documents. Use when the user wants to add, improve, or audit alt text for figures in a pkgdown site or .qmd files. Activate for requests that mention fig-alt, fig.alt, figure descriptions, or alt text in the context of an R package or Quarto document.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Write Accessible Alt Text

Generate accessible alt text for data visualizations and images in this project.

ARGUMENTS
- label: (optional) specific figure label or chunk to target
- file: (optional) specific file to process

## Detect project type

Before proceeding, identify the project context and read the relevant reference.
Check for a `_pkgdown.yml` file in the project root to detect a pkgdown site:

```bash
ls _pkgdown.yml 2>/dev/null && echo "pkgdown" || echo "not pkgdown"
```

- **pkgdown site** (`_pkgdown.yml` present) → read `references/pkgdown.md`
- **Quarto documents** (no `_pkgdown.yml`, `.qmd` files present) → read `references/quarto.md`

If the context is still ambiguous, ask the user which format they are working in.

## Key advantage: source code access

Unlike typical alt text scenarios where you only see an image, **we have access to the code that generates each chart**. Use this to extract precise details:

**From plotting code:**
- Variable mappings → exact variable names for axes
- Color/fill mappings → what color encodes
- Plot type functions → scatter, histogram, line chart, etc.
- Trend lines or fitted curves → overlaid statistical fits
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add posit-dev/skills/alt-text@sha256:0d33621f007e3d2a

The line at the top of this page pins the label v1.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_yusxtkcjo3ld5dmm.svg)](https://markdownregistry.com/a/art_yusxtkcjo3ld5dmm)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Apr 28, 2026.

versioncommittedcommitsizeaudit
v1.0 latest2026-04-28 030f607 6,862 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6862 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

posit-dev/skills · 552 stars · license MIT · pushed 2026-11-02 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_yusxtkcjo3ld5dmm
GET https://markdownregistry.com/api/v1/resolve?ref=posit-dev/skills/alt-text
GET https://markdownregistry.com/api/v1/blob/0d33621f007e3d2adae1264cf9caf93d406635a106373e4995d629066e511d37

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from posit-dev/skills

AGENTS.md AGENTS.md file
posit-dev/skills · AGENTS.md
git:20261007.4d770f9 · audit A · 552 stars
brand-yml SKILL.md skill
posit-dev/skills · brand-yml/SKILL.md · Create and use brand.yml files for consistent branding across Shiny apps and Quarto documents. Covers: (1) Creating new…
v1.1 · audit A · 552 stars
deploy-to-connect SKILL.md skill
posit-dev/skills · connect/deploy-to-connect/SKILL.md · Deploy or publish Python and R content to a Posit Connect server using rsconnect-python or the R rsconnect package…
v4.0 · audit A · 552 stars
ggsql SKILL.md skill
posit-dev/skills · ggsql/ggsql/SKILL.md · Write ggsql queries — a grammar of graphics for SQL. Use when the user wants to create, modify, or understand a ggsql…
v1.1 · audit A · 552 stars
pr-create SKILL.md skill
posit-dev/skills · github/pr-create/SKILL.md · Creates a pull request from current changes, monitors GitHub CI, and debugs any failures until CI passes. Activate when…
v1.5 · audit A · 552 stars
pr-threads-address SKILL.md skill
posit-dev/skills · github/pr-threads-address/SKILL.md · Address PR review feedback by systematically working through every unresolved PR review thread on the current branch's…
v1.0 · audit A · 552 stars
pr-threads-resolve SKILL.md skill
posit-dev/skills · github/pr-threads-resolve/SKILL.md · Bulk resolve unresolved PR review threads on the current branch’s PR — typically after threads have been addressed…
v1.0 · audit A · 552 stars
create-release-checklist SKILL.md skill
posit-dev/skills · open-source/create-release-checklist/SKILL.md · Create a release checklist and GitHub issue for an R package. Use when the user asks to "create a release checklist" or…
v1.0 · audit A · 552 stars
maintainer-decline SKILL.md skill
posit-dev/skills · open-source/maintainer-decline/SKILL.md · Guide for drafting issue closure and decline responses as an open-source package maintainer. Use when helping compose a…
git:20260521.928d934 · audit A · 552 stars
release-post SKILL.md skill
posit-dev/skills · open-source/release-post/SKILL.md · Create professional package release blog posts following Tidyverse or Shiny blog conventions. Use when the user needs…
v1.0 · audit A · 552 stars
critical-code-reviewer SKILL.md skill
posit-dev/skills · posit-dev/critical-code-reviewer/SKILL.md · Rigorously review code or pull requests for correctness, security, accessibility, maintainability, tests, and edge…
v1.2 · audit A · 552 stars
describe-design SKILL.md skill
posit-dev/skills · posit-dev/describe-design/SKILL.md · Research a codebase and create architectural documentation describing how features or systems work. Use when the user…
v1.1 · audit A · 552 stars

Every file in posit-dev/skills

Other files named alt-text

alt-text SKILL.md skill
thedaviddias/front-end-checklist · skills/alt-text/SKILL.md · Use when reviewing image assets, markup, and CDN or build transforms related to Provide meaningful alt text for images…
git:20261004.4b0ddb9 · audit A · 74,643 stars
alt-text SKILL.md skill
marioluciofjr/skills · alt-text/SKILL.md · Gera um alt text (texto alternativo) otimizado para imagens em blogposts, artigos e redes sociais (como LinkedIn). Use…
git:20260327.b1b8dbc · audit A · 17 stars
alt-text SKILL.md skill
ahgraber/skills · skills/alt-text/SKILL.md · Use when the user shares an image, chart, diagram, screenshot, or figure and needs it described — for alt-text…
git:20260819.209d97b · audit A · 6 stars

Browse by kind, by grade A, or by owner.