Writing & Content brand-narrativemessage-hierarchybrand-voicenaming-rulesclaims-managementversion-control

Narrative Registry

Maintain one traceable, versioned source of truth for a brand’s narrative system.

FollowSkills review · FSRS-2.0
Not recommended
55/ 100 5-point scale 2.8 / 5
Trust18 / 25 · 3.6/5

The skill explicitly requires user authorization, expected_revision, host-capability boundaries, append-only events, replayable history, declared data sources, and prohibits direct NDJSON edits. The README and SECURITY material also describe non-persistent credentials, dry-run mutation gates, and private operational memory. Points are deducted because the referenced runtime protocol, scripts, and host deployment boundary are not fully supplied here, so isolation, rollback, and capability enforcement cannot be verified statically.

Reliability8 / 20 · 2.0/5

The contract clearly states read/write paths, atomic complete-canon replacement, stale-proposal rejection, validation, and bounded handoff when runtime capability is unavailable; repository material also indicates regression tests and CI. Points are deducted because execution of registry-events.py, projections, and verify narrative was not reproduced, and concrete abnormal-input diagnostics are delegated mainly to runtime files not provided.

Adaptability10 / 15 · 3.3/5

Triggers, inputs, reads, outputs, handoff fields, non-fit cases (TALE scoring and system authoring), and degraded behavior without host capability are explicit. Chinese and English labeling and compatible-host scope are clear, and the core function does not depend on overseas services. Points are deducted because standalone-install boundaries, semantic routing precision, and host reachability in mainland China have limited direct evidence.

Convention9 / 15 · 3.0/5

Frontmatter, version, Apache-2.0 licensing, Quick Start, shared contract, data sources, numbered instructions, handoff, and next-skill structure are well organized, with references to protocol, security, and registry documentation. Points are deducted because the selected skill does not identify a maintainer, update path, or changelog; repository materials also show a version inconsistency between 18.0.0 and SECURITY’s “17.x current line,” while key dependency documents were not supplied.

Effectiveness6 / 15 · 2.0/5

The skill specifies querying, recording complete versioned canon replacements, reviewing proposals, emitting exact canon/version pointers, and downstream handoff, so its intended registry task is clearly defined. Points are deducted because no representative executed output or statically verifiable end-to-end result is provided, and core actions depend on runtime and projection scripts outside the supplied evidence.

Verifiability4 / 10 · 2.0/5

The selected SKILL.md, README, LICENSE, SECURITY material, CI, and tests provide auditable design evidence, and tests cover shared architecture, audit artifacts, and privacy scanning. Points are deducted because the tests do not establish the narrative-registry key paths, no third-party corroboration or execution result is supplied, and static evidence cannot support a higher score.

Evidence confidence:Low Reviewed Jul 20, 2026 Reviewed revision ebd436747f8f
The upstream repository has new commits since this review. The score still applies to the reviewed revision shown and may not cover the latest changes.
Before you use it
  • Key dependencies—registry-event-protocol.md, runtime-invocation.md, registry-events.py, system-catalog.json, and verify narrative—were not supplied here and should be checked individually before deployment.
  • README identifies 18.0.0, while SECURITY.md calls 17.x the current supported line; confirm the support and security-fix scope for revision ebd4367.
  • Verify that the host actually provides the narrative-registry owner capability; otherwise the skill can only leave a proposal and must not claim canonical narrative persistence.
  • No scripts, tests, or real event writes were executed for this assessment.
Review evidence [1][2][3][4][5][6][7][8][9]
See the full review method →

What does this skill do, and when should you use it?

Narrative Registry is the protocol skill for managing a brand’s canonical narrative in Aaron Marketing Skills. It maintains one complete, versioned canon per brand, covering positioning, message hierarchy, voice, naming rules, proof points, and claim pointers. SEO/GEO, social, email, paid, influencer, and launch skills derive their messages from this canon rather than redefining it. It fits teams that need centralized narrative governance with replayable history.

It reads the narrative event stream, projections, accepted positioning and claim evidence, brand voice and naming rules, user-owned examples, and complete proposed canons. It queries the exact current canon version and revision, reviews pending complete proposals, validates internal references and claim IDs, and—when explicitly authorized and the verified runtime, event schema, and system catalog are available—appends events through registry-events.py. Accepted changes regenerate canon.md and versions.md as views. Its handoff records the brand ID, canon version or revision, event ID, superseded version, claim or proof pointers, unresolved contradictions, and one next skill.

  1. A brand owner needs the current canon version and its proof or claim pointers for a specific brand.
  2. A strategy team needs to replace an old canon with a complete new version while preserving replayable history.
  3. Multiple channel teams need one shared source for positioning, message hierarchy, voice, and naming rules.
  4. A reviewer needs to accept or reject a complete narrative-version proposal that may contain internal contradictions.

