Token导航 LogoToken导航

Agent Skill · 开发规范

brand-guidelines(品牌指南)

brand-guidelines 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息,适合在 Codex、Claude、Cursor、Gemini CLI 中需要围绕仓库状态、代码变更或协作事项进行整理时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写。

brand-guidelines 是开发规范类 Agent Skill,可用宿主为 Codex、Claude、Cursor、Gemini CLI,通过GitHub 仓库获取,权限为只读;许可证信息还不明确,第三方扫描有提醒项,按安装量在开发规范类的 1,265 个 Skill 里排第 417。

总安装 1,854周安装 75GitHub Stars 103下载 582核验 2026-05-01

安装说明

本站只整理中文说明,不托管安装包,也不代用户安装。
GitHub
许可证
unknown

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:brand-guidelines(品牌指南)
来源仓库:https://github.com/borghei/claude-skills
仓库路径:skills/brand-guidelines
安装命令:
npx skills add https://github.com/borghei/claude-skills --skill brand-guidelines
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill;本站只展示命令,不托管安装包,也不自动执行。

skills.shnpx skills
npx skills add https://github.com/borghei/claude-skills --skill brand-guidelines

这个 Skill 是做什么的

开发规范类 Skill 用来统一代码风格、目录结构和评审口径,产出多为检查清单或改写建议。

建立全渠道品牌身份系统,涵盖视觉识别与语调风格规范。提供色彩体系、字体库与 Logo 使用准则,确保跨平台一致性。支持品牌审计与跨媒介应用检查,减少品牌稀释风险。更新时需同步通知所有协作方,防止新旧规范混用造成混淆。brand-guidelines 属于开发规范类 Skill,可作为该场景下的辅助能力补充。

来源仓库内路径:skills/brand-guidelines

上手步骤

4 步
  1. 1

    确认自己的宿主工具

    公开资料标注支持 Codex、Claude、Cursor、Gemini CLI;先确认自己用的是其中之一,再按对应工具的 Skills 目录放置。

  2. 2

    拿到安装命令

    可以直接复制的命令是 npx skills add https://github.com/borghei/claude-skills --skill brand-guidelines;命令里的占位符换成自己的路径或密钥再执行。

  3. 3

    安装后重启宿主

    命令执行完要完全退出宿主工具再打开,让新装的 Skill 被重新扫描到,否则列表里可能看不到。

  4. 4

    按最小权限试用

    它标注为只读,先用只读任务试一次,确认行为符合预期再扩大使用范围。

常见问题

6 条

brand-guidelines 怎么安装?

在终端执行 npx skills add https://github.com/borghei/claude-skills --skill brand-guidelines。装完完全退出宿主工具再打开,让它重新扫描本地 Skill。

brand-guidelines 支持哪些 AI 工具?

公开资料标注支持 Codex、Claude、Cursor、Gemini CLI。其他工具只要能读取本地 Skill 目录,一般也能手动放进去,但要自己确认触发方式是否一致。

brand-guidelines 需要什么权限?

权限级别是只读。该 Skill 主要提供规则、说明或参考内容,本身偏只读;真正读写文件、联网或执行命令仍取决于宿主 Agent 的任务。

brand-guidelines 是免费的吗?

公开资料没有标注明确许可证,收费和商用限制都无法确认。正式使用前请到来源仓库核对授权说明。

brand-guidelines 用的人多吗?

公开数据是累计安装 1,854 次,近一周安装 75 次,下载 582 次,GitHub 103 星。这些数字来自第三方目录统计,只能当作热度参考,不代表质量或安全性。

brand-guidelines 安全吗?

第三方扫描有提醒项,说明存在需要人工确认的行为。安装前请打开源码看清它读了什么、联网到哪里。

值得选的地方和要先想清楚的地方

值得选的地方

  • 同时适配 4 种工具,换客户端不用重新找替代品。
  • 标注为只读权限,试用阶段不容易误改本地文件。

