CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

brand-language-codifier

Use when the user asks to "codify our brand voice", "define naming rules for our products and tiers", or "write the tone-of-voice guide with banned phrases"; produces the brand-level voice canon (register, tone spectrum, banned-phrase list, few-shot examples drawn only from the brand's own published material) and the naming tax (product / feature / tier naming rules plus approved and banned terms) that seeds the narrative-registry canon and that every channel's voice adaptation points up to. Not for per-platform voice adaptation — use channel-registry's voice-dossier; not for finished copy or blog posts — use content-writer; not for the message hierarchy itself — use message-system-architect; not for claim adjudication — use offer-claims-registry. 品牌语气/词汇表/命名税/禁用词/品牌语言规范

Quality

84%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

73%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.

The body is a well-sequenced, highly actionable workflow with strong validation gates and clear handoffs, weakened mainly by heavy verbatim repetition of the registry-proposal governance formula across five sections. Consolidating that boilerplate and showing one concrete registry-events.py request example would tighten it considerably.

Suggestions

State the authorized `operation: propose` request pattern (and the registry-events.py invocation) once in the Skill Contract or a linked reference and refer to it as 'the propose request' elsewhere, instead of repeating the full formula ~7 times.

Show one concrete example of the propose request payload for a voice rule or naming-tax entry, so step 7 is executable rather than descriptive.

Deduplicate the next-skill guidance: story-bank-builder and the termination/handoff mechanics each appear in multiple sections — keep them in 'Next Best Skill' and 'Termination' only.

DimensionReasoningScore

Conciseness

The body never explains concepts Claude already knows, but the governance formula "via an authorized `operation: propose` request to `registry-events.py`" is repeated verbatim about seven times, and the channel-registry-points-up relationship and the next-skill handoff are each restated across the intro, Skill Contract, Instructions, Save Results, and Termination sections. Mostly efficient but could be tightened substantially; not 2 because there is no conceptual padding or filler prose, only duplicated operational boilerplate.

3 / 5

Actionability

Seven numbered steps give concrete, executable guidance: deliverable specs (tone spectrum as 2-4 named-pole dials, 3-6 few-shot before/after examples, approved/banned-terms tables with Measured/User-provided/Estimated labels), exact memory paths, and a Done-when checklist. Not 5 because the `registry-events.py` invocation is referenced repeatedly but never shown as a concrete command or request payload, and the few-shot examples are specified but not exemplified.

4 / 5

Workflow Clarity

Steps 1-7 are clearly sequenced with explicit validation gates: stop with `NEEDS_INPUT` and route upstream if the message house is absent (step 1), reject competitor copy (step 2), check new rules against the shipped canon and route contradictions to narrative-registry rather than editing in place (step 6), plus a Done-when checklist. Feedback loops for the risky operations (canon writes, memory writes) are present; not 4 because the checkpoints are explicit rather than implicit.

5 / 5

Progressive Disclosure

The body has well-organized sections (Quick Start, Skill Contract, Data Sources, Instructions, Save Results, Reference Materials, Next Best Skill) and a clearly signaled one-level-deep reference list with one-line descriptions per file. Not 5 because no bundle files ship with the skill, references point to paths outside the bundle that cannot be verified here, and the repeated governance prose (propose-request mechanics, handoff shape) is inlined in multiple sections where a single referenced contract section would do.

4 / 5

Total

16

/

20

Passed

Description

92%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 dense, highly specific description with explicit trigger phrases, a complete statement of both output blocks, and unusually good negative-boundary disambiguation against sibling skills. The only weakness is moderate length and missing a few common synonyms (e.g. "brand guidelines", "style guide") among the trigger terms.

DimensionReasoningScore

Specificity

Quotes concrete actions ("codify our brand voice", "define naming rules for our products and tiers", "write the tone-of-voice guide with banned phrases") and enumerates the exact deliverables: register, tone spectrum, banned-phrase list, few-shot examples from own published material, and the naming tax with product/feature/tier rules plus approved and banned terms. Comprehensive coverage with no generic filler; not score 4 because coverage of the two output blocks is complete rather than having minor gaps.

5 / 5

Completeness

Explicitly answers "when" ("Use when the user asks to ..." with three concrete trigger phrases) and "what" (the voice canon and naming tax with their components), plus negative boundaries ("Not for per-platform voice adaptation ... not for finished copy ..."). Clearly matches the anchor-5 example structure; not 4 because both what and when are fully explicit with concrete triggers.

5 / 5

Trigger Term Quality

The quoted phrases ("codify our brand voice", "tone-of-voice guide", "naming rules", "banned phrases") are natural things a user would say, with Chinese keywords appended for bilingual reach. Not 5 because common synonyms like "brand guidelines", "style guide", or "brand book" are missing; not 3 because several natural trigger phrasings are already present rather than merely relevant keywords.

4 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche (brand-level voice canon and naming tax) and explicitly routes adjacent intents to four other skills (channel-registry, content-writer, message-system-architect, offer-claims-registry). Minimal conflict risk; not 4 because the disambiguation is already explicit rather than leaving minor overlap.

5 / 5

Total

19

/

20

Passed

Validation

75%

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

Validation — 12 / 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: 27 suspicious

Warning

referenced_paths_exist

Referenced path issues: 2 missing, 2 deeper-than-1-level

Warning

Total

12

/

16

Passed

Repository

aaron-he-zhu/aaron-marketing-skills

Path

narrative/architect/brand-language-codifier/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.