alt-text

Generate accessibility-focused alt text for social media images.

3|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/pedropaulovc/agent-plugins --skill alt-text-pedropaulovc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: alt-text
Source: https://github.com/pedropaulovc/agent-plugins/tree/main/plugins/alt-text/skills/alt-text
Command: npx skills add https://github.com/pedropaulovc/agent-plugins --skill alt-text-pedropaulovc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps people generate accurate, accessibility-focused alt text for social media images so screen reader users get the image’s actual point, including any visible text, within practical platform length limits.

Core Features & Use Cases

  • Accessibility-first alt text: Produces descriptive alt text that avoids filler like “image of” and focuses on what the post would lose if the image disappeared.
  • Visible text transcription: Transcribes on-image text such as memes, screenshots, chart labels, handles, and captions.
  • Platform-aware length guidance: Adapts verbosity for common character limits (e.g., X/Twitter ~1,000; LinkedIn ~120; Bluesky ~2,000; Mastodon ~1,500).
  • Person-description guardrails: Avoids guessing identity attributes and distinguishes observable details (like expression and pose) from inferences (like emotion).

Quick Start

Use the alt-text skill to write alt text for the image you are about to post on X by mentioning the platform and attaching the image.

Frequently Asked Questions about alt-text

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

FAQPage Schema
How do I write accessible alt text for social media images?

Accessible alt text translates an image's meaningful content into screen-reader-friendly prose, transcribes visible text, and focuses on what a post loses if the image disappears while avoiding filler. It ensures screen reader users grasp the image's actual point within platform length limits.

What is the character limit for alt text on platforms like X, LinkedIn, and Mastodon?

Alt text character limits vary by platform: X allows approximately 1,000 characters, LinkedIn around 120, Mastodon up to 1,500, and Bluesky roughly 2,000. Platform-aware generation adapts verbosity to fit these specific constraints.

How do I transcribe text inside memes and screenshots for screen readers?

Transcribing text inside memes and screenshots involves extracting on-image text such as labels, handles, and captions into screen-reader-friendly prose. The transcription captures visible text so screen reader users understand the visual context and meaning.

Can I use automated image description tools for charts and multi-panel images?

Automated image description tools can process charts and multi-panel images by translating their meaningful content into accessible prose. They transcribe chart labels and visible text, focusing on the core information conveyed by the visual elements.

Should I describe a person's emotions when writing accessible image descriptions?

When writing accessible image descriptions, avoid guessing identity attributes and inferring emotions. Distinguish observable details like facial expression and pose from subjective inferences to ensure accurate, respectful, and unbiased alt text generation.

What are the limitations of automated alt text generation for complex social media posts?

Automated alt text generation for complex posts requires focusing on core meaningful content to fit platform character constraints. It avoids hedging and identity guessing, but may face limitations in fully capturing nuanced context if the image relies on highly implicit visual cues.