What are this skill's strengths and limitations?

Pros
  • Maintains one complete, versioned narrative canon per brand.
  • Preserves old versions in an append-only event stream for replay.
  • Covers positioning, message hierarchy, proof pointers, voice, naming rules, and conditional boilerplates.
  • Clearly separates narrative curation from TALE scoring, claim-truth adjudication, and narrative-system authoring.
Limitations
  • It does not author the narrative system, score TALE, or adjudicate claim truth.
  • Canonical writes depend on a verified runtime, event schema, system catalog, and host capability; standalone one-folder installs cannot append or project.
  • The supplied material provides no independent test-suite or per-platform verification evidence for this skill alone.

How do you install this skill?

Install the repository with Claude Code using /plugin marketplace add aaron-he-zhu/aaron-marketing-skills, followed by /plugin install aaron-marketing@aaron. Other Agent Skills-compatible hosts can use npx skills add aaron-he-zhu/aaron-marketing-skills, or you can run git clone https://github.com/aaron-he-zhu/aaron-marketing-skills. This skill is located at protocol/narrative-registry/SKILL.md.

How do you use this skill?

Example prompts include Show current canon version and proof/claim pointers for brand-acme and Record canon v3 as one complete atomic replacement, superseding v2. Explicit authorization is required before writes. Direct canonical mutations must include the current revision and use the host-capability-controlled owner-append flow. If the verified root runtime, schema, catalog, or host capability is unavailable, leave a bounded proposal rather than claiming canonical Narrative truth was written.

FAQ

Does it verify whether brand claims are true?
No. It records accepted claims and proof pointers but does not adjudicate claim truth. Unverified wording should remain `[needs source]` and become a separate claim proposal.
Can I edit canon.md or versions.md directly?
No. They are replaceable generated views. Canonical changes must be appended through the runtime event flow.
What happens if no canon exists yet?
The current canon is reported as Unknown, not as a quality verdict. Builders may use an explicitly authorized exploratory fallback, but cannot call it on-canon or publish-ready.

More skills from this repository

All from aaron-he-zhu/aaron-marketing-skills

Writing & Content

Brand Language Codifier

Turn a brand’s published language into reusable voice, lexicon, and product-naming rules.

Writing & Content

Narrative Quality Gate

Audit brand-narrative truth, system coherence, and effectiveness evidence as separate profiles.

Writing & Content

Proof Point Packager

Turn approved evidence into reusable proof assets placed beside the claims they support.

Writing & Content

Brand Story Bank Builder

Turn interviews and case material into reusable, source-aware brand story units.

Writing & Content

Brand Message System Architect

Build a durable brand hierarchy connecting the narrative, value pillars, proof points, tagline, and one-liner.

Writing & Content

Narrative Enablement Kit

Turn an approved brand canon into consistent elevator messaging, spokesperson answers, boilerplate, and language rules.

Writing & Content

Message Test Designer

Validate whether brand messages land with target buyers before scaling paid spend.

Writing & Content

Positioning Truth Tracer

Reconcile positioning claims with what the product can ship and prove, producing a defensible differentiation set.

Automation & Ops

Channel Registry

Maintain traceable records for owned social channels, voice adaptation, cadence, and UGC permissions.

Writing & Content

Narrative Cascade Planner

Map an approved brand narrative across every marketing surface and hand precise briefs to the teams that build them.

Writing & Content

Narrative Resonance Monitor

Measures whether a brand narrative is echoed in market language, AI answers, and public signals.

Writing & Content

Pitch Narrative Builder

Turn an approved brand canon into an evidence-linked fundraising or sales deck narrative.

Writing & Content

Offer & Claims Registry

Keep marketing claims and offers tied to exact wording, evidence, disclosures, terms, and review dates.

Writing & Content

Evergreen Social Calendar

Plan a capacity-aware social rhythm across channels, from content pillars to batching and evergreen recycling.

Writing & Content

Brand Voice Dossier Builder

Extract a reusable brand and founder voice system from the organization’s own content.

Writing & Content

Category Narrative Map

Reveal the category stories, competitor messaging, and shifts shaping your position.

Writing & Content

Audience Belief Mapper

Turn interview and win-loss evidence into a beachhead belief, objection, and switching-forces map.

Writing & Content

Narrative Baseline Mapper

Inventory what every owned brand surface says now, expose gaps against intended messaging, and freeze a baseline for future narrative-drift checks.

Writing & Content

Strategic Narrative Designer

Turn a market shift into a credible story from the old world to the promised land.

Writing & Content

Narrative Drift Monitor

Detects brand-message drift over time and identifies evidence-based triggers for repositioning.

Related skills