先想清楚的地方

  • 许可证没有明确标注,能不能商用、能不能再分发都不确定。
  • 第三方扫描存在提醒项或未通过项,需要人工逐条确认。
  • 第三方目录整理,版本更新和行为细节以来源仓库为准。

适不适合你

更适合

  • 已经在用 Codex,想直接扩展它能力的人。
  • 需要处理开发规范类任务、又不想每次都手写提示词的人。
  • 只想先试试效果、不希望它改动本地文件的人。

不太适合

  • 需要明确授权才能用到公司项目里的场景。
  • 需要厂商级技术支持和 SLA 的生产系统。

开发规范类 Skill 对比

6 个同类
Skill总安装GitHub 星权限许可证扫描
vercel-react-best-practices

Vercel React 最佳实践 · Codex、Claude

8,490,72025,918操作浏览器MIT通过
web-design-guidelines

网页设计指南 · Codex、Claude

6,686,01625,885需要联网MIT有提醒
remotion-best-practices

Remotion 最佳实践 · Codex、Claude

6,505,6323,027操作浏览器MIT有提醒
supabase-postgres-best-practices

Supabase Postgres 最佳实践 · Codex、Claude

3,175,5232,030需要联网MIT通过
next-best-practices

Next.js 最佳实践 · Codex、Claude

1,848,240841操作浏览器MIT通过
brand-guidelines

品牌指南 · 本页

1,854103只读未明确有提醒

按安装量取同分类前几名;数字来自第三方目录统计,只作热度参考,不代表质量结论。

SKILL.md 原文

Brand Guidelines

Comprehensive brand identity systems for building, documenting, and enforcing consistent brand presence across every channel and touchpoint.


Table of Contents


Keywords

brand guidelines, brand identity, style guide, brand voice, tone of voice, visual identity, brand standards, brand consistency, color systems, typography, logo usage, brand colors, design standards, brand audit, brand governance, co-branding, brand architecture, brand personality, writing style guide, visual standards


Quick Start

Create Brand Guidelines from Scratch

  1. Define brand foundation (purpose, values, personality)
  2. Establish voice and tone system with attribute matrix
  3. Build visual identity system (colors, typography, logo rules)
  4. Document imagery and photography standards
  5. Create channel-specific application guides
  6. Compile into shareable brand guidelines document

Audit Existing Brand Consistency

  1. Collect samples from every active channel and touchpoint
  2. Run the Brand Audit Checklist against each sample
  3. Score consistency across all seven brand dimensions
  4. Document deviations with specific remediation recommendations
  5. Prioritize fixes by customer-facing visibility

Core Workflows

Workflow 1: Build a Brand Identity System

Step 1: Define Brand Foundation

## Brand Foundation
- Purpose: [Why the brand exists beyond revenue]
- Vision: [What the brand aspires to achieve in the world]
- Mission: [How the brand delivers on its purpose daily]
- Values (3-5):
  1. [Value]: [What it means in practice, not just the word]
  2. [Value]: [Behavioral definition]
  3. [Value]: [Behavioral definition]
- Brand Promise: [The single commitment to customers]

Step 2: Establish Brand Personality

Select 3-5 personality traits from the archetype framework:

ArchetypePersonality TraitsVoice CharacteristicsBest For
ExpertKnowledgeable, precise, authoritativeData-driven, technical depth, confidenceB2B, enterprise, professional services
GuideHelpful, clear, patientInstructional, encouraging, step-by-stepEducation, SaaS, healthcare
InnovatorBold, forward-thinking, disruptiveVisionary, provocative, future-focusedTech, startups, R&D
FriendWarm, approachable, genuineConversational, inclusive, casualConsumer brands, community, lifestyle
MotivatorInspiring, energetic, empoweringAction-oriented, ambitious, rallyingFitness, coaching, personal development
ChallengerDirect, honest, contrarianOpinionated, confident, questioningFintech, disruptor brands
CreatorImaginative, expressive, originalStorytelling, vivid imagery, playfulDesign, media, entertainment

