brand-voice-generator

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Brand & Voice Generator

品牌与语调生成器

Generate complete brand configuration files for use with the PPTX Generator and other brand-aware skills. This skill guides users through an interactive process to define their brand identity and writing voice.

生成完整的品牌配置文件，用于PPTX Generator及其他品牌感知类Skill。此Skill会引导用户通过交互式流程定义其品牌标识和写作语调。

What This Creates

生成内容

File	Purpose	Used By
`brand.json`	Colors, fonts, assets	PPTX Generator, Excalidraw
`config.json`	Output settings	PPTX Generator
`brand-system.md`	Design philosophy & guidelines	All content skills
`tone-of-voice.md`	Writing voice & personality	LinkedIn, X, PPTX content

文件	用途	使用工具
`brand.json`	颜色、字体、资源	PPTX Generator、Excalidraw
`config.json`	输出设置	PPTX Generator
`brand-system.md`	设计理念与指南	所有内容创作类Skill
`tone-of-voice.md`	写作语调与个性	LinkedIn、X、PPTX内容

Output Location

输出位置

Files are created in:

.claude/skills/pptx-generator/brands/{brand-name}/

文件将创建在：

.claude/skills/pptx-generator/brands/{brand-name}/

Process Overview

流程概述

Gather Brand Basics - Name, description, primary use case
Define Colors - 10 color values for the complete system
Define Typography - Heading, body, and code fonts
Define Assets - Logo and icon paths
Discover Voice - Personality, vocabulary, sentence patterns
Create Design Philosophy - Core principles and signature elements
Generate Files - Create all four files with gathered information
Verify Setup - Confirm files are correctly placed

收集品牌基础信息 - 名称、描述、主要使用场景
定义颜色系统 - 完整系统所需的10个颜色值
定义排版规范 - 标题、正文及代码字体
定义资源路径 - Logo和图标路径
确定语调风格 - 个性特征、词汇选择、句式结构
创建设计理念 - 核心原则与标志性元素
生成配置文件 - 利用收集到的信息创建全部四个文件
验证设置结果 - 确认文件放置位置正确

Step 1: Gather Brand Basics

步骤1：收集品牌基础信息

Ask the user for:

Field	Description	Example
Brand name	Folder name (lowercase, no spaces, hyphens OK)	`my-brand` , `acme-corp`
Display name	Human-readable name	"My Brand", "ACME Corporation"
Description	One-line brand description	"AI education content and community"
Primary use	Main content type	presentations, social media, documentation

Suggested question:

"Let's set up your brand. What's your brand name? (This will be the folder name - use lowercase with hyphens, like 'my-brand')"

向用户收集以下信息：

字段	描述	示例
品牌名称	文件夹名称（小写，无空格，可使用连字符）	`my-brand` , `acme-corp`
显示名称	便于阅读的品牌全称	"My Brand", "ACME Corporation"
品牌描述	一句话品牌介绍	"AI教育内容与社区平台"
主要用途	核心内容类型	演示文稿、社交媒体、文档资料

建议提问：

"让我们开始设置你的品牌。请提供品牌名称？（这将作为文件夹名称 - 使用小写加连字符格式，例如'my-brand'）"

Step 2: Define Colors

步骤2：定义颜色系统

Gather 10 color values. Colors should be hex codes WITHOUT the

prefix.

收集10个颜色值，颜色需为不带

前缀的十六进制代码。

Required Colors

必填颜色

Color	Purpose	Guidance
`background`	Main slide/page background	Dark themes: near-black. Light themes: white/off-white
`background_alt`	Alternate background for variety	Slightly different shade of background
`text`	Primary text color	High contrast against background
`text_secondary`	Muted/secondary text	Slightly lower contrast than primary
`accent`	Primary accent (CTAs, highlights)	Your signature brand color
`accent_secondary`	Secondary accent	Complement to primary accent
`accent_tertiary`	Third accent (optional variety)	Another complement, or same as secondary
`code_bg`	Code block background	Darker than main background
`card_bg`	Card/surface background	Between background and text
`card_bg_alt`	Alternate card background	Slight variation of card_bg

