CONTENT CREATION

Auto-fill alt-text for screenshots in docs pull requests

When a docs pull request adds screenshot images, generates localized alt-text for each, commits it into the referencing Markdown, and comments a coverage report on the PR.

CategoryContent Creation
Enginesim
Difficultyadvanced
Triggerevent
Steps6
Setup~25 min

How it runs

The automated pipeline, trigger to output.

  • TriggerDocs PR adds screenshot imagesGitHubGitHub
  • ActionFetch added images and referencing MarkdownGitHubGitHub
  • LogicSkip images that already have alt-text
  • ActionGenerate localized alt-text per imageOpenAI
  • ActionCommit alt-text into files on PR branchGitHubGitHub
  • OutputComment coverage report on the PRGitHubGitHub

What it does

Scans documentation pull requests for newly added screenshot images, generates accessibility alt-text in your default and translated locales, and writes that alt-text into the Markdown or MDX that references each image. It then posts a comment on the PR summarizing which images were described and flags any it couldn't read.

When to use it

Use it on docs and help-center repos where contributors paste screenshots without alt-text and reviewers keep catching it. It enforces accessibility coverage as a PR step so localized docs ship compliant without a manual editorial pass.

How it works

  1. 1A pull request touching image files in the docs repo triggers the flow.
  2. 2The flow fetches the added screenshots and the Markdown that references them from GitHub.
  3. 3A logic step skips images that already have non-empty alt-text.
  4. 4OpenAI reads each image and produces alt-text in the default and target locales.
  5. 5The flow commits the updated alt-text into the referencing files on the PR branch.
  6. 6A coverage comment listing described and skipped images is posted to the pull request.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect GitHubRepos, issues, pull requests, actions.
  2. 2
    Connect OpenAIModels, embeddings, files.
  3. 3
    Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
  4. 4
    Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
  5. 5
    Test, then turn it onRun once against a sample, confirm the output, then enable the trigger.

Run this workflow in your colony.

14-day trial. No DevOps. No Sales call. Provisioned in under a minute.