Step 3: Document Voice and Tone

See the Voice and Tone System section below for the complete framework.

Step 4: Build Visual Identity

See the Visual Identity System section below for the complete framework.

Step 5: Create Application Guide

Document how guidelines apply to each channel:

  • Website and product UI
  • Email marketing
  • Social media (per platform)
  • Sales materials
  • Customer support communications
  • Press and media
  • Co-branded materials

Workflow 2: Brand Audit

Step 1: Collect Samples

Gather 3-5 samples from each active channel:

  • Website pages (homepage, product, blog, about)
  • Email campaigns (marketing, transactional, support)
  • Social media posts (per platform)
  • Sales decks and proposals
  • Customer support responses
  • Advertising creative
  • Physical materials (if applicable)

Step 2: Score Against Seven Dimensions

For each sample, score 1-5 on:

Dimension1 (Poor)3 (Adequate)5 (Excellent)
Color usageOff-brand colors presentMostly correct, minor deviationsPerfect palette adherence
TypographyWrong fonts usedCorrect fonts, inconsistent sizingPerfect type hierarchy
Logo usageIncorrect sizing, placement, or modificationMostly correct with minor issuesPerfect logo application
Voice consistencyTone shifts dramatically between sectionsGenerally consistent, occasional driftVoice is unmistakably on-brand
Imagery styleStock photos inconsistent with brandMostly aligned, some off-brand choicesCohesive visual language
Layout patternsNo recognizable brand patternsSome consistent elementsClear, repeated brand patterns
Content qualityErrors, vague claims, inconsistent formattingClean, generally well-writtenPrecise, specific, error-free

Step 3: Generate Audit Report

## Brand Audit Report: [Brand Name]
Date: [Date]
Auditor: [Name]

### Overall Score: [X/35]

### Dimension Scores
| Dimension | Score | Priority |
|-----------|-------|----------|
| Color | X/5 | [High/Medium/Low] |
| Typography | X/5 | [High/Medium/Low] |
| Logo | X/5 | [High/Medium/Low] |
| Voice | X/5 | [High/Medium/Low] |
| Imagery | X/5 | [High/Medium/Low] |
| Layout | X/5 | [High/Medium/Low] |
| Content | X/5 | [High/Medium/Low] |

### Critical Issues
[Specific deviations with exact references]

### Recommendations
[Prioritized fixes with implementation guidance]

Brand Identity Dimensions

Dimension 1: Brand Foundation

The strategic layer that everything else builds on:

  • Purpose — Why the brand exists (not "to make money")
  • Values — What the brand believes and practices
  • Positioning — Where the brand sits in the competitive landscape
  • Promise — The core commitment to customers

Dimension 2: Voice and Tone

How the brand communicates across all written and spoken channels. See detailed framework below.

Dimension 3: Visual Identity

Colors, typography, logo, imagery, and layout patterns. See detailed framework below.

Dimension 4: Verbal Identity

Specific language choices:

  • Naming conventions — How products, features, and tiers are named
  • Terminology — Preferred terms vs. avoided terms
  • Taglines and slogans — Core messaging lines
  • Boilerplate copy — Standard company descriptions for press, bios, footers

Dimension 5: Experiential Identity

How the brand feels in interaction:

  • UI patterns — Consistent interaction patterns in product
  • Service tone — How support and success teams communicate
  • Onboarding experience — First impression and initial value delivery
  • Physical presence — Office, events, swag, packaging

Voice and Tone System

Voice vs. Tone

Voice is consistent — it is who the brand is. It does not change. Tone adapts — it adjusts based on context, audience, and situation.

Example: A brand's voice is always "clear and confident." But the tone shifts:

  • Product announcement: enthusiastic, forward-looking
  • Incident response: calm, transparent, accountable
  • Tutorial: patient, encouraging, precise

Voice Attribute Matrix

Define 3-5 voice attributes with spectrum positions:

