CtrlK
BlogDocsLog inGet started
Tessl Logo

brand-style-guide

Build or audit a comprehensive brand style guide that documents the full brand system including story, logo system, color, typography, imagery, voice, applications, and dos/don'ts. Use this skill whenever the user wants to create brand guidelines, document an existing brand, build a brand book, audit an existing style guide for completeness, or produce the artifact that other teams will reference for years. Triggers on style guide, brand guidelines, brand book, brand standards, brand manual, style sheet, brand documentation, brand reference. Also triggers when the brand identity is finished and needs to be documented for handoff to designers, developers, vendors, or future team members.

63

Quality

75%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/brand-style-guide/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

100%

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

This is an excellent skill description that thoroughly covers what the skill does, when to use it, and includes comprehensive trigger terms. It lists specific components of the brand system it addresses, provides explicit 'Use when' guidance, and enumerates natural language triggers. The description is well-structured, uses third person voice correctly, and clearly distinguishes itself from related but different skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'Build or audit a comprehensive brand style guide' and enumerates specific components including 'story, logo system, color, typography, imagery, voice, applications, and dos/don'ts'. Also mentions specific use cases like 'document an existing brand' and 'audit an existing style guide for completeness'.

3 / 3

Completeness

Clearly answers both 'what' (build or audit a comprehensive brand style guide documenting the full brand system) and 'when' (explicit 'Use this skill whenever...' clause plus a 'Triggers on...' list and an additional contextual trigger scenario). Both dimensions are thoroughly addressed.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms users would say: 'style guide', 'brand guidelines', 'brand book', 'brand standards', 'brand manual', 'style sheet', 'brand documentation', 'brand reference'. Also includes contextual triggers like 'handoff to designers, developers, vendors' which captures real-world usage scenarios.

3 / 3

Distinctiveness Conflict Risk

Occupies a clear niche focused specifically on brand style guide documentation/auditing, distinct from skills that might handle brand identity creation, visual design, or general document creation. The specific trigger terms like 'brand book', 'brand manual', 'brand standards' are highly distinctive and unlikely to conflict with other skills.

3 / 3

Total

12

/

12

Passed

Implementation

50%

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

This is a thorough and well-structured brand style guide skill that provides comprehensive coverage of what belongs in a style guide. Its main strengths are the detailed 8-section framework with specific items per section, clear failure patterns, and a sensible output file structure. Its weaknesses are the lack of concrete filled-in examples (showing what good output looks like), missing bundle files for the referenced templates, and a workflow that could benefit from explicit validation checkpoints.

Suggestions

Add an inline example of at least one completed section (e.g., a sample Color section with actual hex/RGB values) so Claude has a concrete model of the expected output quality and format.

Include the referenced `references/style-guide-template.md` and `references/maintenance-playbook.md` files in the bundle, or remove the references to avoid dead links.

Add an explicit validation checkpoint in the workflow, such as 'After drafting all 8 sections, verify each section against the checklist above—flag any section with fewer than 3 concrete examples as incomplete.'

DimensionReasoningScore

Conciseness

The content is generally well-organized and avoids explaining basic concepts, but it's quite lengthy for what is essentially a checklist/framework document. Some sections like the 8-section framework are thorough checklists that earn their tokens, but the failure patterns and some workflow commentary could be tightened. The 'when to use / when NOT to use' section is efficient.

2 / 3

Actionability

The skill provides a detailed framework with specific items to include in each section (e.g., 'hex, RGB, HSL, CMYK, Pantone' for colors), a clear file structure, and a workflow. However, it lacks concrete executable examples—no sample markdown showing what a filled-in section looks like, no template snippets inline, and references a template file that doesn't exist in the bundle. The guidance is specific but descriptive rather than executable.

2 / 3

Workflow Clarity

The 7-step workflow is clearly sequenced and includes a review step (step 5) and version control (step 6). However, it lacks explicit validation checkpoints—there's no 'verify completeness against the 8 sections' step, no checklist for confirming all required inputs are present before proceeding, and no feedback loop for handling gaps discovered during stress-testing (step 4). For a document that will be referenced for years, validation is important.

2 / 3

Progressive Disclosure

The skill references two external files (style-guide-template.md and maintenance-playbook.md) which is good progressive disclosure design, and the recommended output file structure shows thoughtful organization. However, neither referenced file exists in the bundle, making the references dead links. The main document itself is quite long and could benefit from moving the detailed 8-section checklists into a separate reference file, keeping SKILL.md as a higher-level overview.

2 / 3

Total

8

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

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.