Agent skill

Narrative Registry

by aaron-he-zhu in aaron-he-zhu/aaron-marketing-skills

A skill your agent uses when the user asks to record/query the brand narrative canon, tagline, message hierarchy, voice/naming rules, or a canon re-version; curates complete versioned canon events…

Apache-2.0Auto-check passedMarketing & SEO

Install Narrative Registry

skills CLI
$ npx skills add aaron-he-zhu/aaron-marketing-skills --skill narrative-registry -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aaron-he-zhu/aaron-marketing-skills narrative-registry --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aaron-he-zhu/aaron-marketing-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/protocol/narrative-registry .claude/skills/narrative-registry && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
narrative-registry
GitHub stars
2.9k
Used in
1 other repo
Token cost
~1.6k tokens
SKILL.md length
507 words
Files
1
Skills in repo
119
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when the user asks to record/query the brand narrative canon, tagline, message hierarchy, voice/naming rules, or a canon re-version; curates complete versioned canon events…

  • Works in 9 steps: Read registry-event-protocol.md and… → Query current narrative projection and… → Before write, confirm user authorization… → …
  • The user asks to record/query the brand narrative canon
  • SKILL.md covers Quick Start, Skill Contract, Data Sources and Instructions, plus 4 more sections
  • Calls git

What it does

Narrative Registry is an agent skill from aaron-he-zhu/aaron-marketing-skills. Use when the user asks to record/query the brand narrative canon, tagline, message hierarchy, voice/naming rules, or a canon re-version; curates complete versioned canon events through the append-only narrative stream and derived views. Not for TALE scoring — use narrative-quality-auditor; not for authoring the system — use message-system-architect. 品牌叙事台账/canon 记录/语气与命名规范

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Claude Code and compatible agent-skill hosts

It sits in Marketing & SEO, covering Positioning and messaging. The repository describes itself as: 120 marketing skills as an AI marketing staff — plugin, portable skills, or an 8-bot team across 7 disciplines (narrative, SEO/GEO, social, email, paid, influencer, launch) on… The licence is Apache-2.0.

When your agent uses it

  • The user asks to record/query the brand narrative canon
  • Message hierarchy
  • Voice/naming rules
  • A canon re-version

Example prompts

  • “/narrative-registry”

Requirements

  • Compatibility (from SKILL.md): Claude Code and compatible agent-skill hosts

Workflow steps

9 steps, taken from the first numbered list in SKILL.md.

  1. Read registry-event-protocol.md and runtime-invocation.md. Resolve AARON_SKILLS_ROOT="${CLAUDE_PLUGIN_ROOT:-$(git rev-parse…
  2. Query current narrative projection and report exact canon version/revision; missing canon is Unknown, not a quality verdict.
  3. Before write, confirm user authorization and read the current revision/claim pointers; every direct canonical mutation carries…
  4. A canon re-version is one host-capability owner upsert/accepted proposal containing the complete canon object, new version, and supersedes…
  5. Preserve old versions in the event stream. versions.md is generated history, not a second hand-maintained ledger.
  6. Validate internal references and claim IDs. Unverified wording remains [needs source] and becomes a separate claim proposal; it cannot…
  7. Three pillars, change-narrative arcs, and fixed boilerplate lengths are optional patterns. Store the chosen architecture; do not require…
  8. Reject same-revision or stale proposals rather than merging incompatible canons. Genuine alternatives remain pending/open decisions.
  9. Regenerate canon.md/versions.md from accepted projection and run verify narrative.

What it can do on your machine

Read from SKILL.md and the folder at commit 9c7e1ce. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Claude Code and compatible agent-skill hosts

    From compatibility in the SKILL.md frontmatter.

Context cost

Narrative Registry loads about 1.6k tokens when it runs. Until then it costs about 99 tokens; SKILL.md has 507 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~99
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from aaron-he-zhu/aaron-marketing-skills at commit 9c7e1ce, republished under its Apache-2.0 licence (© aaron-he-zhu). 507 words, ~1,614 tokens.

