CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

applying-brand-guidelines

This skill applies consistent corporate branding and styling to all generated documents including colors, fonts, layouts, and messaging

56

Quality

71%

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

Fix and improve this skill with Tessl

tessl review fix ./skills_all/applying-brand-guidelines/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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-organized, highly concrete brand specification — nearly every value is exact and actionable, with a clear application sequence and an explicit pre-finalization checklist. Its main weaknesses are the absence of any progressive disclosure (everything is inlined in one ~168-line file) and references to scripts that do not exist in the bundle, plus a few vague closing steps.

Suggestions

Split the per-format standards ('PowerPoint Presentations', 'Excel Spreadsheets', 'PDF Documents') and 'Standard Phrases' into separate reference files under references/ (e.g. references/powerpoint.md, references/excel.md, references/pdf.md) with clearly signaled links, keeping SKILL.md as a concise overview.

Fix the broken script references: either ship scripts/apply_brand.py and scripts/validate_brand.py with usage examples (e.g. 'python scripts/validate_brand.py output.docx'), or remove the '## Scripts' section entirely.

Replace vague closing steps in 'Application Instructions' ('Review against brand standards', 'Ensure professional appearance') with a concrete reference to the 'Before Finalizing' checklist, and drop the time-sensitive 'updated quarterly' note or move it to a versioned change-log section.

DimensionReasoningScore

Conciseness

The body is dense with brand-specific data Claude cannot know (exact hex values, 'Segoe UI... 11pt' font hierarchy, '0.5 inches' margins), with almost no explanation of concepts Claude already knows. Minor trimming is possible — the 'Tone of Voice' bullets ('Professional: Formal but approachable') and the quarterly-update note ('Brand guidelines updated quarterly - check for latest version') are time-sensitive/generic filler — so it fits score 4 rather than 5.

4 / 5

Actionability

Most guidance is concrete and directly executable: exact colors ('Acme Blue: #0066CC'), precise layout rules ('Margins: 1 inch all sides', 'Maximum 6 bullet points per slide'), and specific formatting standards per format. It falls short of 5 because the 'Application Instructions' steps 5-6 ('Review against brand standards', 'Ensure professional appearance') are vague, and the referenced scripts 'apply_brand.py' and 'validate_brand.py' are described with no usage instructions and do not exist in the bundle.

4 / 5

Workflow Clarity

A clear 6-step sequence is present ('1. Start with brand colors and fonts ... 5. Review against brand standards'), reinforced by an explicit 'Before Finalizing' verification checklist ('1. Logo is properly placed and sized ... 6. Professional tone maintained'). This is not a destructive/batch operation, so no validation cap applies; it misses 5 only because the review checkpoint is manual and the validate_brand.py mechanism is named but never shown.

4 / 5

Progressive Disclosure

Section structure is good (clear '## Visual Standards', '## Document Standards', '## Content Guidelines' headers), but at ~168 lines the per-format standards (PowerPoint, Excel, PDF) and standard-phrases content that clearly belongs in separate reference files are all inlined, and the body references scripts ('apply_brand.py', 'validate_brand.py') that do not exist in the bundle — no references/, scripts/, or assets/ directories are present. This matches the score-3 anchor 'Some structure but could be better organized; content that should be separate is inline' rather than score 4, whose reference organization is mostly sound.

3 / 5

Total

15

/

20

Passed

Description

57%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 clearly states what the skill does and covers the key branding dimensions (colors, fonts, layouts, messaging), but it completely lacks a 'when to use' trigger clause and offers only one generic action verb, limiting both completeness and specificity. Trigger keywords are reasonably natural but miss common synonyms like 'brand guidelines' or 'style guide'.

Suggestions

Add an explicit trigger clause, e.g. 'Use when creating or styling documents, slides, or spreadsheets that must follow corporate brand standards, or when the user mentions branding, brand guidelines, or style guides.'

Replace the single generic verb with concrete actions, e.g. 'Applies the Acme brand color palette, typography hierarchy, and document templates to PowerPoint, Excel, and PDF outputs, and validates finished documents for brand compliance.'

Include natural synonyms users would say — 'brand guidelines', 'style guide', 'brand standards' — and format-specific triggers (presentations, spreadsheets) to reduce overlap with generic document skills.

DimensionReasoningScore

Specificity

The description names the domain ("corporate branding and styling to all generated documents") and enumerates covered aspects ("colors, fonts, layouts, and messaging"), but relies on a single generic action verb ("applies") rather than several concrete actions like the score-4 anchor ('Extracts text from PDF files, fills forms, converts pages to images') requires.

3 / 5

Completeness

The 'what' is clear ("applies consistent corporate branding and styling to all generated documents including colors, fonts, layouts, and messaging"), but there is no 'Use when...' clause or equivalent explicit trigger guidance — the 'when' is entirely absent, which per the judging guidelines caps completeness at 3.

3 / 5

Trigger Term Quality

Natural terms users would say are present — "branding", "styling", "colors", "fonts", "layouts", "messaging", "documents" — giving good keyword coverage. It falls short of score 5 because common synonyms and variations like "brand guidelines", "style guide", or "brand standards" are missing, and there are no file-format triggers.

4 / 5

Distinctiveness Conflict Risk

The corporate-branding niche is somewhat specific, but "all generated documents" is broad and would overlap with any document-creation skill (pptx, docx, xlsx, pdf), matching the score-3 anchor 'Somewhat specific but could still overlap with similar skills'. It is not score 4 because no distinct trigger phrases distinguish it from those adjacent skills.

3 / 5

Total

13

/

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

Microck/ordinary-claude-skills

Path

skills_all/applying-brand-guidelines/SKILL.md

Revision

1056d29

Reviewed

Table of Contents

DiscoveryImplementationValidation

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.

Claim skill