category-page-copywriter
Skill1 starsChanged 40 days agoMITView on GitHub
Write the intro and lower-page copy for an ecommerce collection or category page so it ranks for a commercial query while pushing shoppers toward a product fast. Use when someone asks "write copy for my ecommerce category pages", "write the intro blurb for my collection page", or "write SEO copy for my collection page below the product grid" - the above-grid intro, the H1, and the supporting content under the grid. Do NOT use for standalone marketing or campaign landing pages - use landing-page-copy instead; do NOT use for a single product's description - use product-description-writer instead.
In this repository8 other files it gives its agents.
The file
We split this skill into the rules it gives an agent
7 rules. About 0 are common, 7 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈7
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 20
Stress-test the category: If the category is thin or overlaps another, flag it before delivering copy (see Do NOT).
- Distinctive: line 27
Every claim is true to the actual catalog.
- Distinctive: line 32
Do NOT write a long intro that pushes the product grid below the fold.
- Distinctive: line 33
Do NOT pad with keyword repetition or density tricks.
- Distinctive: line 34
Do NOT overpromise selection ("hundreds of styles" when there are nine) or claim authority, awards, or rankings you cannot back.
- Distinctive: line 35
Do NOT invest copy in a thin or duplicative category - thin pages rarely rank and overlapping pages cannibalize each other.
- Distinctive: line 36
Do NOT write standalone marketing/campaign landing-page copy (use landing-page-copy) or single-product descriptions (use …
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Category Page Copywriter
A category page has a harder job than a product page: it must rank for a broad commercial query while helping a shopper narrow toward a product fast. It cannot push products below the fold or read like keyword salad.
Workflow
- Gather inputs. Get the category name, the primary keyword and 1-3 secondary keywords, the products it contains (count and the axes they vary on), the buyer's main decision criteria, and the brand voice. If any are missing, ask before writing.
- Write a tight above-grid intro. 2-3 sentences, ~40-60 words, placed above the product grid. State what the collection is and who it's for, and use the head keyword once, naturally. Never wall the products off behind a long essay.
- Set the H1. One clear H1 containing the head keyword, phrased for a shopper, not stuffed.
- Write a "How to choose" block. 3-4 decision criteria that route the shopper to the right subset ("Pick the 150 weight for high-output activity, the 250 for cold-weather layering"). Bold each criterion. This is the highest-value part of the page.
- Write the lower-page SEO content. Below the grid, in short paragraphs under subheads, answer buying questions: how to choose, what differs between options, what fits which use case. This captures "best", "vs", and "for [use case]" long-tail intent through semantic coverage, not keyword repetition.
- Add internal links and FAQ copy. In the lower content, link to relevant sibling categories and key products using descriptive anchor text. Draft 3-5 FAQ questions with concise answers (real shopper questions) for the page owner to publish.
- Stress-test the category. If the category is thin or overlaps another, flag it before delivering copy (see Do NOT).
Quality bar
- Products are visible above the fold; the long-form copy lives below the grid.
- Head keyword appears once in the intro and once in the H1, never mechanically repeated; secondary keywords are covered semantically.
- The "How to choose" block alone could route a shopper to the right product.
- Every claim is true to the actual catalog; copy matches brand voice exactly.
- Lower content is scannable: subheads, short paragraphs, bolded criteria, descriptive link anchors.
Do NOT
- Do NOT write a long intro that pushes the product grid below the fold.
- Do NOT pad with keyword repetition or density tricks; semantic coverage beats density.
- Do NOT overpromise selection ("hundreds of styles" when there are nine) or claim authority, awards, or rankings you cannot back.
- Do NOT invest copy in a thin or duplicative category - thin pages rarely rank and overlapping pages cannibalize each other. Recommend merging or expanding the catalog first.
- Do NOT write standalone marketing/campaign landing-page copy (use landing-page-copy) or single-product descriptions (use product-description-writer).
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