颜色项	用途	指导建议
`background`	幻灯片/页面主背景色	深色主题：接近黑色；浅色主题：白色/米白色
`background_alt`	备用背景色（增加多样性）	与主背景色略有差异的色调
`text`	主文本颜色	与背景色形成高对比度
`text_secondary`	次要文本颜色	对比度略低于主文本
`accent`	主强调色（用于CTA、高亮内容）	品牌标志性颜色
`accent_secondary`	次要强调色	与主强调色互补的颜色
`accent_tertiary`	第三强调色（可选，增加多样性）	另一种互补色，或与次要强调色一致
`code_bg`	代码块背景色	比主背景色更深
`card_bg`	卡片/表层背景色	介于背景色与文本色之间
`card_bg_alt`	备用卡片背景色	与card_bg略有差异

Color Discovery Questions

颜色引导问题

If user doesn't have a full color system, guide them:

"What's your signature brand color? (This becomes your primary accent)"
"Do you prefer a dark theme (dark background, light text) or light theme?"
"Do you have secondary colors, or should I suggest complements?"

如果用户没有完整的颜色系统，可按以下步骤引导：

"你的品牌标志性颜色是什么？（这将作为主强调色）"
"你偏好深色主题（深色背景+浅色文本）还是浅色主题？"
"你有次要颜色吗？或者需要我推荐互补色？"

Color Suggestions by Theme

按主题推荐颜色

For dark themes, suggest:

background: 0a0a0a to 1a1a2e range
text: f5f5f5 to ffffff range
card_bg: 1a1a1a to 2d2d44 range

For light themes, suggest:

background: ffffff to f8f9fa range
text: 1a1a1a to 333333 range
card_bg: f0f0f0 to e8e8e8 range

深色主题建议：

background: 0a0a0a 至 1a1a2e 区间
text: f5f5f5 至 ffffff 区间
card_bg: 1a1a1a 至 2d2d44 区间

浅色主题建议：

background: ffffff 至 f8f9fa 区间
text: 1a1a1a 至 333333 区间
card_bg: f0f0f0 至 e8e8e8 区间

Step 3: Define Typography

步骤3：定义排版规范

Gather 3 font names:

Font	Purpose	Common Choices
`heading`	Headlines, titles, buttons	Inter, Montserrat, Poppins, Roboto
`body`	Body text, descriptions	Inter, Open Sans, Lato, Source Sans Pro
`code`	Code blocks, terminal	JetBrains Mono, Fira Code, Monaco, Consolas

Question:

"What fonts should we use? I need a heading font, body font, and code/monospace font. Common choices are Inter for both heading and body, and JetBrains Mono for code."

Default if unsure:

Heading: Inter
Body: Inter
Code: JetBrains Mono

收集3种字体名称：

字体类型	用途	常见选择
`heading`	标题、副标题、按钮	Inter、Montserrat、Poppins、Roboto
`body`	正文文本、描述内容	Inter、Open Sans、Lato、Source Sans Pro
`code`	代码块、终端内容	JetBrains Mono、Fira Code、Monaco、Consolas

提问：

"我们应该使用哪些字体？需要标题字体、正文字体和代码/等宽字体。常见选择是标题和正文都用Inter，代码用JetBrains Mono。"

不确定时的默认设置：

标题字体：Inter
正文字体：Inter
代码字体：JetBrains Mono

Step 4: Define Assets

步骤4：定义资源路径

Gather asset paths (relative to brand folder):

Asset	Description	Common
`logo`	Primary logo file	`assets/logo.png`
`logo_dark`	Logo variant for dark backgrounds (optional)	`null` or `assets/logo-dark.png`
`icon`	Square icon (optional)	`null` or `assets/icon.png`

Question:

"Do you have a logo file? If so, you'll need to copy it to the brand folder. What's the filename? (e.g., 'logo.png')"

If they have a logo, set path to

assets/logo.png

