CtrlK
BlogDocsLog inGet started
Tessl Logo

brand-voice

Develop or document a complete brand voice and tone system covering voice attributes, tone shifts by context, vocabulary preferences, grammar rules, and copy examples. Use this skill whenever the user wants to define how a brand sounds, write a voice and tone document, audit existing copy for voice consistency, train a team or AI assistant on brand voice, or refine the personality of brand writing. Triggers on brand voice, voice and tone, tone of voice, writing voice, brand personality, copy voice, voice document, voice guidelines, how should we write, voice training, voice audit. Also triggers when the user has copy that 'feels off' and the underlying issue is voice, even if not stated explicitly. On a voice consistency check, this skill owns defining and documenting the voice system; use `editorial-qa` when a specific draft needs checking against an existing system before it publishes.

80

Quality

100%

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

The canonical home for this skill is brand-voice in rampstackco/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

100%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 lean, expert-level overview that offloads frameworks and the fillable template to two well-signaled, verified reference files. It provides fully actionable instruction via concrete counts, tables, example formats, a validation stress test, and a complete output spec, with essentially no filler or over-explanation.

DimensionReasoningScore

Conciseness

The body is dense with tables, checklists, and terse directives, and assumes Claude's competence throughout — it never explains what tone, grammar, or branding are. The prose present (e.g., "'Confident' alone produces swagger. 'Confident, not arrogant' tells writers where the line is", the 25-pair practical ceiling) conveys non-obvious domain judgment rather than padding, so every token earns its place rather than merely being efficient with minor trimmable spots.

5 / 5

Actionability

For an instruction-only skill the guidance is fully executable: concrete quantities ("Pick 3 to 5 attributes", "List 8 to 15 contexts", "The floor is 15 paired examples"), a 14-row tone-shift table, a bad/good/note example format, a fillable template with 15 content types, and a complete output spec (path `voice.md` with 7 named sections). Specific examples cover the common cases, matching the fully-executable anchor rather than the minor-gaps anchor at 4.

5 / 5

Workflow Clarity

The 9-step workflow is clearly sequenced with an explicit conditional entry point (step 1 routes from-zero brands through the frameworks reference and rejoins at step 2), concrete counts per step, and an explicit validation checkpoint with a pass threshold: "Score the result... 1 to 5 against each attribute, and anything scoring below 3 on any attribute is off-voice. Below 3 means the doc is incomplete." This is a clear sequence with explicit validation and recovery direction, not the minor-gaps pattern at 4.

5 / 5

Progressive Disclosure

The SKILL.md is a clean overview and all detailed material lives in two one-level-deep references (`references/voice-frameworks.md`, `references/voice-document-template.md`), both real files verified to contain the promised sections ("Choosing a framework" and the 15-type "Paired examples library"). References are signaled both inline at point of use and in a dedicated "Reference files" section with descriptions; the only other bundle file is frontmatter port metadata, which is not navigable content, so structure and navigation are clear throughout.

5 / 5

Total

20

/

20

Passed

Description

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

The description is exemplary: it states comprehensive concrete capabilities in third person, answers what and when explicitly, enumerates natural trigger phrases with synonyms and an unstated-need case, and includes explicit boundary guidance against the most confusable sibling skill. Its length comes entirely from trigger and deconfliction coverage, not padding.

DimensionReasoningScore

Specificity

The description lists comprehensive concrete actions: "Develop or document a complete brand voice and tone system covering voice attributes, tone shifts by context, vocabulary preferences, grammar rules, and copy examples," plus auditing copy for voice consistency, training a team or AI assistant, and refining brand personality. Every listed capability of the skill is explicitly stated with no coverage gaps, which matches the comprehensive multi-action anchor rather than the minor-gaps anchor at 4.

5 / 5

Completeness

Both questions are answered explicitly and concretely: the "what" is the develop/document capability list, and the "when" is spelled out via "Use this skill whenever the user wants to..." plus an explicit "Triggers on" enumeration. This matches the 5 anchor (both what and when with concrete trigger phrases) rather than the 4 anchor where the when clause could be more explicit.

5 / 5

Trigger Term Quality

"Triggers on brand voice, voice and tone, tone of voice, writing voice, brand personality, copy voice, voice document, voice guidelines, how should we write, voice training, voice audit" provides comprehensive natural-phrase coverage including synonyms and near-colloquial phrasings, and it additionally handles an unstated case ("copy that 'feels off'"). This is full synonym coverage, not the few-terms-missing pattern at 4.

5 / 5

Distinctiveness Conflict Risk

The skill has a clear niche (defining and documenting a brand voice system) with distinct triggers, and it explicitly deconflicts the nearest overlapping skill: "use `editorial-qa` when a specific draft needs checking against an existing system before it publishes." Explicit boundary guidance against the closest neighbor puts this at the minimal-conflict-risk anchor, not the minor-overlap-risk anchor at 4.

5 / 5

Total

20

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
rampstackco/claude-skills
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.