AttributeWe AreWe Are Not
[e.g., Direct]We get to the point. We say what we mean.We are not blunt or dismissive. We are not rude.
[e.g., Knowledgeable]We share expertise with confidence.We are not condescending. We do not lecture.
[e.g., Human]We write like people, not corporations.We are not unprofessional. We do not use slang carelessly.

Tone Calibration by Context

ContextFormalityEnergyTechnical Depth
Marketing homepageMediumHighLow
Product documentationMedium-HighNeutralHigh
Blog postsMedium-LowMediumMedium
Error messagesMediumCalmLow
Social mediaLow-MediumHighLow
Sales proposalsHighMediumMedium-High
Customer supportMediumWarmVaries
Incident reportsHighCalmHigh

Writing Style Rules

Grammar and Mechanics:

  • Oxford comma: [Yes/No]
  • Contractions: [When to use/avoid]
  • Sentence case vs. Title Case for headings: [Standard]
  • Number formatting: [Spell out 1-9, numerals for 10+]
  • Date formatting: [Month Day, Year vs. DD/MM/YYYY]
  • Ampersand usage: [When acceptable]

Vocabulary Standards:

  • Preferred terms: [List of terms to always use]
  • Avoided terms: [List of terms to never use]
  • Jargon policy: [When industry jargon is acceptable]
  • Acronym policy: [Spell out on first use, then abbreviate]

Visual Identity System

Color System

Primary Palette:

RoleColor NameHexRGBUse Case
Primary[Name]#XXXXXXR, G, BPrimary CTAs, key brand elements
Secondary[Name]#XXXXXXR, G, BSupporting elements, accents
Neutral Dark[Name]#XXXXXXR, G, BBody text, dark backgrounds
Neutral Light[Name]#XXXXXXR, G, BBackgrounds, borders

Extended Palette:

RoleColor NameHexUse Case
Success[Name]#XXXXXXPositive states, confirmations
Warning[Name]#XXXXXXCautionary states
Error[Name]#XXXXXXError states, destructive actions
Info[Name]#XXXXXXInformational states

Color Usage Rules:

  • Primary color for CTAs and key interactive elements only
  • Minimum contrast ratio: 4.5:1 for text, 3:1 for large text (WCAG AA)
  • Never place colored text on colored backgrounds without checking contrast
  • Do not create new color variations — use the defined palette only

Typography System

RoleFontWeightSizeLine HeightUse Case
Display[Font Name]Bold/Black48-72px1.1Hero headlines
Heading 1[Font Name]Bold36-48px1.2Page titles
Heading 2[Font Name]Semibold24-32px1.3Section headers
Heading 3[Font Name]Medium20-24px1.4Subsection headers
Body[Font Name]Regular16-18px1.5-1.6Paragraph text
Small[Font Name]Regular14px1.5Captions, metadata
Code[Mono Font]Regular14-16px1.5Code blocks, technical

Typography Rules:

  • Maximum 2 font families across the brand
  • Heading hierarchy must be maintained (never skip levels)
  • Minimum body text size: 16px for web, 10pt for print
  • Maximum line length: 70-80 characters for readability

Logo System

Logo Variations:

  • Primary: Full logo (icon + wordmark)
  • Secondary: Wordmark only
  • Icon: Icon/symbol only (for favicons, app icons, small spaces)
  • Reversed: White version for dark backgrounds

Logo Rules:

  • Minimum clear space: [X] times the height of the icon on all sides
  • Minimum size: [X]px for digital, [X]mm for print
  • Never stretch, rotate, recolor, or add effects to the logo
  • Never place the logo on busy backgrounds without a container
  • Approved background colors: [List specific colors]

Co-Branding Rules:

  • Partner logos must be equal or smaller size
  • Minimum separation between logos: [X]px
  • Use a divider line or "+" symbol between logos
  • Our logo always appears on the left or top

Imagery Standards

