Your store URL, a product URL, or your product export CSV.
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.
| Photo | Before | After |
|---|---|---|
| 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

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
- Unzip the free download. It holds the free skill folders, including
shopify-alt-text-writer, ready-made zips for claude.ai in aclaude-aifolder, and a README. Or copy the folder from GitHub. - Put the
shopify-alt-text-writerfolder where your assistant looks for skills. The generic path is.agents/skills/(ornpx skills addfrom 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-aifolder 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
- Claude Code:
- Ask for the job in plain words. The skill loads by itself.
Get it
MIT licence. Use it, change it, share it.
Related
- Free paste-in prompt for any chatbot: Product image alt text prompt for ChatGPT or Claude
- Product Title Cleaner (Free): One consistent title pattern across the catalogue, as an import CSV of changed rows only.
- Review Reply Drafter (Free): A reply for every review, matched to its tone, with the risky ones flagged for you.
- Store Ops Pack ($29): Six skills for the Shopify jobs that eat the week, in one download.
- More for Shopify store owners: Shopify store owners
Report a problem with this skill (GitHub, or write to kaiventura.founder@gmail.com).