notque/vexjoy-agent / skills/content/content
content
UnverifiedContent operations: editorial calendar, marketing, publishing, social media management.
references/image-audit-alt-text-examples.md
View on GitHub# Alt Text Examples
Reference for writing accessible, descriptive alt text for images.
---
## Purpose of Alt Text
Alt text serves three critical functions:
1. **Accessibility**: Screen readers announce alt text for visually impaired users
2. **Fallback**: Displays when images fail to load
3. **SEO**: Search engines use alt text to understand image content
---
## Alt Text Quality Levels
### FAIL: Missing or Empty
```markdown
<!-- Missing alt attribute -->

<!-- Empty alt text -->

```
**Impact:** Screen readers skip or announce only "image", providing no context.
---
### WARN: Too Generic
These patterns trigger warnings because they provide minimal value:
| Generic Term | Why It's Bad |
|--------------|--------------|
| "image" | States the obvious |
| "picture" | States the obvious |
| "photo" | Doesn't describe content |
| "screenshot" | What's in the screenshot? |
| "diagram" | What does the diagram show? |
| "figure" | Not descriptive |
| "img" | Meaningless |
| Single character | Not useful |
**Examples of generic alt text:**
```markdown




```
---
### PASS: Descriptive and Contextual
Good alt text describes the image content and provides context:
**Example 1: Screenshot**
```markdown
<!-- Bad -->

<!-- Good -->

```
**Example 2: Diagram**
```markdown
<!-- Bad -->

<!-- Good -->

```
**Example 3: Photo**
```markdown
<!-- Bad -->

<!-- Good -->

```
---
## Alt Text by Image Type
### Screenshots
Describe what the screenshot demonstrates:
```markdown
<!-- Terminal/Command Line -->

<!-- Application UI -->

<!-- Error Messages -->

<!-- Code Editor -->

```
### Diagrams
Summarize what the diagram illustrates:
```markdown
<!-- Flowcharts -->

<!-- Architecture -->

<!-- Sequence Diagrams -->

<!-- Charts -->

```
### Icons and Logos
Keep brief but specific:
```markdown
<!-- Company/Project Logos -->


<!-- UI Icons -->


```
### Photos
Describe the scene and context:
```markdown
<!-- People -->

<!-- Products -->

<!-- Abstract/Decorative -->

```
---
## Writing Guidelines
### DO
- **Describe the content**: What does the image show?
- **Provide context**: Why is this image here?
- **Be concise**: 10-125 characters is ideal
- **Use natural language**: Write as you'd describe to someone
- **Include relevant text**: If image contains important text, include it
### Common Mistakes
- **Start with "Image of" or "Picture of"**: Redundant
- **Use file names**: "logo-v2-final.png" is not alt text
- **Be overly verbose**: Don't write paragraphs
- **Include "click here"**: Alt text isn't for instructions
- **Repeat caption content**: If caption says it, alt text can be brief
---
## Special Cases
### Decorative Images
If an image is purely decorative with no informational content, use empty alt:
```markdown

```
Or in HTML:
```html
<img src="/images/decorative.svg" alt="" role="presentation">
```
**When to use empty alt:**
- Decorative borders/dividers
- Background patterns
- Bullet point icons (if meaning conveyed elsewhere)
- Purely aesthetic elements
### Complex Diagrams
For complex diagrams, provide a brief alt text and longer description elsewhere:
```markdown

**Figure 1:** The system consists of three main components...
```
### Charts and Graphs
Include key data points in alt text:
```markdown

```
### Code Screenshots
Mention the language and key content:
```markdown

```
---
## Alt Text Checklist
Before considering alt text complete:
- [ ] Does it describe what the image shows?
- [ ] Would someone who can't see the image understand its purpose?
- [ ] Is it concise (under 125 characters if possible)?
- [ ] Does it avoid starting with "Image of" or "Picture of"?
- [ ] Is it not just the filename?
- [ ] Does it provide context for why the image is included?
---
## Examples by Blog Post Type
### Tutorial Post
```markdown



```
### Comparison Post
```markdown


```
### Debugging Post
```markdown



```
### Architecture Post
```markdown



```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |