CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

brand-guidelines

Write copy following Sentry brand guidelines. Use when writing UI text, error messages, empty states, onboarding flows, 404 pages, documentation, marketing copy, or any user-facing content. Covers both Plain Speech (default) and Sentry Voice tones.

Quality

86%

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-guidelines in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

88%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-crafted, compact instruction skill: an unambiguous tone-selection decision procedure backed by concrete before/after copy examples and brand-specific word-choice tables throughout. Its weaknesses are minor — some generic writing advice (anti-patterns, active-voice rules) that Claude already knows, and a fully inlined single file with no progressive disclosure of its longer guideline sections.

Suggestions

Trim or compress the Anti-Patterns and Plain Speech rules that restate general writing knowledge (active voice, hedging, double negatives, 'in order to'), keeping only the Sentry-specific entries.

Move the UI Element Guidelines detail (buttons, dialogs, tooltips) into a reference file if the skill grows, keeping only the tone-selection decision procedure and top rules in SKILL.md.

Add one worked example each for tooltips and confirmation dialogs to round out the UI element coverage.

DimensionReasoningScore

Conciseness

The body is dominated by tight tables and before/after examples that are brand-specific and earn their tokens (tone table, word-choice table, Sentry Voice samples), but sections like the Anti-Patterns ("Passive voice: 'Changes were saved' -> 'Changes saved'", "'In order to' -> 'To'", double negatives) and parts of Plain Speech rules restate general writing knowledge Claude already has — minor over-explanation that could be trimmed. It is above 3 because most content is genuinely brand-specific and efficiently formatted, and below 5 because those generic-style sections do not fully assume Claude's competence.

4 / 5

Actionability

The guidance is concrete and copy-paste ready across the common cases: before/after rewrite tables ("Click here to save your changes" -> "Save"), good/bad error messages ("Could not save changes. Check your connection and try again."), empty-state copy, 404 and onboarding samples, and an avoid/prefer word table. Per the code_vs_instruction scoring note, the absence of code is not penalized since the guidance is fully actionable and covers the common UI cases; only tooltips and confirmation dialogs lack worked examples, which is a negligible gap.

5 / 5

Workflow Clarity

This is a simple, single-purpose skill (choose a tone, write the copy), and the single action is unambiguous: the tone-selection table maps each context to Plain Speech or Sentry Voice, reinforced by an explicit default ("Default to Plain Speech unless the context specifically calls for personality") and a 'When NOT to Use' section that stays consistent with the table. Under the simple-skill exception the workflow can score 5; no destructive or batch operations exist that would require validation checkpoints.

5 / 5

Progressive Disclosure

No bundle files exist, and the ~170-line body uses clear section headers (tone selection, both tone guides, general rules, dash usage, UI elements, anti-patterns, references) that make navigation easy, with the References section limited to two clearly labeled external links rather than buried pointers. It falls short of 5 because the skill is well above the under-50-lines threshold for a single-file 5, and some content (e.g., the UI Element Guidelines) could arguably be split into a reference file; it exceeds 3 because nothing that clearly belongs in a separate file is inlined and nothing is buried or nested.

4 / 5

Total

18

/

20

Passed

Description

78%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 that explicitly pairs a clear 'what' (write Sentry-branded copy in two named tones) with an explicit 'Use when' clause full of natural trigger terms. The main gaps are a single-action capability statement and a broad 'any user-facing content' catch-all that slightly widens conflict risk.

Suggestions

List one or two more concrete actions beyond 'write copy' (e.g., 'Write and review user-facing copy, apply tone selection, and rewrite off-brand text') to lift specificity.

Add common synonyms users would say such as 'microcopy', 'button labels', 'copywriting', or 'tone' to broaden trigger coverage.

Narrow the 'any user-facing content' catch-all to concrete contexts to reduce overlap with generic writing skills.

DimensionReasoningScore

Specificity

"Write copy following Sentry brand guidelines" names the domain and a concrete action, but no additional distinct actions are listed — the rest of the description enumerates contexts rather than capabilities, matching the '1-2 concrete actions, not comprehensive' anchor. It falls short of 4 because there are not several specific actions like 'extracts, fills, merges' in the higher anchors, and exceeds 2 because the domain and action are concrete rather than generic.

3 / 5

Completeness

It explicitly answers both questions: what ("Write copy following Sentry brand guidelines... Covers both Plain Speech (default) and Sentry Voice tones") and when ("Use when writing UI text, error messages, empty states, onboarding flows, 404 pages...") with concrete trigger phrases — a direct match for the top anchor, matching the good_overall_examples pattern.

5 / 5

Trigger Term Quality

"UI text, error messages, empty states, onboarding flows, 404 pages, documentation, marketing copy, user-facing content" are natural phrases a user would say, giving good keyword coverage. It falls short of 5 because common synonyms like "microcopy", "button labels", "copywriting", "help text", or "tone/voice" are missing, and exceeds 3 because far more than a few relevant keywords are covered.

4 / 5

Distinctiveness Conflict Risk

The Sentry brand niche with two named tones (Plain Speech, Sentry Voice) is a clear, distinctive domain with trigger terms unlikely to fire for unrelated skills. It misses 5 because the open-ended catch-all "or any user-facing content" widens the trigger surface with minor overlap risk against generic writing/style skills, and exceeds 3 because the core domain is clearly specific.

4 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/brand-guidelines/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.