cms-paywall-audit— agent skill

You are an assistant that executes this skill workflow for the user.

You MUST execute the required tool workflow and return the output in the required format sections. Do not skip required steps and do not replace the required report/template with a short summary.

Goal

Ensure premium content is gated coherently — every paywalled item offers a sensible free preview, and no paywall field combination is contradictory.

Access contract

• READ_ONLY.

Applicability check (run first)

• This skill only matters for apps that sell in-app purchases. If the app

has no premium content at all, say so and stop — do not produce an empty audit.

• accessTier (free / premium) applies to articles, events, maps, videos,

and sounds. maxFreeParagraphs and displaySummaryInList apply to articles only.

Default paywall rules

An item is flagged if:

• accessTier=premium and maxFreeParagraphs=0 and displaySummaryInList

is off → no preview at all (reader sees nothing before paying)

• displaySummaryInList is on while maxFreeParagraphs > 0 → invalid combo

(displaySummaryInList is only writable when maxFreeParagraphs is 0)

• maxFreeParagraphs greater than the article's actual paragraph count → the

"preview" exposes the entire body for free (paywall is ineffective)

• accessTier=premium on an item with an empty body → nothing to sell
• Inconsistent tiers within a category the user expects to be uniformly premium

Required Tool Workflow (strict order)

Follow the sequence below exactly when those tools are available for the request context.

1. cms_list_cms_sections: discover content types/sections present.
2. List items per type and read accessTier from the list rows:

• cms_list_articles, cms_list_events, cms_list_maps, cms_list_videos,

cms_list_sounds.

1. For premium articles, confirm preview config:

• cms_get_article for maxFreeParagraphs / displaySummaryInList
• cms_list_article_paragraphs to compare maxFreeParagraphs against the

real paragraph count.

1. Apply the paywall rules and group findings by severity.

Tools used

• cms_list_cms_sections
• cms_list_articles, cms_list_events, cms_list_maps, cms_list_videos, cms_list_sounds
• cms_get_article, cms_list_article_paragraphs (targeted confirmation)

Output contract (exact sections required)

The final answer MUST include all sections shown in this output template, in the same order.

## Paywall audit (N premium items, M flagged)

### 🔴 Broken paywalls (fix first)
- Premium with no preview: N [IDs...]
- Preview exposes full body: N [IDs...]

### 🟡 Invalid configuration
- displaySummaryInList set while maxFreeParagraphs > 0: N [IDs...]
- Premium item with empty body: N [IDs...]

### 🟢 Review
- Mixed tiers in a "premium" category: N

## Items to fix first
| Type | Item | Issue | Recommended fix |
|------|------|-------|------------------|

Do not replace this output with a one-line answer.

Guardrails (hard rules)

• Read-only skill: never change accessTier, maxFreeParagraphs, or

displaySummaryInList. Recommend only.

• If the app sells no IAP, do not invent findings — report "no premium content".
• maxFreeParagraphs is an integer 0–5; treat values outside that as anomalies.
• On large catalogs, audit premium items by category in chunks rather than

fetching everything.

Next possible actions

• Use cms_update_article to fix preview length / tier on a flagged article.
• Run cms-content-audit for non-paywall quality issues on the same items.
• Run cms-article-publish to recreate a premium article with correct preview settings.