Skip to content

notque/vexjoy-agent / skills/content/content

content

Unverified

Content operations: editorial calendar, marketing, publishing, social media management.

FileKindSize
SKILL.mdskill md11.5 KB
references/at-protocol-api.mdmarkdown7.6 KB
references/at-protocol-preferred-patterns.mdmarkdown8.5 KB
references/batch-edit-examples.mdmarkdown6.9 KB
references/batch-edit-operation-types.mdmarkdown7.0 KB
references/batch-edit-regex-patterns.mdmarkdown5.4 KB
references/batch-edit-safety-checklist.mdmarkdown6.0 KB
references/batch-edit.mdmarkdown9.9 KB
references/calendar-format.mdmarkdown3.5 KB
references/campaign-planning.mdmarkdown17.5 KB
references/classification-prompt.mdmarkdown5.9 KB
references/content-engine.mdmarkdown8.7 KB
references/content-engine/error-handling.mdmarkdown7.8 KB
references/content-engine/phase-playbook.mdmarkdown8.3 KB
references/content-engine/platform-specs.mdmarkdown10.9 KB
references/content-strategy.mdmarkdown14.5 KB
references/email-sequences.mdmarkdown15.8 KB
references/error-handling.mdmarkdown8.2 KB
references/headlines.mdmarkdown5.9 KB
references/image-audit-alt-text-examples.mdmarkdown6.8 KB
references/image-audit-format-selection.mdmarkdown5.8 KB
references/image-audit-report-templates.mdmarkdown3.8 KB
references/image-audit-size-guidelines.mdmarkdown4.2 KB
references/image-audit.mdmarkdown10.4 KB
references/link-audit-false-positives.mdmarkdown4.1 KB
references/link-audit-fix-strategies.mdmarkdown7.1 KB
references/link-audit-graph-metrics.mdmarkdown5.0 KB
references/link-audit.mdmarkdown7.8 KB
references/llm-marketing-failure-modes.mdmarkdown18.7 KB
references/marketing.mdmarkdown20.4 KB
references/metrics.mdmarkdown7.4 KB
references/news-collection.mdmarkdown5.2 KB
references/operations.mdmarkdown5.8 KB
references/outline-examples.mdmarkdown11.2 KB
references/outline-structure-templates.mdmarkdown6.4 KB
references/outline.mdmarkdown8.9 KB
references/pagespeed-insights.mdmarkdown10.4 KB
references/pipeline-stages.mdmarkdown3.3 KB
references/pre-publish-checklist.mdmarkdown7.4 KB
references/pre-publish-hugo-frontmatter.mdmarkdown5.3 KB
references/pre-publish-seo-guidelines.mdmarkdown4.1 KB
references/pre-publish.mdmarkdown10.8 KB
references/reddit-moderate.mdmarkdown7.9 KB
references/script-commands.mdmarkdown3.7 KB
references/seo-audit.mdmarkdown16.4 KB
references/seo-guidelines.mdmarkdown5.5 KB
references/seo-keyword-placement.mdmarkdown6.0 KB
references/seo-title-patterns.mdmarkdown5.6 KB
references/seo.mdmarkdown8.9 KB
references/series-planner.mdmarkdown11.7 KB
references/series-planner/cadence-guidelines.mdmarkdown6.8 KB
references/series-planner/cross-linking.mdmarkdown7.2 KB
references/series-planner/output-format.mdmarkdown3.8 KB
references/series-planner/series-types.mdmarkdown7.6 KB
references/taxonomy-audit-report-format.mdmarkdown3.2 KB
references/taxonomy-consolidation-rules.mdmarkdown6.7 KB
references/taxonomy-examples.mdmarkdown9.7 KB
references/taxonomy-guidelines.mdmarkdown5.5 KB
references/taxonomy.mdmarkdown9.0 KB
references/topic-brainstormer.mdmarkdown10.1 KB
references/topic-brainstormer/content-filter.mdmarkdown7.1 KB
references/topic-brainstormer/priority-scoring.mdmarkdown8.1 KB
references/topic-brainstormer/topic-sources.mdmarkdown7.6 KB
references/wordpress-upload.mdmarkdown11.2 KB
references/x-api.mdmarkdown7.8 KB
scripts/publish/link_scanner.pyscript21.4 KB
scripts/publish/pagespeed.pyscript15.3 KB
scripts/publish/tests/test_load_env_file.pyscript3.8 KB
scripts/publish/tests/test_wordpress_inline_urls.pyscript4.4 KB
scripts/publish/tests/test_wordpress_media_upload.pyscript1.5 KB
scripts/publish/tests/test_wordpress_scraper.pyscript4.1 KB
scripts/publish/wordpress-edit-post.pyscript21.2 KB
scripts/publish/wordpress-media-upload.pyscript8.7 KB
scripts/publish/wordpress-scraper.pyscript23.4 KB
scripts/publish/wordpress-upload.pyscript44.2 KB
scripts/reddit-moderate/reddit-automod-cron.shscript3.9 KB
scripts/reddit-moderate/reddit-mod.pyscript83.0 KB
scripts/reddit-moderate/tests/test_reddit_mod.pyscript31.3 KB

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 -->
![](/images/screenshot.png)