Photography Style:

  • [Natural/staged] lighting
  • [Warm/cool/neutral] color temperature
  • [Diverse/specific] representation
  • [Candid/polished] composition
  • Do not use: [Specific stock photo cliches to avoid]

Illustration Style:

  • [Flat/3D/line art/isometric] style
  • Color palette limited to brand colors
  • Consistent line weight: [X]px
  • Corner radius: [X]px for rounded elements

Icon Style:

  • [Outline/filled/two-tone] style
  • Consistent stroke weight: [X]px
  • Grid size: [X]px base grid
  • Corner radius: [X]px

Brand Audit Framework

Quick Audit Checklist

Run this against any brand asset in under 5 minutes:

  • Colors match approved palette exactly (no approximate matches)
  • Fonts are correct typeface, weight, and size
  • Logo has proper clear space and is an approved variation
  • Body text meets minimum size and contrast requirements
  • Imagery style matches brand photography/illustration standards
  • Tone matches brand voice attributes for this context
  • No prohibited uses present (stretched logos, unapproved colors, off-brand imagery)
  • Co-branding follows partner logo rules (if applicable)
  • Content is free of spelling, grammar, and factual errors
  • CTAs use approved language and styling

Full Audit Process

For a comprehensive brand audit across the organization:

  1. Inventory — List every customer-facing touchpoint
  2. Sample — Collect 3-5 recent examples from each touchpoint
  3. Score — Rate each sample across all seven dimensions (1-5)
  4. Analyze — Identify patterns in where consistency breaks down
  5. Prioritize — Rank fixes by customer visibility and business impact
  6. Remediate — Create specific fix instructions for each issue
  7. Govern — Establish review process to prevent future drift

Cross-Channel Application

Website

  • Homepage reflects full brand identity (all dimensions)
  • Product pages maintain visual consistency with marketing pages
  • Blog uses the same typography and color system
  • Error pages and empty states still reflect brand personality
  • Favicon and OG images use approved logo variations

Email

  • Header uses approved logo at correct size
  • Color palette limited to brand palette
  • CTA buttons match brand primary color
  • Font stack includes web-safe fallbacks that approximate brand fonts
  • Footer includes consistent boilerplate and legal text

Social Media

PlatformAvatarCover/BannerPost TemplatesVoice Adaptation
LinkedInLogo iconBrand bannerProfessional, cleanSlightly more formal
Twitter/XLogo iconBrand bannerConcise, punchySlightly more casual
InstagramLogo iconN/AVisual-first, on-brand colorsVisual storytelling emphasis
YouTubeLogo iconBrand bannerThumbnail templateConversational

Sales Materials

  • Slide deck template with locked master slides
  • Proposal template with approved cover page and footer
  • One-pager template for leave-behinds
  • All use approved color palette, typography, and logo placement

Customer Support

  • Email signatures follow standard format
  • Help center articles use brand voice (helpful, patient, clear)
  • Chatbot responses match brand personality
  • Escalation templates maintain professional but warm tone

Best Practices

  1. Specificity over subjectivity — "Use #2563EB for primary buttons" is enforceable. "Use a nice blue" is not. Every guideline should be specific enough that a contractor produces on-brand work without guessing.
  2. Show examples of what NOT to do — For every rule, include a clear violation example. People learn faster from anti-patterns than from rules.
  3. Version and date everything — Brand guidelines evolve. Version every update and keep a changelog.
  4. Distribute in a usable format — A 200-page PDF nobody reads is worse than a 10-page living document everyone references. Make guidelines accessible where people work.
  5. Audit quarterly — Brand drift happens slowly. Schedule quarterly audits to catch deviations before they compound.
  6. Provide templates, not just rules — Every channel should have a ready-to-use template that embodies the guidelines. Templates enforce consistency better than documentation.
  7. Define escalation for edge cases — Who approves a new color? Who decides if a co-branding request is acceptable? Document the decision process.
  8. Train new team members — Brand guidelines are only as effective as the people who follow them. Include guidelines in onboarding.

