Product Description skill
A ready-to-run product description skill: how Okara’s Writer Agent turns specs into scannable, benefit-led descriptions that sell and rank.
Download the skill instructions, see an example description, or run it live inside the Writer Agent across your catalog.
- Category
- Writer
- Agent
- Writer Agent
- Format
- product-description.md
- Price
- Free to download
The skill file
--- name: product-description description: Turn product specs into a scannable, benefit-led description that helps a shopper decide quickly and can be found in search. owner: Okara Writer Agent --- # Product Description A product description has two jobs: help a shopper decide, and help the page be found. Lead with the benefit, make the details skimmable, and place keywords where they read naturally.
Log in to view, copy, and download the complete skill file.
About this skill
What is the Product Description?
The Product Description skill is the instruction set Okara’s Writer Agent uses to convert a spec sheet into a description a shopper actually reads and a search engine can index. It covers the hook, the benefit-led body, the scannable feature block, and the keyword placement — so every product page does its job instead of repeating the manufacturer’s blurb.
It’s written as a SKILL.md, a plain-language instruction format that both people and AI agents can follow directly. Read it to understand the approach, adapt it for your store, or let the Writer Agent write descriptions from your product details.
Downloading the instructions is free with an Okara account. Writing benefit-led descriptions across a whole catalog, with consistent tone and structure, is part of the Writer Agent.
Example
See it in action
You ask: “Write a product description for a stainless steel insulated water bottle, 750ml, keeps drinks cold 24h.”
Agent does: Here it is. It opens on the benefit shoppers buy for — "Cold from your first sip to your last, 24 hours later" — then a short line on where it fits their day (gym, commute, trail). Below that, a scannable spec block: 750ml, 18/8 stainless steel, leak-proof lid, fits standard cup holders. I worked in "insulated water bottle" and "keeps drinks cold" naturally for search, and closed with a note on the sweat-free grip. Want a shorter version for category pages and a longer one for the product page?
How it works
From input to fix list
- 1
You share the product specs
Paste the details, materials, dimensions, and use case. Bulk lists work too.
- 2
Okara finds the hook
The Writer Agent identifies the one benefit shoppers buy for and leads with it.
- 3
It writes a scannable description
A benefit-led opener, a short body, and a clean feature block, with keywords placed naturally.
- 4
You get catalog-ready copy
Descriptions you can paste per product, or generate at scale across the catalog in the Writer Agent.
What's included
Everything it checks
Benefit-led hook
Opens on the outcome the shopper is really buying, not the spec.
Shopper-intent framing
Frames the product around when, where, and why it actually gets used.
Scannable feature block
Turns specs into a clean, skimmable list buyers can check at a glance.
Natural keyword placement
Works search terms into the copy without keyword stuffing.
Attribute & variant copy
Handles materials, sizes, and variants clearly and consistently.
Multi-length variants
Produces short category-page blurbs and longer product-page versions from one input.
Use cases
When to reach for it
- Replace generic manufacturer blurbs with copy that actually sells.
- Write consistent descriptions across a large or growing catalog.
- Create short and long variants for category and product pages.
- Improve product-page search visibility without keyword stuffing.
- Adapt tone and terminology for a new store or marketplace.
Frequently asked questions
Related skills
Pair it with these skills
Blog Post
The blog-writing methodology Okara’s Writer Agent follows to turn a keyword into a focused, SEO-aware post that ranks and reads like a human wrote it.
--- name: blog-post description: Write a single, focused, SEO-aware blog post — one topic, one reader, one takeaway — that ranks in search and reads like a human wrote it. owner: Okara Writer Agent --- # Blog Post Write one publish-ready blog post built around a single topic and a single reader intent, structured to earn the search click and hold attention to the
Long-Form Content
The pillar-content methodology Okara’s Writer Agent uses to write comprehensive, authoritative guides that own a topic and earn links over time.
--- name: long-form-content description: Write a comprehensive, authoritative pillar guide (2,000-5,000+ words) that covers a topic end to end, anchors a content cluster, and earns links and rankings over time. owner: Okara Writer Agent --- # Long-Form Content Produce a definitive, in-depth guide that owns a broad topic — the page a reader bookmarks and other sites link to — not a quick post. Depth, structure,
Listicle
The list-article methodology Okara’s Writer Agent uses to write scannable, curated listicles where every item earns its place and the framing makes the choice easy.
--- name: listicle description: Write a scannable list article — "N X for Y" — with a curated set of items, parallel structure, and a framing that makes the reader's decision easier. owner: Okara Writer Agent --- # Listicle Write a list-format article that's genuinely useful, not padded. Every item earns its place, the structure is consistent, and the intro and wrap-up turn a