<!-- Empty alt text -->
![](images/diagram.png)
```

**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
![image](/images/arch.png)
![screenshot](/images/terminal.png)
![diagram](/images/flow.svg)
![x](/images/icon.svg)
```

---

### PASS: Descriptive and Contextual

Good alt text describes the image content and provides context:

**Example 1: Screenshot**
```markdown
<!-- Bad -->
![screenshot](/images/terminal.png)

<!-- Good -->
![Terminal showing successful npm install with 0 vulnerabilities](/images/terminal.png)
```

**Example 2: Diagram**
```markdown
<!-- Bad -->
![diagram](/images/architecture.svg)

<!-- Good -->
![Three-tier architecture: React frontend, Node.js API, PostgreSQL database](/images/architecture.svg)
```

**Example 3: Photo**
```markdown
<!-- Bad -->
![photo](/images/team.jpg)

<!-- Good -->
![Development team collaborating around a whiteboard with system diagrams](/images/team.jpg)
```

---

## Alt Text by Image Type

### Screenshots

Describe what the screenshot demonstrates:

```markdown
<!-- Terminal/Command Line -->
![Git log showing three recent commits on the main branch](/images/git-log.png)

<!-- Application UI -->
![Settings panel with dark mode toggle enabled](/images/settings.png)

<!-- Error Messages -->
![TypeScript error TS2345: Argument of type string not assignable to number](/images/error.png)

<!-- Code Editor -->
![VS Code with Go file open showing syntax highlighting](/images/vscode.png)
```

### Diagrams

Summarize what the diagram illustrates:

```markdown
<!-- Flowcharts -->
![Request flow: user sends request to load balancer, which routes to one of three API servers](/images/flow.svg)

<!-- Architecture -->
![Microservices architecture with API gateway connecting to auth, users, and billing services](/images/microservices.svg)

<!-- Sequence Diagrams -->
![OAuth flow: client requests token, server validates, returns access token](/images/oauth-sequence.svg)

<!-- Charts -->
![Bar chart showing response times: Go 12ms, Rust 8ms, Python 45ms](/images/benchmark.png)
```

### Icons and Logos

Keep brief but specific:

```markdown
<!-- Company/Project Logos -->
![Kubernetes logo](/images/k8s-logo.svg)
![GitHub Octocat mascot](/images/github.svg)

<!-- UI Icons -->
![Search magnifying glass icon](/images/search.svg)
![Warning triangle icon](/images/warning.svg)
```

### Photos

Describe the scene and context:

```markdown
<!-- People -->
![Speaker presenting slides about API design at tech conference](/images/conference.jpg)

<!-- Products -->
![MacBook Pro with terminal window showing code](/images/laptop.jpg)

<!-- Abstract/Decorative -->
![Colorful gradient background for hero section](/images/hero-bg.jpg)
```

---

## 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
![](/images/decorative-divider.svg)
```

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
![System architecture overview - see detailed description below](/images/complex-arch.svg)

**Figure 1:** The system consists of three main components...
```

### Charts and Graphs

Include key data points in alt text:

```markdown
![Line graph showing memory usage increasing from 2GB to 8GB over 24 hours, with spike at 3PM](/images/memory.png)
```

### Code Screenshots

Mention the language and key content:

```markdown
![Python function definition for calculate_tax that takes income parameter and returns tax amount](/images/code.png)
```

---

## 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
![Terminal showing npm install express command and output](/images/npm-install.png)
![Code editor with server.js file containing Express route handlers](/images/express-code.png)
![Browser showing "Hello World" response at localhost:3000](/images/browser-output.png)
```

### Comparison Post

```markdown
![Side-by-side comparison: vim on left with modal editing, VS Code on right with GUI](/images/editors-comparison.png)
![Performance chart: vim uses 5MB RAM, VS Code uses 250MB RAM](/images/memory-usage.png)
```

### Debugging Post

```markdown
![Error message: ECONNREFUSED 127.0.0.1:5432 in terminal](/images/error.png)
![PostgreSQL service status showing inactive state](/images/pg-status.png)
![Successful database connection after starting PostgreSQL](/images/fixed.png)
```

### Architecture Post

```markdown
![High-level system diagram with frontend, API layer, and database](/images/architecture.svg)
![Detailed view of API layer showing authentication middleware](/images/api-detail.svg)
![Database schema with users, posts, and comments tables](/images/schema.svg)
```
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall