CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

narrative-quality-auditor

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. 品牌叙事分层审计/发布前一致性放行

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

75%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-engineered, instruction-dense auditor skill: typed profiles, explicit veto rules, a fail-closed no-scraper branch, worked examples, and explicit validation and persistence contracts with read-only safety guarantees. Its weaknesses are redundancy in reference listings, orphaned section numbering (§2/§3/§5), and several referenced materials that do not exist within the standalone bundle.

Suggestions

Deduplicate the reference listings: the same files appear under 'Runtime Reads', again in prose in 'Runtime and Setup', and a third time in 'Reference Materials' — consolidate into one clearly signaled list and drop the duplicated prose sentence.

Fix or renumber the orphaned headings (§2 TALE Worked Examples, §3 TALE Guardrails, §5 TALE Translation) so the document does not imply missing §1/§4 sections.

For standalone installs where '../../../references/*' do not exist, inline the essential scorer invocation shape (or the path to validate-audit-artifact.py) or explicitly mark which referenced files are plugin-install-only, so the fail-closed branch is executable from this bundle alone.

DimensionReasoningScore

Conciseness

The body is dense and lean with no explanations of concepts Claude already knows — every section adds skill-specific rules (veto IDs, aggregation policy, persistence contract). It falls short of 5 because the runtime reads are listed twice ('### Runtime Reads' then restated in prose under '### Runtime and Setup', with 'tale-benchmark.md' and 'auditor-runbook.md' appearing three times via '## Reference Materials') and those redundancies could be trimmed.

4 / 5

Actionability

Concrete, specific guidance dominates: exact item ranges ('score T1–T10', 'A1–A10 and L1–L10', 'E1–E10'), named vetoes ('TALE-T1', 'TALE-A1', 'TALE-L1', 'TALE-E1'), an explicit aggregation rule ('any BLOCK → block; otherwise any UNDECIDED → undecided...'), a persistence path template, and a shell env resolution expression. It stops short of 5 because the deterministic scorer invocation and `validate-audit-artifact.py` are named but their executable paths/commands are not given in this bundle, deferring to files not present here.

4 / 5

Workflow Clarity

The sequence is coherent — trigger conditions, quick start, runtime setup with a fail-closed branch ('If unavailable... return score_state: NOT_SCORED'), profile procedures, vetoes, report format, '## Validation Checkpoints', and a persistence step with validate → single Write → revalidate feedback loop. It does not reach 5 because the mid-document numbered sections (§2, §3, §5 with no §1/§4) suggest displaced structure, and key execution details live in external runbook files rather than inline checkpoints.

4 / 5

Progressive Disclosure

The body is an appropriately sized overview pointing to detailed materials, and the one bundled reference (references/auditor-runtime.md, 571 lines, self-contained) is one level deep and explicitly designated as the standalone fallback ('Standalone installs use bundled immutable references/auditor-runtime.md'). It stays at 4 rather than 5 because five of six referenced files ('../../../references/auditor-runbook.md', 'scoring-semantics.md', 'tale-benchmark.md', 'runtime-invocation.md', 'measurement-protocol.md') resolve only in a full plugin install and are absent from this bundle, and the reference listings are duplicated across three sections.

4 / 5

Total

16

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: explicit 'Use when...' triggers in the user's own words, third-person concrete capability statements, and explicit redirects to sibling auditors. The only weakness is that the capability verbs stay at a domain-abstract level ('checks differentiation') rather than enumerating the concrete checks performed.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'runs separate typed TALE truth, system, or effectiveness profiles', 'Checks differentiation, canon, landing consistency, and evidence integrity' — with only minor gaps in coverage. It falls short of the 5 anchor because the actions remain audit-domain abstractions rather than fully enumerated concrete operations, but clearly exceeds the 3 anchor's '1-2 concrete actions'.

4 / 5

Completeness

It explicitly answers both questions with concrete trigger phrases: 'what' via 'runs separate typed TALE truth, system, or effectiveness profiles... Checks differentiation, canon, landing consistency, and evidence integrity' and 'when' via the opening 'Use when the user asks to...'. This matches the anchor-5 example pattern ('Extract text... Use when working with...') exactly; anchor 4 would require the 'when' to be less explicit.

5 / 5

Trigger Term Quality

It includes natural user phrases like '"audit our brand narrative"' and '"is this message on-canon"' plus negative triggers ('Not for launch readiness', 'not for social operations'). A few natural terms users might say are missing (e.g., 'messaging', 'positioning', 'brand story'), so it matches anchor 4 rather than the comprehensive synonym coverage of anchor 5, but is well above the sparse keyword coverage of anchor 3.

4 / 5

Distinctiveness Conflict Risk

It carves out a clear niche with explicit negative scoping — 'Not for launch readiness — use launch-readiness-auditor; not for social operations — use social-quality-auditor' — minimizing conflict risk. This is stronger than anchor 4's 'minor overlap risk with closely related skills' because wrong-skill triggers are actively redirected.

5 / 5

Total

18

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 9 suspicious

Warning

Total

13

/

16

Passed

Repository

aaron-he-zhu/aaron-marketing-skills

Path

narrative/evaluate/narrative-quality-auditor/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.