Agent skill

Narrative Quality Auditor

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

A skill your agent uses when the user asks to "audit our brand narrative" or "is this message on-canon"; runs separate typed TALE truth, system, or effectiveness profiles and never averages them…

Apache-2.0Auto-check passedMarketing & SEO

Install Narrative Quality Auditor

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

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

GitHub CLI
$ gh skill install aaron-he-zhu/aaron-marketing-skills narrative-quality-auditor --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/narrative/evaluate/narrative-quality-auditor .claude/skills/narrative-quality-auditor && 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-quality-auditor
GitHub stars
2.9k
Token cost
~2.2k tokens
SKILL.md length
792 words
Files
2 (incl. references)
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 "audit our brand narrative" or "is this message on-canon"; runs separate typed TALE truth, system, or effectiveness profiles and never averages them…

  • The user asks to audit our brand narrative
  • SKILL.md covers When This Must Trigger, Quick Start, Skill Contract and Data Sources, plus 9 more sections
  • Calls git
  • Is this message on-canon

What it does

Narrative Quality Auditor is an agent skill from aaron-he-zhu/aaron-marketing-skills. Use when the user asks to "audit our brand narrative" or "is this message on-canon"; runs separate typed TALE truth, system, or effectiveness profiles and never averages them into one composite. Checks differentiation, canon, landing consistency, and evidence integrity. Not for launch readiness — use launch-readiness-auditor; not for social operations — use social-quality-auditor. 品牌叙事分层审计/发布前一致性放行

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/auditor-runtime.md`). Compatibility notes: Claude Code and compatible agent-skill hosts

It sits in Marketing & SEO, covering Feature launches and release readiness. 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 audit our brand narrative
  • Is this message on-canon
  • Runs separate typed TALE truth
  • Effectiveness profiles and never averages them into one composite

Example prompts

  • “audit our brand narrative”
  • “is this message on-canon”
  • “/narrative-quality-auditor”

Requirements

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

What it can do on your machine

Read from SKILL.md and the folder at commit d5529cb. 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 Quality Auditor loads about 2.2k tokens when it runs, and up to ~6.4k if it reads all its reference files. Until then it costs about 107 tokens; SKILL.md has 792 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~107
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6.4k

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 d5529cb, republished under its Apache-2.0 licence (© aaron-he-zhu). 792 words, ~2,247 tokens.

Download SKILL.mdSave it as .claude/skills/narrative-quality-auditor/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
narrative-quality-auditor
description
Use when the user asks to "audit our brand narrative" or "is this message on-canon"; runs separate typed TALE truth, system, or effectiveness profiles and never averages them into one composite. Checks differentiation, canon, landing consistency, and evidence integrity. Not for launch readiness — use launch-readiness-auditor; not for social operations — use social-quality-auditor. 品牌叙事分层审计/发布前一致性放行
compatibility
Claude Code and compatible agent-skill hosts
slug
aaron-narrative-quality-auditor
displayName
Narrative Quality Auditor · 品牌叙事质量门
summary
叙事真实性/系统一致性/效果证据分层审计
version
20.1.0
license
Apache-2.0
homepage
https://github.com/aaron-he-zhu/aaron-marketing-skills
when_to_use
Use for narrative truth, message-system consistency, flagship pre-publish alignment, or measured message-effectiveness review. A full review runs linked…
argument-hint
<canon/surfaces/experiment> [truth|system|effectiveness|full]
class
auditor
metadata.author
aaron-he-zhu

Narrative Quality Auditor

Audit narrative truth, message-system coherence, or measured effectiveness as separate TALE profiles. There is no v18 overall composite: truth cannot be averaged away by coherence, and coherence cannot stand in for effectiveness evidence.

When This Must Trigger

  • The user asks whether positioning/differentiation is defensible.
  • A flagship surface needs a pre-publish canon/message-match gate.
  • A message experiment or resonance claim needs evidence-integrity review.
  • A full narrative review is requested; run linked profiles rather than one blended score.

Quick Start

text
Run TALE truth on canon v7 against named alternatives and approved claims.
Run TALE system on homepage/pricing/deck against canon v7 before release.
Run a full review as three linked profile results; do not compute an overall score.

Skill Contract

Reads: one canon/surface set or message experiment plus current narrative/claims truth. Writes: only permissioned v3 artifacts. Done when: each requested profile is independently complete or its Unknowns are explicit, with no canon, claims, or surface mutation.

narrative-registry owns canon/version state and offer-claims-registry owns claims. This skill judges; authoring/fixing belongs to Trace/Architect/Land skills.

Data Sources

NeedPreferred evidence
TruthNamed alternatives, interviews/win-loss, product reality, claims projection
ArchitectureExact canon/version, message hierarchy, voice/naming/version history
LandingDeclared rendered flagship surfaces linked to canon version
EffectivenessPreregistered comprehension/recall/behavior evidence and locked panels
Public resonanceDated own/public signals with explicit measured/proxy provenance

Instructions

Runtime Reads
  • ../../../references/auditor-runbook.md
  • ../../../references/scoring-semantics.md
  • ../../../references/tale-benchmark.md
  • ../../../references/runtime-invocation.md
  • references/auditor-runtime.md
Runtime and Setup

Read ../../../references/auditor-runbook.md, scoring-semantics.md, tale-benchmark.md, and the TALE catalog entry. Standalone installs use bundled immutable references/auditor-runtime.md; never fetch mutable main. Before deterministic calls, follow runtime-invocation.md, resolve AARON_SKILLS_ROOT="${CLAUDE_PLUGIN_ROOT:-$(git rev-parse --show-toplevel 2>/dev/null || true)}", and require the scorer, validator, and typed catalogs. If unavailable, still collect the selected profile's typed observations and Unknowns, but return score_state: NOT_SCORED / score_confidence: not_scored with no gate verdict or persistent artifact; runtime absence blocks deterministic scoring, not the observation pass.

Declare target, profile/mode, brand scope, market, audience, canon version, observation date, and evidence window.

Profile Procedure
  • truth: score T1–T10 for material differentiation and factual grounding.
  • system: score A1–A10 and L1–L10 for canon coherence and landing consistency.
  • effectiveness: score E1–E10 for one experiment/locked panel/date.
  • full: run the three profiles independently and keep three artifacts/results. Aggregate release language conservatively: any BLOCK → block; otherwise any UNDECIDED → undecided; otherwise any FIX → fix; all SHIP → ship. Never average scores.

For a flagship pre-publish gate, always execute the system profile procedure and require a compatible current truth result. If no compatible truth result exists, run truth separately when its evidence is available; otherwise record the truth prerequisite as Unknown while still rendering the requested system-profile result. A missing scorer/runtime changes that result to NOT_SCORED/UNDECIDED; it does not justify skipping the profile. Run effectiveness separately only when the user requests it or the surface makes an effectiveness claim.

Every observed state needs source/date/type/confidence. A missing canon is Unknown, not N/A. A2/A4/A8 are conditional: three pillars, a change arc, and fixed boilerplate lengths are patterns only when deliberately chosen. Run the typed scorer per profile.

Verify profile-relevant vetoes: TALE-T1 false/contradictory/unsubstantiated material differentiation, TALE-A1 demonstrated canon contradiction, TALE-L1 material flagship/canon contradiction, and TALE-E1 unsupported effectiveness claim or proxy-as-measured.

Show full SKILL.md (322 more words)Show less

§2 TALE Worked Examples

  • Complete truth profile, raw 86, no veto/fail: DONE/SHIP, final 86.
  • Complete system profile, raw 80, one verified L1 failure: DONE_WITH_CONCERNS/FIX, final 59.
  • Complete system profile with A1 and L1 failures: DONE/BLOCK, no final score.
  • Effectiveness profile before test results exist: NEEDS_INPUT/UNDECIDED, no score.

§3 TALE Guardrails

  • A literal “onlyness” sentence is not required; judge the material differentiation actually asserted.
  • Three pillars, a Raskin/change arc, and 25/50/100-word boilerplates are conditional patterns.
  • A governed draft can be audited as a draft; missing access is Unknown, not an A1 failure.
  • Share of voice, sentiment, answer-engine descriptions, comprehension, and behavior are distinct constructs.
  • Narrative change frequency is a drift signal, not an automatic veto.

§5 TALE Translation

Always name truth/system/effectiveness. On trace request, qualify TALE-T1/A1/L1/E1, especially TALE-E1 versus ECHO-E1 and TALE-A1 versus ROAS/RAMP.

Report and Verdict

Begin with the auditor-runbook's exact typed conversation header. Never replace status, verdict, or score_state with prose; list each explicitly missing qualified item as ``ID: `unknown``` before findings.

For each profile show verdict, target/canon/context/date, score or coverage/interval, confidence, evidence, Unknowns, and fixes. A full report shows three side-by-side results and no overall number. Do not claim market effectiveness from system coherence.

Validation Checkpoints

  • One profile/unit per score; full mode preserves three results.
  • Canon/surface/experiment versions and audience/market are explicit.
  • Conditional templates use N/A only with reason; missing evidence stays Unknown.
  • Current truth/claims projections are read, not candidate files.
  • No canon/claim/surface write or publish action occurred.

Persistence

Persist only after explicit authorization to memory/audits/narrative/YYYY-MM-DD-<topic>-<profile>.md. Preserve the scorer's orthogonal status and verdict; validate the complete v3 draft with validate-audit-artifact.py against the intended relative path, persist only through one full-content Write, and revalidate the target per the auditor runbook. Edit/shell/MCP mutations of the reserved sink are unsupported. Never overwrite another profile or update canon/claims/hot cache autonomously.

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

SKILL.md and 1 other file (references) in narrative/evaluate/narrative-quality-auditor of aaron-he-zhu/aaron-marketing-skills.

  • SKILL.md
  • references/auditor-runtime.md

Open the folder on GitHubat commit d5529cb

Compare with similar skills

Narrative Quality Auditor 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 Quality Auditor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Narrative Quality Auditor this skillaaron-he-zhu/aaron-marketing-skills2.9k—~2.2kAutomated safety check: PassApache-2.0
Mvp Launchooiyeefei/ccc495—~1.1kAutomated safety check: PassMIT
60 Launch Playbook Globalminhnv0807/ai-business-skills609—~3kAutomated safety check: PassMIT
Launch Planning Frameworksslgoodrich/agents139—~3.2kAutomated safety check: PassCustom licence
Experimentationandreaskelm/pm-brain234—~2.3kAutomated safety check: PassCustom licence
Deliver Launch Checklistproduct-on-purpose/pm-skills716—~970Automated safety check: PassApache-2.0

Similar skills

  • Mvp Launch

    ooiyeefei/ccc

    Web app MVP launch checklist knowledge. An agent skill from ooiyeefei/ccc.

    495 GitHub stars~1.1k tokensUpdated 2 mo ago
    Marketing & SEOAuto-check passed
  • 60 Launch Playbook Global

    minhnv0807/ai-business-skills

    A skill your agent uses when a launch needs a repeatable EXECUTION playbook — a T-30 to D+7 timeline, per-function checklists for content, design, ads, sales, and engineering, a launch-day war room…

    609 GitHub stars~3k tokensUpdated 29 days ago
    Marketing & SEOAuto-check passed
  • Launch planning frameworks including tiered launches, timelines, checklists, and go/no-go decisions.

    139 GitHub stars~3.2k tokensUpdated 6 mo ago
    Marketing & SEOAuto-check passed
  • Experimentation

    andreaskelm/pm-brain

    Design and run product experiments at a practical PM level — A/B tests, hypothesis tests, rollouts, feature flags, and reading results without pretending to be a statistician.

    234 GitHub stars~2.3k tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • Deliver Launch Checklist

    product-on-purpose/pm-skills

    Creates a cross-functional pre-launch checklist covering engineering, design, marketing, support, legal, and operations readiness, with owners, dates, and go/no-go criteria so nothing is missed…

    716 GitHub stars~970 tokensUpdated 3 days ago
    Marketing & SEOAuto-check passed
  • Book Market Research

    robertguss/claude-code-toolkit

    Assess commercial viability of book concepts for Amazon KDP self-publishing.

    124 GitHub stars~2.4k tokensUpdated 25 days 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

Questions about Narrative Quality Auditor

What does Narrative Quality Auditor do?

A skill your agent uses when the user asks to "audit our brand narrative" or "is this message on-canon"; runs separate typed TALE truth, system, or effectiveness profiles and never averages them…. Narrative Quality Auditor is an agent skill from aaron-he-zhu/aaron-marketing-skills. Use when the user asks to "audit our brand narrative" or "is this message on-canon"; runs separate typed TALE truth, system, or effectiveness profiles and never averages them into one composite.

When should I use Narrative Quality Auditor?

Narrative Quality Auditor fits situations like: the user asks to audit our brand narrative; is this message on-canon; runs separate typed TALE truth; effectiveness profiles and never averages them into one composite.

How do I install Narrative Quality Auditor in Claude Code?

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

How do I install Narrative Quality Auditor in Codex?

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

Can I use Narrative Quality Auditor 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-quality-auditor -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-quality-auditor, .gemini/skills/narrative-quality-auditor, .github/skills/narrative-quality-auditor and .opencode/skills/narrative-quality-auditor in your project.

What does Narrative Quality Auditor need to run?

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

Does Narrative Quality Auditor 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 Quality Auditor 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 Quality Auditor use?

Narrative Quality Auditor 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 Quality Auditor use?

About 2.2k tokens (SKILL.md is roughly 9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 4.2k tokens, read only when the agent opens those files.

What are the alternatives to Narrative Quality Auditor?

Skills that share tags, products or a category with Narrative Quality Auditor: Mvp Launch (ooiyeefei/ccc, 495 stars), 60 Launch Playbook Global (minhnv0807/ai-business-skills, 609 stars), Launch Planning Frameworks (slgoodrich/agents, 139 stars) and Experimentation (andreaskelm/pm-brain, 234 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Narrative Quality Auditor?

aaron-he-zhu (a GitHub user) maintains it in aaron-he-zhu/aaron-marketing-skills, which has 2,898 GitHub stars. The repository holds 119 skills in this directory. The repository was last updated on October 11, 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.