Integration Points

  • Brand Strategist — Use for high-level brand positioning and architecture decisions. Brand Guidelines implements and documents those strategic decisions.
  • Copywriting — Use brand voice and tone system when writing any marketing copy.
  • Content Creator — Reference brand guidelines for every content piece to maintain consistency.
  • Social Content — Apply platform-specific brand adaptations from the cross-channel guide.
  • Ad Creative — Reference visual identity and voice standards for all advertising creative.
  • Landing Page Generator — Apply brand colors, typography, and voice to all landing pages.

Troubleshooting

SymptomLikely CauseResolution
Brand colors look different across web and printRGB vs CMYK color space mismatch; no Pantone reference definedDocument colors in all three systems (Hex/RGB for digital, CMYK for print, Pantone for exact matching)
Teams consistently use wrong fontsFont files not distributed or licensed for all team membersCreate a shared font kit, document web-safe fallbacks, include licensing status per font
Logo appears stretched or pixelated on partner sitesCo-branding guidelines not shared or minimum size not enforcedDistribute logo kit with vector formats (SVG/EPS), document minimum sizes and clear space rules
Voice varies dramatically across customer support vs marketingTone calibration by context not documented or not trainedCreate channel-specific tone guides with before/after examples, include in onboarding
Brand drift detected in quarterly auditNo governance process for new assets, no template enforcementImplement approval workflow, lock master templates, assign brand guardians per channel
Color contrast failures on accessibility auditsBrand palette not tested against WCAG AA/AAA standardsRun color_accessibility_checker.py on full palette, adjust problematic combinations
New hires produce off-brand content in first 30 daysBrand guidelines not included in onboarding processAdd brand guidelines review to onboarding checklist, provide quick-reference card

Success Criteria

  • Brand audit scores 4.0+/5.0 average across all seven dimensions (color, typography, logo, voice, imagery, layout, content)
  • All brand color combinations meet WCAG AA contrast ratio (4.5:1 for normal text, 3:1 for large text)
  • Quarterly audit variance stays below 10% across all channels
  • 100% of customer-facing templates use approved brand assets
  • New team members produce on-brand content within first 2 weeks of onboarding
  • Zero unauthorized logo modifications detected across all channels

Scope & Limitations

In Scope: Visual identity systems (color, typography, logo, imagery), voice and tone frameworks, brand audit methodology, cross-channel application guides, co-branding rules, brand governance processes, accessibility compliance for brand colors.

Out of Scope: Brand strategy and positioning decisions (see brand-strategist skill), brand architecture models (see brand-strategist skill), marketing copy creation (see copywriting skill), design file creation (Figma, Sketch), print production specifications.

Limitations: Brand guidelines are documentation — enforcement depends on organizational process. This skill provides frameworks and audit tools but cannot enforce compliance without governance workflows. Color accessibility checking uses algorithmic WCAG formulas and does not account for all visual impairment types.


Scripts

ScriptPurposeUsage
scripts/brand_audit_scorer.pyScore brand consistency across seven dimensions with prioritiespython scripts/brand_audit_scorer.py audit_data.json --json
scripts/messaging_consistency_checker.pyCheck text against brand voice standards, detect vocabulary violationspython scripts/messaging_consistency_checker.py --text "Your copy here"
scripts/color_accessibility_checker.pyValidate brand colors against WCAG contrast requirementspython scripts/color_accessibility_checker.py --fg "#2563EB" --bg "#FFFFFF"

平台分布

Codex

33.9%
按下载量换算197

Claude

28.09%
按下载量换算163

Cursor

19.8%
按下载量换算115

Gemini CLI

9.18%
按下载量换算53

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

可疑

权限和风险

只读

该 Skill 主要提供规则、说明或参考内容,本身偏只读;真正读写文件、联网或执行命令仍取决于宿主 Agent 的任务。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。来源安全扫描存在提醒或未通过项,安装前请自行复核。目前只有一个公开来源,建议同时核对源仓库。

继续浏览同类 Skills