Foundation documents used by this skill
These documents teach the skill about your brand. Create them once, use them everywhere.
Common questions
What kind of product data does it accept? + −
Whatever you have: spec sheets (PDF, image, or pasted), Shopify CSV rows, supplier data sheets, product feed entries, or raw notes. The more specific the input, the more specific the output.
Do I need a content template? + −
Yes. The skill needs to know what sections to write. You can upload a content template document (from the content template skill), or describe your PDP sections directly. The skill won't guess at a page structure.
How is this different from the rewrite PDP copy skill? + −
The rewrite skill takes existing PDP copy and improves it. This skill writes net-new descriptions when no customer-facing copy exists yet, which is the typical scenario when new products arrive with only spec data.
What happens when the spec data is incomplete? + −
The skill writes what the data supports, marks gaps as placeholders with specific asks, and documents what additional data would strengthen the copy. It never fills gaps with plausible guesses.
Example skill output + −
# Product Description: Cascade Rain Shell - Men's
**Product data source:** Product spec sheet + product attributes CSV
**Supporting inputs:** Brand voice profile, positioning brief, content template (from Women's PDP)
---
## Hero Description
The Cascade Rain Shell is the jacket you grab when the forecast says "maybe," which in the Pacific Northwest is most weekends from October through June. 2.5-layer waterproof/breathable fabric with fully taped seams keeps you dry in sustained rain, not just a quick drizzle between the car and the trailhead.
At 330 g, it packs into its own pocket and stays in your daypack until you need it. The fabric is quiet, with no loud swishing on the trail or on the walk to work. Light enough for everyday use, built well enough that you're not replacing it next fall.
## Features
- 2.5-layer waterproof/breathable fabric with fully taped seams
- PFAS-free DWR finish that sheds rain and wet snow
- Adjustable, helmet-compatible hood with a structured brim
- Two hand pockets with water-resistant zips
- Pit zips for venting on steep uphills
- Packs into its own pocket with a carabiner loop
## Materials & Specs
- **Waterproof rating:** 15,000 mm
- **Breathability:** 15,000 g/m²/24h
- **Weight:** 330 g (size M)
- **Shell:** 100% recycled nylon ripstop (laminated)
- **Zippers:** YKK water-resistant center front and pocket zips
- **Fit:** Regular (room for a light midlayer)
## Care Instructions
- Machine wash cold on gentle cycle
- Close all zippers and hook-and-loop tabs before washing
- Use mild detergent (no fabric softener)
- Tumble dry low to reactivate DWR, or warm iron with a cloth barrier
- Do not bleach or dry clean
## Sizing Notes
- The Cascade fits on the generous side. If you're between sizes and don't plan to layer a fleece underneath, consider sizing down.
- For layering a midlayer or light insulated vest, your usual size should work.
- Designed to sit just below the hip for coverage under a pack.
---
## Carry-Through Sections
### Materials & Specs
All spec values (waterproof rating, breathability, weight, materials, zipper brand, fit designation) carried through from the product spec sheet and attributes CSV. No modifications to numerical claims.
### Care Instructions
Care instructions carried through from the product spec sheet. These are standard manufacturer care directions and were not modified.
---
## Notes
### Spec-to-Copy Mapping
**Hero Description:** Led with the 2.5-layer waterproof/breathable construction and fully taped seams (spec sheet: construction section). Waterproof rating (15,000 mm) and breathability (15,000 g/m²/24h) from the attributes CSV informed the "sustained rain" framing. Weight (330 g from spec sheet) drove the packability angle. "Pacific Northwest" context from the positioning brief, which centers the brand on weekly PNW hiking. "Quiet fabric" from the spec sheet's noise rating note.
**Features:** All six bullets trace directly to the spec sheet's feature list: 2.5L fabric + taped seams, PFAS-free DWR, helmet-compatible hood with structured brim, hand pocket placement + water-resistant zips, pit zips, stuff pocket with carabiner loop.
**Materials & Specs:** Direct carry-through from spec sheet and attributes CSV. Weight listed in grams as provided.
**Care Instructions:** Carried through from spec sheet care section. DWR reactivation step (tumble dry low) included because the spec sheet confirms PFAS-free DWR treatment.
**Sizing Notes:** Fit designation ("Regular") and layering guidance ("room for a light midlayer") from spec sheet. "Generous fit" and size-down recommendation from the spec sheet's fit notes. Hip-length measurement from the spec sheet's dimensions.
### Confidence Notes
**Hero description:** The opening line ("the jacket you grab when the forecast says 'maybe'") and the framing around everyday use are inferred from the product category (rain shell), the brand's positioning brief (weekly-use gear for PNW hikers), and the weight/packability specs. The positioning brief is doing most of the work here. Without it, the hero would be more generic.
**Value framing:** "You're not replacing it next fall" is inferred from the limited lifetime warranty and the brand's positioning around durability. The spec sheet doesn't include explicit durability claims or test data, so this is a soft inference from warranty + positioning. Flagged in case the brand prefers to avoid durability claims without test data.
### Recommendations
**Add a "Good to know" or FAQ section to the template.** The spec sheet includes fit details (generous, size down for slim builds, pocket placement relative to hipbelts) that are useful for purchase decisions but don't have a natural home in the current template. A short section with 2-3 common questions would help customers self-select the right size and set expectations for pack compatibility.