---
name: "skill-seo-discovery"
type: skill
license: CC BY-NC-SA 4.0
description: Reach's discoverability procedure for a retail venture — making its products findable by the people its ICP describes, on the surfaces where they look. Covers product and collection SEO on Shopify (titles, handles, meta descriptions, metafields, structured data, image alt text, collection descriptions, within convention-shopify's naming and alt-text rules); discovery beyond Google (Pinterest as search for homeware, marketplace search ranking, Shopify's own search); the keyword approach for a craft brand (the long tail around ritual, material and gifting; bilingual Welsh and English where it earns its place); and measurement through skill-campaign-report as organic sessions and conversion against baseline. Use when a venture needs organic discovery to grow, when a new product set, collection or page must be findable, or when a launch from skill-launch-campaign needs its search surface ready. Recommends and routes; never rewrites a live page itself. Promoted from placeholder by APP-1080.
---

# seo-discovery

Reach's discoverability skill. Discovery is step 1 of the touchpoint chain in `convention-retail` — earn the visit — and organic discovery is the only acquisition that does not scale with spend. This skill makes a venture's products findable on the surfaces where its audience actually looks: web search, Pinterest, marketplace search and the store's own search. It reads the ICP from `skill-audience-icp`, the naming and alt-text rules in `convention-shopify`, the storefront bar in `standard-storefront`, and the range and collection logic from `skill-retail-strategy`. It recommends; copy goes to `skill-content-studio`, theme and structured-data work to Forge, imagery to Pixel, store-data changes to the operator via `skill-channel-ops`.

## Trigger

- A venture needs organic discovery to grow, or organic sessions are flat against target in a `skill-campaign-report` read.
- A new product set, collection or page is going live and must be findable — including a drop or launch from `skill-launch-campaign`, whose search surface is prepared here before the tease phase.
- A marketplace or Pinterest shop is being opened through `skill-channel-ops` and its listings need search-ready titles and descriptions.
- A `skill-storefront-merchandising` or `standard-storefront` scoring pass surfaces a discovery finding.

## Behaviour

Five passes; a first run does all five, a per-product or per-launch run does 2 to 4 for the items in scope.

### Pass 1 — the surfaces and the baseline

From the ICP, list the surfaces this audience searches on, in order of likely share: for a craft homeware brand, working rule, Google, Pinterest, the marketplace where the venture lists, then the store's own search. Capture the baseline: organic sessions and their conversion from `convention-shopify`'s sessions-and-conversion query cut by source, the top landing pages, the queries Search Console reports where it is wired, and the store's top on-site searches. Every later recommendation is measured against this baseline; a surface with no readable baseline is marked assumed.

Before recommending that anything be added to a content surface, inventory the surfaces that already exist. List every blog with its **handle**, and every article on it with its published state, its date and its subject; do the same for standalone pages. Two consequences make this load-bearing. A recommendation that names a path writes that path from the **live handle**, never from a convention — a slug written against an assumed handle stands up a second blog rather than adding to the first. And existing published content that is stale, off-range or duplicated is itself a finding of this pass and is filed as one, because an old thin page competing with the new one is a search negative that adding content does not fix. The pass states the surfaces it checked **and the ones it did not**, explicitly, so the gap is answerable — a fully ticked criteria list reads as coverage, and a surface nobody named is a surface nobody read.

### Pass 2 — the keyword approach

A craft brand does not win the head term ("dinner plate"). It wins the long tail where intent and margin sit. Build the term set on three axes — **ritual** (the table, morning coffee, washing up, scent), **material and making** (stoneware, hand-thrown, Welsh slate, small batch), **gifting** (housewarming, wedding, Mother's Day, Dydd Santes Dwynwen) — and cross them with the range tiers from `skill-retail-strategy` Pass 3. Prefer terms the audience uses over terms the maker uses. Welsh appears where it earns its place, per the venture's `convention-brand`: a Welsh product name or a bilingual collection title carries cultural weight and a small, uncontested search; a Welsh-only page that the English-speaking majority cannot find does not. Each term carries an intent (learn, compare, buy, gift) and the page type it should land on, so the store lands the visitor where `convention-retail` step 1 says it must.

### Pass 3 — product and collection SEO on Shopify

Per product and collection, recommend, inside the naming already fixed in `convention-shopify`:

- **Title and handle** — the `Product name | Variant descriptor` form stays; the search-facing title tag may lead with the customer's term. Handles are set once and not churned; a changed handle needs a redirect, which is Forge's.
- **Meta description** — one sentence in the voice, with the buy or gift intent, under 155 characters as a working rule.
- **Description structure** — the PDP answers what it is, what it is made of, how big, who made it, when it ships, and how to care for it (`convention-retail` step 3, `standard-storefront`); write it so the answers are headed and scannable, which is what search and the customer both read.
- **Metafields** — material, dimensions, maker, care, lead time, as structured data the theme renders and search reads; the field set is proposed here and built by Forge.
- **Structured data** — Product, Offer, and Review schema present and valid on every PDP; Breadcrumb on collections; verified with a validator, not assumed from the theme.
- **Image alt text** — describe the frame, never the product name, because the asset is shared (`convention-shopify`); count assets before writing.
- **Collection descriptions** — a titled, described collection in the customer's words per `standard-storefront`, with the collection's ritual or gifting term in the first sentence.
- **Internal links** — goes-with cross-sells and collection links so no product is an orphan.

Route: copy to `skill-content-studio`; metafield, schema, redirect and theme changes to Forge as a specified ticket; store-data edits (titles, alt text, collection copy) staged for the operator through `skill-channel-ops`.

### Pass 4 — discovery beyond Google

- **Pinterest as search.** For homeware Pinterest is a search engine with pictures. Pin titles and descriptions carry the Pass 2 terms; boards map to collections and rituals; every product has a tall pin with a plain title. Pins feed the DTC store, not a Pinterest checkout, at 0→1.
- **Marketplace search.** Where a marketplace is open (`convention-retail` says optional at 0→1), its listings use the marketplace's own term conventions and tag limits, with the store's packshots for consistency; ranking is earned by conversion and reviews, so listings are few and complete rather than many and thin.
- **Shopify's own search.** Read the top on-site queries; every one of them returns the products it means, and a zero-result query offers collections (`standard-storefront`). Synonyms and Welsh or English pairs are added so a search in either language finds the product.

### Pass 5 — measure and file

File the recommendations as a prioritised list in the venture's project — each with the surface, the term or page, the change, the owner it routes to, and the KPI it moves — and hand the measurement to `skill-campaign-report`: organic sessions by surface, organic conversion, and revenue from organic, against baseline and target. Working rule: read monthly; judge a change no sooner than eight weeks after it ships, since search moves slowly and a faster verdict is noise.

## Guardrails

- Recommends and routes; never rewrites a live page, product or collection itself. Store-data edits are staged for the operator; theme and schema changes are Forge's via the repo (`convention-shopify`).
- No keyword stuffing, no doorway pages, no bought links, nothing that trades long-term trust for a rank.
- Stays inside `convention-shopify` naming; a handle is never churned for a keyword.
- Alt text describes the frame, never the product name (the shared-asset rule).
- Welsh earns its place; it is never decoration and never a barrier.
- Product facts come from the store; never invented (`convention-ticket`).
- A recommendation to add to a surface is never made without a read of that surface; the pass names the surfaces it checked and the ones it did not.
- Every recommendation names the KPI it moves; reports through `skill-campaign-report` against baseline, never as a bare rank.
- Propose-only to canon.

## Setup

Run on demand by Reach for the operator, before any launch, and monthly as a read. Connectors: Shopify (read; GraphQL for metafields), Linear, Search Console and Pinterest where wired. Fed by `skill-audience-icp`, `skill-retail-strategy`, `skill-launch-campaign`; feeds `skill-content-studio`, `skill-channel-ops`, `skill-campaign-report`, Forge. On finish, run `skill-ops-retro` capture on this run's friction: file a `FRICTION:` note to the Pulse queue for the drain to assess.

Owned by Reach (R3-ACH), run for the venture's operator.