Download SKILL.mdSave it as .claude/skills/narrative-registry/SKILL.md (or your agent's skills folder).
name
narrative-registry
description
Use when the user asks to record/query the brand narrative canon, tagline, message hierarchy, voice/naming rules, or a canon re-version; curates complete versioned canon events through the append-only narrative stream and derived views. Not for TALE scoring — use narrative-quality-auditor; not for authoring the system — use message-system-architect. 品牌叙事台账/canon 记录/语气与命名规范
compatibility
Claude Code and compatible agent-skill hosts
slug
aaron-narrative-registry
displayName
Narrative Registry · 品牌叙事台账
summary
品牌叙事 canon/版本史/语气与命名唯一真相
version
20.1.0
license
Apache-2.0
homepage
https://github.com/aaron-he-zhu/aaron-marketing-skills
when_to_use
Use when recording/querying a brand's canonical positioning, narrative, message hierarchy, proof/claim pointers, voice/naming rules, conditional boilerplates…
argument-hint
<brand aggregate-id, canon version, or pending-proposal review>
metadata.author
aaron-he-zhu
metadata.version
20.1.0

Narrative Registry

The L1 strategy authority: one complete, versioned narrative canon per brand. Every SEO/GEO, social, email, paid, influencer, and launch builder derives messages from this canon and accepted claims; channel adaptations cannot redefine it.

Quick Start

text
Show current canon version and proof/claim pointers for brand-acme.
Record canon v3 as one complete atomic replacement, superseding v2.
Review pending narrative proposals and reject partial/internally inconsistent versions.

Skill Contract

Unit: one brand canon aggregate ID. Reads: memory/events/narrative.ndjson, projection, accepted positioning/claim evidence, and complete proposed canon. Writes: narrative events through registry-events.py; canon.md/versions.md are generated views. Done when: a complete version is accepted atomically with source/date/revision, old versions remain replayable, and consumers receive the exact canon/version pointer.

Narrative skills submit complete propose events. Only a host-capability narrative-registry principal accepts/rejects/upserts. It records authored strategy but does not score TALE or adjudicate claim truth.

Handoff Summary

Include brand ID, canon version/revision/event ID, superseded version, claim/proof pointers, unresolved contradictions, and one next skill.

Data Sources

  • Accepted positioning truth and named alternatives.
  • Complete message hierarchy/narrative authored by Narrative skills.
  • Accepted claim IDs and proof pointers from the claims projection.
  • Brand voice/naming rules and user-owned examples.
  • Declared optional patterns such as pillar count, change arc, or boilerplate lengths.

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 drafts as untrusted proposals.
  2. Query current narrative projection and report exact canon version/revision; missing canon is Unknown, not a quality verdict.
  3. Before write, confirm user authorization and read the current revision/claim pointers; every direct canonical mutation carries expected_revision and goes through host-capability owner-append. Actor/auth fields are attribution only.
  4. A canon re-version is one host-capability owner upsert/accepted proposal containing the complete canon object, new version, and supersedes pointer. Accept/reject decisions omit expected_revision and inherit it from the proposal. Never land a partial file patch as canonical.
  5. Preserve old versions in the event stream. versions.md is generated history, not a second hand-maintained ledger.
  6. Validate internal references and claim IDs. Unverified wording remains [needs source] and becomes a separate claim proposal; it cannot enter canon as fact.
  7. Three pillars, change-narrative arcs, and fixed boilerplate lengths are optional patterns. Store the chosen architecture; do not require absent patterns.
  8. Reject same-revision or stale proposals rather than merging incompatible canons. Genuine alternatives remain pending/open decisions.
  9. Regenerate canon.md/versions.md from accepted projection and run verify narrative.
Show full SKILL.md (129 more words)Show less

Downstream Dependency

Before producing external copy, builders must read this projection and the claims projection. Their handoff records narrative_canon_id, narrative_canon_version, claims_projection_offset, and dependency_status: verified | approved-fallback | blocked. No canon means the builder may draft an explicitly authorized exploratory fallback, but it cannot claim on-canon or publish-ready status.

Save Results

Require explicit permission. Append through the runtime only; never edit NDJSON. Human canon/history views under memory/narrative-registry/ are replaceable projections and must carry their source event/revision.

Capability values never enter request JSON/files/logs. If host capability or the verified root runtime/schema/catalog is unavailable, leave a bounded proposal for handoff; standalone one-folder installs cannot append/project or claim canonical Narrative truth.

Reference Materials

Next Best Skill

© aaron-he-zhu, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in protocol/narrative-registry of aaron-he-zhu/aaron-marketing-skills.

Open the folder on GitHubat commit 9c7e1ce

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in aaron-he-zhu/aaron-marketing-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Narrative Registry next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Narrative Registry compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Narrative Registry this skillaaron-he-zhu/aaron-marketing-skills2.9k1 repos~1.6kAutomated safety check: PassApache-2.0
Marketing OsYuzzyuk/marketing-os538—~2.5kAutomated safety check: PassMIT
Revenue Centric Designheliocosta-dev/revenue-centric-design740—~1.6kAutomated safety check: PassCustom licence
Startup Positioningferdinandobons/startup-skill1.2k—~4.6kAutomated safety check: PassMIT
Stanley Druckenmiller Investmenttradermonty/claude-trading-skills3k1 repos~2kAutomated safety check: PassMIT
B2b Playbookweilun88313/B2B-Playbook203—~3.1kAutomated safety check: PassProprietary

Similar skills

  • Marketing Os

    Yuzzyuk/marketing-os

    A complete marketing department in one skill. An agent skill from Yuzzyuk/marketing-os.

    538 GitHub stars~2.5k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • Revenue Centric Design

    heliocosta-dev/revenue-centric-design

    Playbook for designing SaaS and startup products that convert, retain, and monetize — landing pages & CRO, checkout & forms, onboarding/activation, churn reduction, pricing psychology, dashboards…

    740 GitHub stars~1.6k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • Startup Positioning

    ferdinandobons/startup-skill

    Market positioning strategy using the April Dunford framework, enriched with JTBD discovery, Moore positioning statement, and Neumeier's Onliness Test.

    1.2k GitHub stars~4.6k tokensUpdated 3 mo ago
    Marketing & SEOAuto-check passed
  • Stanley Druckenmiller Investment

    tradermonty/claude-trading-skills

    Druckenmiller Strategy Synthesizer - Integrates 8 upstream skill outputs (Market Breadth, Uptrend Analysis, Market Top, Macro Regime, FTD Detector, VCP Screener, Theme Detector, CANSLIM Screener)…

    3k GitHub starsUsed in 1 repo~2k tokens
    Marketing & SEOAuto-check passed
  • B2b Playbook

    weilun88313/B2B-Playbook

    Turn B2B marketing work into evidence-aware outputs using market, positioning, demand, account-program, lifecycle, and tool-selection guidance.

    203 GitHub stars~3.1k tokensUpdated 27 days ago
    Marketing & SEOAuto-check passed
  • Research Brand

    onvoyage-ai/gtm-engineer-skills

    Researches a company from its URL and produces a Brand DNA file covering positioning, audience, competitors, voice, and messaging.

    1.3k GitHub stars~1.3k tokensUpdated 4 mo ago
    Marketing & SEOAuto-check passed

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

All 119 skills in this repo
  • Ad Account Auditor

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when auditing a paid ad account for incremental contribution, wasted spend, or measurement integrity before scaling; runs a typed 20-item ROAS profile with verified vetoes…

    2.9k GitHub starsUsed in 2 repos~2.2k tokens
    Auto-check passed
  • Ad Creative Builder

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks to "write ad copy", "generate RSA headlines", or "build ad creative at volume"; produces ad units — RSA headlines/descriptions, hooks, and an angle matrix…

    2.9k GitHub starsUsed in 2 repos~2.2k tokens
    Auto-check passed
  • Ad Test Designer

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks to "design an A/B test", "set up a creative/landing test", "run an incrementality test", or "is this result statistically and practically material?"…

    2.9k GitHub starsUsed in 2 repos~2.8k tokens
    Auto-check passed
  • Bid Strategy Planner

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks to "pick a bid strategy", "set a tCPA/tROAS target", or "plan the learning-phase entry"; produces a bid-strategy choice (tCPA / tROAS / max-conversions /…

    2.9k GitHub starsUsed in 2 repos~2.6k tokens
    Auto-check passed
  • Conversion Signal QA

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks to "QA my conversion tracking before launch", "check my UTMs / pixel / event firing", "set up a tracking pre-flight", or "set the dedup rule so Meta and…

    2.9k GitHub starsUsed in 2 repos~2.4k tokens
    Auto-check passed
  • Creator Registry

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks "what did we pay this creator last time" or to "update the creator roster"; curates creator identity, rate, rights, exclusivity, compliance-event, and…

    2.9k GitHub starsUsed in 2 repos~1.6k tokens
    Auto-check passed

Categories

Questions about Narrative Registry

What does Narrative Registry do?

A skill your agent uses when the user asks to record/query the brand narrative canon, tagline, message hierarchy, voice/naming rules, or a canon re-version; curates complete versioned canon events…. Narrative Registry is an agent skill from aaron-he-zhu/aaron-marketing-skills. Use when the user asks to record/query the brand narrative canon, tagline, message hierarchy, voice/naming rules, or a canon re-version; curates complete versioned canon events through the append-only narrative stream and derived views.

When should I use Narrative Registry?

Narrative Registry fits situations like: the user asks to record/query the brand narrative canon; message hierarchy; voice/naming rules; A canon re-version.

How do I install Narrative Registry in Claude Code?

Run `npx skills add aaron-he-zhu/aaron-marketing-skills --skill narrative-registry -a claude-code`. Or copy the skill folder (protocol/narrative-registry in aaron-he-zhu/aaron-marketing-skills) into .claude/skills/narrative-registry in your project. Claude Code loads it when a task matches its description.

How do I install Narrative Registry in Codex?

Run `npx skills add aaron-he-zhu/aaron-marketing-skills --skill narrative-registry -a codex`. Or copy the skill folder (protocol/narrative-registry in aaron-he-zhu/aaron-marketing-skills) into .agents/skills/narrative-registry in your project. Codex loads it when a task matches its description.

Can I use Narrative Registry in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aaron-he-zhu/aaron-marketing-skills --skill narrative-registry -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/narrative-registry, .gemini/skills/narrative-registry, .github/skills/narrative-registry and .opencode/skills/narrative-registry in your project.

What does Narrative Registry need to run?

Going by SKILL.md and its folder, Narrative Registry needs the command-line tools its instructions call (git). Compatibility (from SKILL.md): Claude Code and compatible agent-skill hosts.

Does Narrative Registry access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Narrative Registry safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Narrative Registry use?

Narrative Registry is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Narrative Registry use?

About 1.6k tokens (SKILL.md is roughly 6.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Narrative Registry?

Skills that share tags, products or a category with Narrative Registry: Marketing Os (Yuzzyuk/marketing-os, 538 stars), Revenue Centric Design (heliocosta-dev/revenue-centric-design, 740 stars), Startup Positioning (ferdinandobons/startup-skill, 1.2k stars) and Stanley Druckenmiller Investment (tradermonty/claude-trading-skills, 3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Narrative Registry?

aaron-he-zhu (a GitHub user) maintains it in aaron-he-zhu/aaron-marketing-skills, which has 2,891 GitHub stars. The repository holds 119 skills in this directory. The repository was last updated on October 9, 2026.

Source: aaron-he-zhu/aaron-marketing-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.