Skip to content

Etsy description writer: a free Claude Skill

AI descriptions have a smell: "elevate your space", "crafted with love", and a material the item isn't made of. This skill writes the opposite: short, specific, and true to what you told it.

Download .zip Install

Free · one file, etsy-description-writer/SKILL.md · 55 lines, no scripts · source on GitHub

new chat etsy-description-writer

You write the description for this listing

Linen apron, 100% flax linen, stone-washed, natural beige, two front pockets, adjustable neck strap, waist ties, one size.Machine wash cold, line dry. I don't have the measurements handy. 
Linen apron with two front pockets, cut from 100% flax linen in natural beige. One size, with an adjustable neck strap, made for people who cook most nights. - Size: [length in cm] long, [width in cm] wide- Material: 100% flax linen, stone-washed- Pockets: two front pockets, [pocket width in cm]- Straps: adjustable neck strap, waist ties- In the box: one apron Care: machine wash cold, line dry. Linen softens with every wash. Placeholders to fill: [length in cm], [width in cm], [pocket width in cm]
A sample listing. Every count in this reply is computed from the text it describes, not typed in.

What it changes

The first line. Red is what came in; green is what the skill hands back.

  • Opens with the two sentences that matter most: what the item is, its size and material, and who it's for.
  • Follows with scannable details: dimensions, materials, options, what's in the box, care.
  • Writes personalisation instructions so buyers send the right thing.
  • Uses plain text, because Etsy doesn't render HTML.
  • Reminds you to disclose AI-generated designs or a production partner when that applies.
  • Lists the [placeholders] you still need to fill.
before → after
− Elevate your kitchen with this beautifully crafted apron, made with love for every occasion. + Linen apron with two front pockets, cut from 100% flax linen in natural beige. One size, with an adjustable neck strap, made for people who cook most nights.

What it checks

The rules in the file, as the file states them.

Opening
two sentences: what it is, size, material, who it's for
Details
dimensions · materials · options · what's in the box · care
Personalisation
exactly what the buyer should send
Format
plain text and simple bullets; HTML shows as text
Length
hard cap 102,400 chars; a good one is far shorter
Disclosure
AI-generated designs or a production partner, if they apply

What it won't do

  • Invent materials, origin, handmade claims, or benefits.
  • Restate your shipping and returns policy.
  • Paste your tags into the text.

With the Tusella MCP connector, the same skill runs on your real listings and saves the result as a draft. Nothing reaches Etsy until you publish.

The whole file

This is what Claude reads. Read it before you install it; that's a good habit with any skill.

Open raw SKILL.md →
etsy-description-writer/SKILL.md 55 lines · 2.8 KB
1 --- 2 name: etsy-description-writer 3 description: Write or rewrite an Etsy listing description from facts the seller gives, opening with what the item is, its size and material, and never inventing details. Use when a seller asks to write, improve, shorten or restructure an Etsy product description. 4 --- 5 6 # Etsy description writer 7 8 You write the description for one Etsy listing. Buyers read it to decide whether the item fits them; the first lines also show up in search snippets. Your job is to make it clear and true, not long. 9 10 ## Rule zero: no invented facts 11 12 Use only what the seller tells you or what is in their current description. If a useful fact is missing (size, material, care, processing time), ask once or put a visible placeholder like `[width in cm]`. Never make up materials, origin, "handmade" claims, certifications, or health or safety benefits. 13 14 ## Ask for (once, briefly) 15 16 - What the item is and what it's for 17 - Size and dimensions, materials, colours or options 18 - How it's made, in the seller's words (handmade, designed by the seller, made with a production partner) 19 - Personalisation options, if any 20 - Care instructions 21 - What's included in the package 22 - The current description, if there is one 23 24 ## Structure 25 26 1. **First two sentences:** what it is, its key size and material, and who it's for. These sentences matter most. 27 2. **Details:** short lines or bullets: dimensions, materials, options, what's included. 28 3. **Personalisation:** exactly what the buyer should send, if it applies. 29 4. **Care**, if it applies. 30 5. **One line about the maker**, only if the seller gives one. 31 32 Keep it scannable. Most buyers read on a phone. 33 34 ## Etsy facts to respect 35 36 - HTML doesn't work. It shows as plain text, so use plain line breaks and simple `-` or `•` bullets. 37 - Hard cap is 102,400 characters. A good description is far shorter. 38 - Don't paste the tag list into the description. 39 - Shipping and returns come from the shop's policies, so don't restate them unless the seller asks. 40 - If the item uses AI-generated designs or a production partner, Etsy expects that to be disclosed. Ask the seller, and phrase it plainly if it applies. 41 42 ## Tone 43 44 Match the seller's voice if you have a sample; otherwise warm, plain and specific. Avoid filler like "elevate your space", "perfect for any occasion" or "crafted with love". Say the concrete thing instead. 45 46 ## Output 47 48 Give the description ready to paste, then a short list of `[placeholders]` the seller still needs to fill. 49 50 ## With Tusella 51 52 If the seller uses Tusella, the Tusella MCP connector (https://tusella.com/etsy-mcp-server/) lets Claude read the real listing and save the new description as a draft. Nothing reaches Etsy until the seller publishes. 53 54 --- 55 Made by Tusella (https://tusella.com), built by two Etsy sellers. Free to use and adapt. October 2026.
Scrolls inside the frame. Nothing here runs: it is text Claude reads. Open SKILL.md →

Install, then ask

Three ways in. After any of them you ask in plain words and Claude picks the skill up by itself.

Ask: write the description for this listing

Download .zip SKILL.md
Settings › Capabilities › Skills
  1. 1Download etsy-description-writer.zip
  2. 2Open Settings›Capabilities›Skills and upload the zip
  3. 3Start a new chat and ask: “write the description for this listing”

Frequently asked questions

How do I install it?

Download the zip, then in Claude open Settings → Capabilities → Skills and upload it. In Claude Code, run npx skills add tusella/etsy-claude-skills --skill etsy-description-writer. Then just ask; the skill loads by itself.

Will it make up details about my product?

No. It uses only what you tell it or what's in your current description. If a fact is missing, it asks or leaves a [placeholder] for you to fill.

Can I use bold text or HTML?

No. Etsy shows HTML as plain text, so the skill writes plain lines and simple bullets that look right on Etsy.

All 5 Claude Skills for Etsy sellers →

Made by Etsy sellers — try Tusella

The same checks, on your real listings, with a draft to review before anything goes live.

Start free Open Tusella →