← All playbooks · Raw API

task-seo-descriptions

# Capability: SEO meta descriptions

## Intent phrases

- update meta descriptions
- improve SEO for Google
- change page descriptions for search

## Requires capabilities

`pages` or `articles`

## Prerequisites

- Field name is **`description`** (meta description) on pages and articles
- `cms_edit ["list", "--type", "page"]` for page inventory

## Steps

**Per entry (hosted editors):**

1. `cms_edit ["open", "--page-slug", "<slug>"]`
2. `cms_edit ["set", "@p0", "description", "<new meta description>"]`
3. `cms_edit ["diff"]` → `cms_edit ["save"]`

**Many entries with known IDs:**

```
cms_edit ["batch", "set", "<pageId>:description=…", …]
cms_edit ["batch", "save"]
```

**Dev agents only** — if `capabilities.devTools.cmsSeoAudit` is true, developers may run the site's `cms:seo-audit` CSV workflow locally. Hosted editors should use per-entry updates above.

## Confirmation gates

1. Propose new descriptions (or selection of pages) — user approves
2. `diff` before `save`

## Out of scope

- Publish
- Keyword research (descriptions are editorial)

## Related resources

- `cms-edit://customer/routing`
- `cms-edit://customer/brand` (if present)