All skills / Shopify store owners

Alt Text Writer

Alt text for every product image, written while looking at the photo, as an import CSV.

The download is the free bundle on Gumroad (pay what you want, from $0), which holds a selection of the free skills. All of them are on GitHub under the MIT licence.

What you give it

Your store URL, a product URL, or your product export CSV.

What you get

Alt text for every product image, written while looking at the photo. Comes as a Shopify import CSV, a review sheet, and a paste-by-hand list for products with variant images.

Before and after

Real tests, 2026-10-03; store and product names removed. Taken from the skill's README.

PhotoBeforeAfter
Flip flop, back (a large DTC footwear brand)(empty)Back of the dusty pink women's flip flop with the brand logo embossed on the heel
Flip flop, sole (same store)(empty)Sole of the dusty pink women's flip flop, with a pattern of concentric oval grooves
Lip stain how-to (a cosmetics brand)(empty)Peel-off lip stain how-to on a model's lips: 1 line with the stain, 2 peel it off, 3 shine with gloss

We checked each "after" against the actual photo.

See it run

Animated demo of Alt Text Writer on a real example: the input goes in and the finished result appears. The still shows the final result.

What it does

A free Agent Skill that writes alt text for your Shopify product images. It looks at each photo and describes what's actually in it: the angle, the detail, the colour, the model. Then it gives you a CSV you can import into Shopify.

Give it a store URL, a product URL, or your product export CSV (Products > Export). That's all it needs.

How it was tested

Tested on 6 real cases from public Shopify stores, including three product export CSVs. Final scores: 10, 10, 9, 10, 9 and 10 out of 10.

The tests ran on real public data, never made-up cases, and were scored against a written rubric. A skill in this range ships only when every test scores 8/10 or more.

How we test, what we do not do, and which assistants we ran it on.

Limits

  • It describes what it can see and what your product data says. It won't invent materials or features.
  • Importing alt text by CSV re-imports your images. Test on one product first. For products with variant images (the photo changes per colour), paste the alt text by hand. The skill lists those products for you.

Works with

Works with any assistant that reads SKILL.md skills (Claude, Codex, Gemini CLI, Cursor and others), plus a paste-in prompt version for ChatGPT or any chatbot. We run our release tests on Claude Sonnet and Opus. Use your assistant's strongest model: in our tests, a small, fast model added facts that were not in the source data. The helper scripts need Python 3 (standard library only). Reading a live store needs web access; otherwise attach your product export CSV.

Install

  1. Unzip the free download. It holds the free skill folders, including shopify-alt-text-writer, ready-made zips for claude.ai in a claude-ai folder, and a README. Or copy the folder from GitHub.
  2. Put the shopify-alt-text-writer folder where your assistant looks for skills. The generic path is .agents/skills/ (or npx skills add from a folder). Tool-specific paths:
    • Claude Code: ~/.claude/skills/ (or .claude/skills/ inside one project)
    • OpenAI Codex, Gemini CLI, Cursor and others: .agents/skills/ or the skills folder their docs name
    • claude.ai: Customize, Skills, then the plus button, Create skill, Upload a skill, and upload the zip from the claude-ai folder without unzipping it (code execution must be on in Settings, Capabilities)
    • ChatGPT or any chatbot: open the skill's prompt.md, paste it into the chat, then paste your own text or link
    • Steps for each tool, with links to its official docs: how to install Agent Skills
  3. Ask for the job in plain words. The skill loads by itself.

Get it

MIT licence. Use it, change it, share it.

Related

Report a problem with this skill (GitHub, or write to kaiventura.founder@gmail.com).