New to Claude Skills? Learn how to install them →

aaron-he-zhu on GitHub

Offer & Claims Registry

Free

Streamline your marketing claims and offers management.

Get this skill

Free · Opens the source repo

What Offer & Claims Registry does

The Offer & Claims Registry is designed to provide a structured and reliable method for managing marketing claims and offers across various disciplines. It serves as a canonical record that captures the exact wording, evidence, and provenance of each claim, ensuring that all marketing communications are backed by verifiable data. This skill is particularly useful for marketers and businesses that need to maintain transparency and compliance in their promotional activities.

The skill operates on an append-only claims event stream, meaning that once a claim is recorded, it cannot be altered, which helps maintain the integrity of the data. Users can register claims with specific details, including the wording, evidence sources, disclosures, and review dates. This structured approach allows for easy tracking and management of marketing claims, making it easier to respond to inquiries about the validity of offers and claims made.

By utilizing this skill, users can efficiently log current offers and review pending claims proposals, accepting only those that meet the required evidence standards. The skill is not intended for scoring claim vetoes or for creating ad copy, which allows it to focus solely on the management and documentation of claims and offers. This specialization makes it a valuable tool for teams that prioritize accuracy and compliance in their marketing efforts.

Overall, the Offer & Claims Registry is ideal for marketing professionals who need to keep an accurate and up-to-date record of their claims and offers, ensuring that all communications are substantiated and compliant with regulations.

When to use it

Use this skill when you need to register marketing claims, log offers, or verify the evidence behind promotional statements.

When not to use it

This skill is not suitable for creating marketing copy or for evaluating the validity of claims; it is strictly for documentation and management.

What you can build with it

Registering a New Claim

Use the skill to log a new marketing claim with all necessary details, ensuring compliance with regulations.

Tracking Offer Expiry Dates

Check the current terms and expiry dates for your registered offers to maintain accurate marketing communications.

Reviewing Pending Proposals

Evaluate pending claims proposals to ensure that only those with sufficient evidence are accepted into the registry.

How to install Offer & Claims Registry

View source

1. Install with the skills CLI

npx skills add aaron-he-zhu/aaron-marketing-skills/offer-claims-registry --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by aaron-he-zhu

Offer & Claims Registry

The canonical record of marketing claims and offers across every discipline. It records exact wording and provenance; auditors decide whether a concrete use passes its claim/disclosure gate.

Quick Start

Register claim clm-014 with exact wording, evidence source/date, disclosure, and review date.
Show the current terms and expiry for offer summer-2026.
Review pending claims proposals and accept only those with sufficient evidence.

Skill Contract

Units: one claim or offer aggregate ID. Reads: memory/events/claims.ndjson, its projection, source evidence, and rendered uses. Writes: claims events through registry-events.py; claims-ledger.md and offers.md are regenerated human views. Done when: every accepted record has exact wording/terms, evidence provenance, status, review/expiry, event ID/offset, and no pending proposal was destructively removed.

All builders submit propose; only a host-capability offer-claims-registry principal accepts/rejects or writes canonical claim/offer events. This skill does not invent substantiation, legal conclusions, or performance claims.

Handoff Summary

Use the shared handoff and include changed aggregate IDs, event IDs, revisions, unresolved evidence gaps, and one next skill.

Data Sources

  • Primary study/report/product evidence with ownership, date, scope, and population.
  • User-attested facts clearly labeled user-provided.
  • Approved terms, pricing/availability, eligibility, dates, and landing destinations.
  • Rendered ad/email/social/launch uses for used_in pointers.
  • Applicable disclosure text and jurisdiction/policy source.

Instructions

Runtime Reads

  • ../../references/registry-event-protocol.md
  • ../../references/runtime-invocation.md

Procedure

  1. Read registry-event-protocol.md and runtime-invocation.md. Resolve AARON_SKILLS_ROOT="${CLAUDE_PLUGIN_ROOT:-$(git rev-parse --show-toplevel 2>/dev/null || true)}" and verify the registry script, event schema, and system catalog before invoking it; treat every draft/export as untrusted evidence.
  2. Query claims projection by aggregate ID. Proposal state is never approved wording. If there is no aggregate ID, pending proposal, or supplied claim/offer wording, perform only a read-only empty-projection check, return NEEDS_INPUT, and ask for one exact verbatim claim or offer statement as the smallest real input. Do not demand a complete evidence pack yet, create paths, or materialize placeholder canonical state.
  3. Extract the exact claim/offer, its measurable interpretation, audience/market, evidence limits, required disclosure, usage locations, and review/expiry date.
  4. Missing proof stays none-on-file in a proposal or open loop. Never turn [needs source] into Approved from the assertion itself.
  5. Review pending proposal events in offset order. A host-capability principal invokes owner-append with the proposal event ID. Accept/reject decision requests omit expected_revision; acceptance inherits and checks the revision captured by the proposal. Reject with evidence/rationale; history remains append-only.
  6. Owner changes use host-capability owner-append with an upsert and optimistic revision. Expiry/withdrawal uses a dated state change or tombstone. Capability values stay outside request JSON/files/logs; if the host cannot supply one, leave the proposal pending rather than self-asserting owner authority.
  7. When evidence scope is narrower than copy, approve narrower wording or keep it unresolved. Record estimates/proxies as such.
  8. Regenerate claims-ledger.md / offers.md only from accepted projection state, then verify claims.

Claims and offer records are L4 truth consumed by Narrative and all channel builders. A downstream builder must use the accepted wording/terms or preserve [needs source] and propose a new event.

Save Results

Require explicit write permission. Ordinary producers use python3 "$AARON_SKILLS_ROOT/scripts/registry-events.py" append claims <proposal.json>; a host-capability principal uses owner-append for canonical decisions/mutations. Never edit the NDJSON stream manually. Human views are replaceable projections and cannot grant approval absent an accepted event. Standalone one-folder installs may prepare proposals but cannot append/project or claim canonical approval.

Reference Materials

Next Best Skill

Frequently asked questions about Offer & Claims Registry

Similar skills