(they'll copy it there). If no logo, set to

null

收集相对于品牌文件夹的资源路径：

资源类型	描述	常见示例
`logo`	主Logo文件	`assets/logo.png`
`logo_dark`	深色背景下的Logo变体（可选）	`null` 或 `assets/logo-dark.png`
`icon`	方形图标（可选）	`null` 或 `assets/icon.png`

提问：

"你有Logo文件吗？如果有，需要将其复制到品牌文件夹中。文件名是什么？（例如'logo.png'）"

如果用户有Logo，路径设置为

assets/logo.png

（用户需自行复制到对应位置）。如果没有Logo，设置为

null

。

Step 5: Discover Voice

步骤5：确定语调风格

This is the most important step for content quality. Guide the user through voice discovery.

这是影响内容质量的最重要步骤。引导用户完成语调风格确认。

Voice Discovery Questions

语调引导问题

Ask these questions to understand their voice:

Personality in 3 words:

"Describe your brand's personality in exactly 3 words. Examples: 'Bold, Technical, Approachable' or 'Calm, Authoritative, Helpful'"
Voice influences:

"Who are 2-3 creators, brands, or people whose communication style you admire? This helps me understand the vibe."
Vocabulary patterns:

"What words or phrases do you use often? Any pet phrases, intensifiers you like ('super', 'incredibly'), or words you naturally reach for?"
What to avoid:

"What kind of tone or phrases do you want to AVOID? (e.g., corporate speak, hype language, overly casual)"
Sentence style:

"Do you prefer: Short punchy sentences, longer flowing explanations, or a mix? Do you use contractions ('don't', 'can't') casually?"
Teaching style (if applicable):

"When explaining something complex, how do you approach it? Show process/iterations? Use analogies? Lead with practical then theory?"

通过以下问题了解用户的语调偏好：

三个词描述品牌个性：

"用恰好三个词描述你的品牌个性。示例：'Bold, Technical, Approachable'（大胆、专业、亲民）或 'Calm, Authoritative, Helpful'（沉稳、权威、乐于助人）"
语调参考对象：

"你欣赏哪2-3位创作者、品牌或人物的沟通风格？这有助于我理解你想要的氛围。"
词汇使用习惯：

"你经常使用哪些词汇或短语？有没有偏好的口头禅、强化词（如'super'、'incredibly'），或是你自然会选用的词汇？"
需避免的内容：

"你想要避免哪种语调或短语？（例如：官样文章、夸张话术、过于随意的表达）"
句式风格：

"你偏好：简短有力的句子、较长的流畅解释，还是两者结合？你会随意使用缩写（如'don't'、'can't'）吗？"
教学风格（如适用）：

"当解释复杂内容时，你会采用什么方式？展示流程/迭代过程？使用类比？先讲实用内容再讲理论？"

Voice Templates Reference

语调模板参考

Read

references/voice-templates.md

for example voice configurations to show the user.

可查看

references/voice-templates.md

中的示例语调配置，展示给用户参考。

Step 6: Create Design Philosophy

步骤6：创建设计理念

Based on gathered information, help define:

基于收集到的信息，协助用户定义：

Core Principles (3-4)

核心原则（3-4条）

Ask:

"What are 3-4 design principles that guide your visual choices? For example: 'Clean over flashy', 'Technical but approachable', 'Dark mode by default'"

提问：

"指导你视觉选择的3-4条设计原则是什么？示例：'简洁优先于花哨'、'专业但亲民'、'默认深色模式'"

Signature Elements

标志性元素

Ask:

"Do you have any signature visual elements? Examples: Glass card effects, specific shadow styles, gradient patterns, geometric shapes, glow effects"

If unsure, suggest based on their colors and theme.

提问：

"你有没有标志性的视觉元素？示例：玻璃卡片效果、特定阴影样式、渐变图案、几何形状、发光效果"

如果用户不确定，可根据其颜色和主题给出建议。

Step 7: Generate Files

步骤7：生成配置文件

Create all four files using the gathered information.

利用收集到的信息创建全部四个文件。

brand.json

json

{
  "name": "{display_name}",
  "description": "{description}",

  "colors": {
    "background": "{background}",
    "background_alt": "{background_alt}",
    "text": "{text}",
    "text_secondary": "{text_secondary}",
    "accent": "{accent}",
    "accent_secondary": "{accent_secondary}",
    "accent_tertiary": "{accent_tertiary}",
    "code_bg": "{code_bg}",
    "card_bg": "{card_bg}",
    "card_bg_alt": "{card_bg_alt}"
  },

  "fonts": {
    "heading": "{heading_font}",
    "body": "{body_font}",
    "code": "{code_font}"
  },

  "assets": {
    "logo": "{logo_path}",
    "logo_dark": {logo_dark_path},
    "icon": {icon_path}
  }
}

json

{
  "name": "{display_name}",
  "description": "{description}",

  "colors": {
    "background": "{background}",
    "background_alt": "{background_alt}",
    "text": "{text}",
    "text_secondary": "{text_secondary}",
    "accent": "{accent}",
    "accent_secondary": "{accent_secondary}",
    "accent_tertiary": "{accent_tertiary}",
    "code_bg": "{code_bg}",
    "card_bg": "{card_bg}",
    "card_bg_alt": "{card_bg_alt}"
  },

  "fonts": {
    "heading": "{heading_font}",
    "body": "{body_font}",
    "code": "{code_font}"
  },

  "assets": {
    "logo": "{logo_path}",
    "logo_dark": {logo_dark_path},
    "icon": {icon_path}
  }
}

config.json

json

{
  "output": {
    "directory": "output/{brand_name}",
    "naming": "{name}-{date}",
    "keep_parts": false
  },
  "generation": {
    "slides_per_batch": 5,
    "auto_combine": true,
    "open_after_generate": false
  },
  "defaults": {
    "slide_width_inches": 13.333,
    "slide_height_inches": 7.5
  }
}

json

{
  "output": {
    "directory": "output/{brand_name}",
    "naming": "{name}-{date}",
    "keep_parts": false
  },
  "generation": {
    "slides_per_batch": 5,
    "auto_combine": true,
    "open_after_generate": false
  },
  "defaults": {
    "slide_width_inches": 13.333,
    "slide_height_inches": 7.5
  }
}

tone-of-voice.md

Use the template in

references/tone-template.md

and fill with gathered voice information.

使用

references/tone-template.md

中的模板，填入收集到的语调信息。

brand-system.md

Use the template in

references/brand-template.md

and fill with gathered design information.

使用

references/brand-template.md

中的模板，填入收集到的设计信息。

Step 8: Verify Setup

步骤8：验证设置结果

After generating files:

List created files:

Glob: .claude/skills/pptx-generator/brands/{brand-name}/*

Remind about assets:
"Don't forget to copy your logo file to
```
.claude/skills/pptx-generator/brands/{brand-name}/assets/
```
"
Suggest test:

"Try generating a simple presentation with: 'Create a 3-slide presentation for {brand-name} about [topic]'"

生成文件后：

列出已创建的文件：

Glob: .claude/skills/pptx-generator/brands/{brand-name}/*

提醒资源放置：
"别忘了将你的Logo文件复制到
```
.claude/skills/pptx-generator/brands/{brand-name}/assets/
```
"
建议测试：

"尝试生成一个简单的演示文稿：'为{brand-name}创建一个关于[主题]的3页演示文稿'"

Quick Mode

快速模式

If user just wants to get started quickly:

Ask only for: brand name, signature color, and light/dark preference
Generate sensible defaults for everything else
Create minimal but functional files
Tell them they can refine later

Quick mode trigger phrases:

"quick setup"
"just the basics"
"minimal brand"
"get started fast"

如果用户希望快速开始：

仅询问：品牌名称、标志性颜色、深色/浅色主题偏好
为其他所有内容生成合理默认值
创建精简但可用的文件
告知用户后续可进行细化调整

快速模式触发短语：

"快速设置"
"只需要基础配置"
"极简品牌"
"快速开始"

Updating Existing Brand

更新现有品牌

If a brand already exists:

Read existing files first
Ask what to update:
- Colors only?
- Voice only?
- Everything?
Preserve unchanged sections
Show diff of changes before writing

如果品牌已存在：

先读取现有文件
询问更新内容：
- 仅更新颜色？
- 仅更新语调？
- 全部更新？
保留未修改的部分
写入前展示变更差异

brand-voice-generator

Original

Translation

Brand & Voice Generator

品牌与语调生成器

What This Creates

生成内容

Output Location

输出位置

Process Overview

流程概述

Step 1: Gather Brand Basics

步骤1：收集品牌基础信息

Step 2: Define Colors

步骤2：定义颜色系统

Required Colors

必填颜色

Color Discovery Questions

颜色引导问题

Color Suggestions by Theme

按主题推荐颜色

Step 3: Define Typography

步骤3：定义排版规范

Step 4: Define Assets

步骤4：定义资源路径

Step 5: Discover Voice

步骤5：确定语调风格

Voice Discovery Questions

语调引导问题

Voice Templates Reference

语调模板参考

Step 6: Create Design Philosophy

步骤6：创建设计理念

Core Principles (3-4)

核心原则（3-4条）

Signature Elements

标志性元素

Step 7: Generate Files

步骤7：生成配置文件

brand.json

brand.json

config.json

config.json

tone-of-voice.md

tone-of-voice.md

brand-system.md

brand-system.md

Step 8: Verify Setup

步骤8：验证设置结果

Quick Mode

快速模式

Updating Existing Brand

更新现有品牌

Checklist

检查清单