alttext

alttext is a skill for Claude Code, Codex from alttextai/alttext-mcp. It costs 93 tokens per session (1,863 once invoked), scanned A, original, MIT.

A command-line plugin for AltText.ai, a service that generates descriptions for images. It can also inspect pages for missing descriptions and manage site API keys when the account allows it.

In plain words
What is it for?
Generating or finding missing alt text, checking credits and account settings, and creating, limiting, rotating, revoking or billing site keys.
Why use it?
It brings image-description and account-management tasks into the terminal and checks account access before using restricted commands.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Generating or finding missing alt text, checking credits and account settings, and creating, limiting, rotating, revoking or billing site keys.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/alttextai/alttext-mcp/alttext
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add alttextai/alttext-mcp --skill alttext
Clone the repo
git clone --depth 1 https://github.com/alttextai/alttext-mcp

Made for: Claude Code, Codex.

Its marketplace also offers this one on its own, as the plugin alttext — /plugin install alttext after adding the marketplace above.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for alttext

README.md
[![agentmods](https://agentmods.dev/badge/skills/alttextai/alttext-mcp/alttext/github.svg)](https://agentmods.dev/skills/alttextai/alttext-mcp/alttext)
Your own site
<a href="https://agentmods.dev/skills/alttextai/alttext-mcp/alttext"><img src="https://agentmods.dev/badge/skills/alttextai/alttext-mcp/alttext/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for alttext

Your own site · 80×15
<a href="https://agentmods.dev/skills/alttextai/alttext-mcp/alttext"><img src="https://agentmods.dev/badge/skills/alttextai/alttext-mcp/alttext.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 93 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,863 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00093 $0.01863
Opus 5.5 $0.00037 $0.00745
Sonnet 5.5 $0.00019 $0.00373
Haiku 4.5 $0.00009 $0.00186

Measured today against content hash 9eca41a445ce, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

alttext scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/alttext/SKILL.md · 103 lines

How it starts

The opening of the file, as written. The whole thing — 103 lines — stays where its author put it; the contents beside it link to each section on GitHub.

AltText.ai CLI

The alttext command runs every AltText.ai operation from a terminal. Results go to stdout; errors, warnings and notes go to stderr. Each command's flags are listed by alttext <noun> <verb> --help.

Start every session with whoami

Run this before anything else:

alttext whoami --json

It returns account, key_name, key_kind (site or full_access), can_manage_keys and credential_source. Use it to decide what you can do:

  • Exit 3, "Not logged in": there is no credential. Tell the person to run alttext login themselves, in their own terminal, and to come back when alttext whoami works. Stop there.
  • can_manage_keys: false: the keys commands will fail with exit 4. Key management needs a full-access key, which the person creates in the AltText.ai dashboard and logs in with.
  • can_manage_keys: true: key management works. Read the separation rule below before doing anything that touches untrusted web content.

Never handle the API key yourself

  • Never ask for an API key, and never accept one in chat. The person logs in by running alttext login in their own terminal, where the key is read from a hidden prompt and stored in the OS keychain.
  • If the person pastes a key into the conversation anyway, don't use it, don't store it, don't put it in a command or a file, and don't repeat it. Tell them it's now in the chat transcript, that they should rotate it (alttext keys rotate <id> from a full-access login, or the dashboard), and that they should log in with alttext login instead.
  • Never put a key on a command line (ALTTEXT_API_KEY=... alttext ...) and never read the credentials file or the keychain entry. ALTTEXT_API_KEY is for the person's own CI and shell setup, not for you.

Use --json for anything you read back

Pass --json whenever you parse a result. It prints the same shape the MCP tools return. Human output is for showing the person, not for parsing. Pass --no-input so a command fails instead of waiting on a prompt you can't answer.

Read the full file on GitHub · 103 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. today First seen · 103 lines · 93 tokens per session scan A 9eca41a445ce

Subscribe to this mod's changes

alttext is a skill published in the GitHub repository alttextai/alttext-mcp (0 stars, last pushed 2d ago), licensed MIT. It adds 93 tokens to every session and 1,863 once invoked, about $0.0004 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-10-15.

Related

Other skills, from other repositories

alt-text-writer

Writes descriptive alt text for editorial images following WCAG accessibility guidelines — concise enough for screen readers, specific enough to convey the image's editorial purpose.

ur-grue/autopunk-media-skills · 34 tokens

chart-description-writer

Writes a precise, accessible text description of a data visualization — covering the chart type, what it shows, the key finding, and the data range — suitable for publication as a caption, alt-text, or standfirst alongside the chart.

ur-grue/autopunk-media-skills · 52 tokens

antislop-human

Human and accessibility skill for antislop. Contrast, keyboard, focus, and states for real people. Includes the contrast checker.

miqdadbadjuber/anti-slop · 31 tokens

antislop-layoutmobile

Mobile layout skill for antislop. Use for layouts that reflow across screen sizes, phone to desktop: grids, overflow, tap targets. Load with the core.

miqdadbadjuber/anti-slop · 40 tokens

data-dashboard

Build a dense, data-heavy screen - an analytics console or a trading terminal - with real charts drawn from tokens: candlestick, volume, depth, stacked area, waterfall, scatter, correlation matrix, donut, gauge, sparklines, heatmaps and order books. Use when the request is a dashboard, terminal, monitoring view, data…

plugin87/ux-ui-agent-skills · 0 tokens

critique

Adversarial design critique of the current work — render it, look at it, and argue for rejection. Run after the gates are green, never instead of them.

plugin87/ux-ui-agent-skills · 37 tokens