Aetheria-Labs1/storefront-skills / skills/audit
audit
VerifiedRead-only conversion audit of a whole storefront page. Scores above-the-fold, offer strength, proof, copy, design, mobile and funnel data against the build rules and returns ranked fixes. Never edits; hand approved fixes to /optimize.
references/offers/offer-ledger.md
View on GitHub# Offer Ledger
Any price other than the current list price, any discount, bundle saving,
gift, free shipping promise, delivery date, countdown, stock statement or
subscription term is a row in the plan's `## Offer ledger` before design.
`/design-page` renders offers only from ledger rows and fails hosted QA on
an unledgered offer element; a countdown or stock indicator
without a verified row is removed. Types and legality live in
`references/offers/offer-types.md`, `references/offers/price-presentation.md`
and `references/offers/urgency-scarcity.md`.
## The block
```markdown
## Offer ledger
**Offer type.** bundle (offer-types id)
**Summary.** Starter Kit: serum + cleanser + SPF, ₹2,499 vs ₹3,297 separately
**Confirmed by.** merchant (Aditi, email 2026-09-08)
| # | Item | Value shown on page | Basis | Confirmed | Status |
|---|---|---|---|---|---|
| O1 | bundle price | ₹2,499 | Shopify bundle product gid://.../456 | catalog 2026-09-10 | verified |
| O2 | compare-at | ₹3,297 | sum of component list prices, all currently sold at list | catalog 2026-09-10 | verified |
| O3 | savings | Save ₹798 (24%) | O2 - O1 | computed | verified |
| O4 | per-day price | ₹83/day | O1 U+00F7 30-day supply on label | label photo | verified |
| O5 | end date | none | evergreen bundle | merchant | verified |
| O6 | stock statement | none | not planned | - | - |
| O7 | shipping | Free shipping over ₹999 | store policy page URL | fetched | verified |
| O8 | delivery estimate | 2-5 days, pincode-based | DeliveryEstimate island, live | live | verified |
| O9 | code | none needed | automatic bundle price | merchant | verified |
| O10 | exclusions / stacking | not with WELCOME15 | merchant | merchant | verified |
| O11 | regions | India only | store markets | catalog | verified |
| O12 | subscription terms | none | - | - | - |
| O13 | guarantee | 30-day returns, unopened | policy URL | fetched | verified |
| O14 | BNPL | none | store payment methods | catalog | - |
```
Columns:
- **Item**: one of the fixed rows above. Keep the row with ` - ` when not
applicable; do not delete rows, so reviewers see what was considered.
- **Value shown on page**: the exact string the page will display, in the
store currency and locale.
- **Basis**: where the number comes from (catalog price, policy URL, label,
computation, merchant document).
- **Confirmed**: source and date. Prices and availability come from
`lexsis_catalog.get` on the planning day and are re-read in
`/design-page` before compose and in hosted QA.
- **Status**: `verified`, `pending` (not rendered), ` - ` (not applicable).
## Rules the ledger enforces
1. **Compare-at needs a basis.** A struck-through price is the genuine
recent selling price (the product's Shopify compare-at with a recorded
history, or the sum of components sold at list). No basis, no
strike-through. Every `<s>`, `<del>` or compare-at element carries
`data-source="compare_at_price"` or the ledger row id (`data-source="O2"`)
so the source/hosted review O12 can trace it. Jurisdiction rules are in
`references/offers/price-presentation.md`.
2. **Savings are computed, not typed.** Show currency first, percent only
when the rule for the type allows (`offer-types.md`). Never a percent
with no amount on high-ticket goods.
3. **Urgency needs a verified end or a live read.** `endsAt` is an ISO
datetime with timezone that the merchant confirmed; countdowns bind to
it and disappear after it. `endsAt` is the ledger's field name; the
CountdownTimer island's required prop is `endDate`, so the ledger value is
what you write into `endDate`. Confirm the prop name against
`lexsis_design` action `island_schema` before authoring. Stock statements come only from a live
inventory binding. Neither may appear in static copy.
4. **Terms travel with the offer.** Exclusions, stacking, regions, code,
minimum spend and subscription cancellation terms are visible within one
scroll of the offer, not only in a footer.
5. **Shipping and tax language is the store's.** Threshold, regions,
estimate source, tax-inclusive wording (GST-inclusive for India) come
from store settings or the policy page URL.
6. **One offer per page** unless the type is `sale-clearance-flash` or
`seasonal-gifting`. A second offer needs its own ledger block and a
reason.
7. **Manifest mirror.** `offer.type`, `offer.summary`, `offer.endsAt`,
`offer.stockVerified`, `offer.compareAtBasis` in `page record`.
## Claims to confirm before design (ask once, together)
- Exact price, compare-at and its basis.
- Start and end (date, time, timezone) or "evergreen".
- Stock basis for any scarcity statement.
- Code, automatic or both; case; single use.
- Exclusions, stacking with other codes, minimum spend, quantity caps.
- Regions and currencies.
- Shipping threshold and estimate source; delivery cutoffs for occasions.
- Gift-with-purchase item, value, while-supplies-last handling.
- Subscription cadence, discount, first-order terms, cancellation path,
renewal notice.
- BNPL providers actually enabled on the store.
- Guarantee and returns terms as written on the policy page.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |