Agent skill

Brand Voice

by open-octo in open-octo/octo-agent

提炼并应用品牌声音(Brand Voice)。当用户要求"让文案符合品牌调性""定一下咱们的语气""按我们的风格写""这是我们的 on-brand 文案吗""写得更像我们""统一口吻""别这么官方/别这么网络梗"时使用。它先帮用户从已有素材里提炼出一份"品牌声音指南",再把这份指南套用到每一条文案上,确保多次产出依然稳定、一个调性。不适合:纯找素材(交给用户直接提供),也不适合一次性写文案不带品…

MITAuto-check passedWriting & Content

Install Brand Voice

skills CLI
$ npx skills add open-octo/octo-agent --skill brand-voice -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install open-octo/octo-agent brand-voice --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/open-octo/octo-agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/internal/skills/experts/brand-voice .claude/skills/brand-voice && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
brand-voice
GitHub stars
125
Token cost
~721 tokens
SKILL.md length
87 words
Files
1
Skills in repo
40
Repo updated
First seen
Licence
MIT

At a glance

提炼并应用品牌声音(Brand Voice)。当用户要求"让文案符合品牌调性""定一下咱们的语气""按我们的风格写""这是我们的 on-brand 文案吗""写得更像我们""统一口吻""别这么官方/别这么网络梗"时使用。它先帮用户从已有素材里提炼出一份"品牌声音指南",再把这份指南套用到每一条文案上,确保多次产出依然稳定、一个调性。不适合:纯找素材(交给用户直接提供),也不适合一次性写文案不带品…

  • Works in 9 steps: 收集素材 → 单源提炼 → 合成指南 → …
  • Tasks that involve Brand voice and tone
  • SKILL.md covers 先判断:用户是要"定声音"还是"用声音", 提炼指南(生成品牌声音指南), 应用指南(把声音套到文案上) and 冲突处理, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Brand Voice is an agent skill from open-octo/octo-agent. 提炼并应用品牌声音(Brand Voice)。当用户要求"让文案符合品牌调性""定一下咱们的语气""按我们的风格写""这是我们的 on-brand 文案吗""写得更像我们""统一口吻""别这么官方/别这么网络梗"时使用。它先帮用户从已有素材里提炼出一份"品牌声音指南",再把这份指南套用到每一条文案上,确保多次产出依然稳定、一个调性。不适合:纯找素材(交给用户直接提供),也不适合一次性写文案不带品牌约束(直接用 Copywriting skill)。触发词:"品牌声音 / 品牌调性 / 语气 / 人设 / 口吻 / on-brand / 像我们 / 统一风格 / 太官方 / 太像 AI / 品牌人格"。

Its SKILL.md is about 720 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Writing & Content, covering Brand voice and tone and Copywriting. The repository describes itself as: Open-source, single-binary, self-hosted AI agent — your models and data stay on your machine. A coding agent on par with Claude Code and a personal assistant lighter than… The licence is MIT.

When your agent uses it

  • Tasks that involve Brand voice and tone
  • Tasks that involve Copywriting

Example prompts

  • “让文案符合品牌调性”
  • “定一下咱们的语气”
  • “按我们的风格写”
  • “/brand-voice”

Workflow steps

9 steps, taken from the step headings in SKILL.md.

  1. 收集素材
  2. 单源提炼
  3. 合成指南
  4. 不确定的,写进"待定问题"
  5. 先定义这次任务
  6. 套用恒定的声音
  7. 按场景调节语气
  8. 产出并说明
  9. 校验

What it can do on your machine

Read from SKILL.md and the folder at commit bbae80e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Brand Voice loads about 721 tokens when it runs. Until then it costs about 79 tokens; SKILL.md has 87 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~79
When it runs · the whole SKILL.md, loaded when a task matches
~721

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from open-octo/octo-agent at commit bbae80e, republished under its MIT licence (© open-octo). 87 words, ~721 tokens.

Download SKILL.mdSave it as .claude/skills/brand-voice/SKILL.md (or your agent's skills folder).
name
brand-voice
description
提炼并应用品牌声音(Brand Voice)。当用户要求"让文案符合品牌调性""定一下咱们的语气""按我们的风格写""这是我们的 on-brand 文案吗""写得更像我们""统一口吻""别这么官方/别这么网络梗"时使用。它先帮用户从已有素材里提炼出一份"品牌声音指南",再把这份指南套用到每一条文案上,确保多次产出依然稳定、一个调性。不适合:纯找素材(交给用户直接提供),也不适合一次性写文案不带品牌约束(直接用 Copywriting skill)。触发词:"品牌声音 / 品牌调性 / 语气 / 人设 / 口吻 / on-brand / 像我们 / 统一风格 / 太官方 / 太像 AI / 品牌人格"。

品牌声音(Brand Voice)

让该专家产出的每一条文案都落在同一个声音里。核心是"声音恒定、语气可调"(Voice constant, tone flexes)——先提炼一份品牌声音指南,再把它应用到所有文案。

先判断:用户是要"定声音"还是"用声音"

  • 定声音:用户还没有品牌声音指南,或想重做。走「提炼指南」。
  • 用声音:用户已有指南(本会话生成过,或提供了),只想按它写、按它改。走「应用指南」。
  • 校准某一条:用户给出具体文案,问"这是不是我们的调性"。走「应用指南」+「校验」。

不知道时说清楚,别默认。用户只是随口说"写得有调性一点"时,先快速提炼一份轻量指南再写。


提炼指南(生成品牌声音指南)

1. 收集素材

从已有的东西里提炼,不要凭空造。按优先级问/拿:

  • 已有的、用户喜欢的文案:过去写得好、用户认可的内容(社媒帖、广告语、产品介绍、Slogan)。
  • 产品/品牌资料:产品定位、目标人群、价格档位、竞品。
  • 语气形容:用户用形容词描述想要的调性("专业但不冷""亲和""高级""接地气"),以及明确不要的("别太emo")。
  • 说话的人:这声音是"一个人"还是"一个品牌"?用第一人称吗?(决定口吻来源。)

如果用户懒得多给,就从当前对话/上下文 + 产品资料里提炼一版草稿,标注「推断,可修改」,别卡住。

2. 单源提炼

有充足素材时,逐条抽出特征:

  • 反复出现的用词、句长、标点习惯
  • 是否用梗、emoji、英文缩写
  • 是陈述型还是互动型,是"我们很牛"还是"你被看见"
  • 例子:直接摘一段用户认可的原文作为"像我们"的范例
3. 合成指南

输出一份紧凑的「品牌声音指南」,固定用这个模板:

markdown
## 品牌声音指南

### 一句话定位
[用一句话说清这个声音像谁。例:一个懂数据、说话不绕弯的资深顾问,专业但不端着。]

### We Are / We Are Not(核心人格锚点)
| 我们是 | 我们不是 |
|--------|----------|
| [例:专业] | [例:冷冰冰/爹味] |
| [例:真诚] | [例:套路/夸大] |
| [例:利落] | [例:啰嗦/堆砌] |
| [例:有温度] | [例:过度emo/卖惨] |

### 声音恒定 vs 语气可调
- **恒定(Voice)**:人格、价值观、We Are / We Are Not、禁用语——**所有平台、所有内容都一样**。
- **可调(Tone)**:正式度、能量、专业深度——**随平台和受众变化**。

### 语气-场景矩阵(Tone by Context)
| 场景 | 正式度 | 能量 | 专业深度 | 示例句 |
|------|--------|------|----------|--------|
| 小红书种草 | 低 | 高 | 低 | "[示例]" |
| 公众号长文 | 中 | 中 | 中 | "[示例]" |
| 商务邮件/提案 | 高 | 中 | 高 | "[示例]" |
| 短视频口播钩子 | 低 | 高 | 低 | "[示例]" |

### 术语与措辞
- **偏好用词**:[例:说"体验"不说"使用",说"帮你"不说"我司"]
- **禁用词**:[例:遥遥领先、赋能、打造闭环、震惊体、绝对最强]

### 范例(最像我们的文字)
> [摘一段用户认可的原稿,作为"像我们"的黄金样本]

每条 We Are 特征尽量配一句证据/来源;没有证据就标注「推断」。

4. 不确定的,写进"待定问题"

无法从素材判断的,别硬编进指南。单列一节:

markdown
### 待定问题(Open Questions)
1. **甜度/梗的浓度**
   - 发现:素材里梗很多,但不确定产品调性是否允许
   - 建议:先按「轻量梗 + 克制」处理
   - 需要你定:正式 vs 俏皮?

每条待定都要附一个建议默认值,让用户"确认或推翻",不留下死路。


应用指南(把声音套到文案上)

1. 先定义这次任务

写之前明确:内容类型(社媒/公众号/邮件/标题)、受众(谁看、什么段位)、核心信息(要点)、形式约束(字数/篇幅/是否要 emoji)。

2. 套用恒定的声音
  • 读一遍「We Are / We Are Not」,所有内容贴着"我们是"写,避开"我们不是"。
  • 用偏好用词,绝不碰禁用词。
  • 让人格贯穿全文,不虎头蛇尾。
3. 按场景调节语气

查语气-场景矩阵,设定本次的正式度/能量/专业深度。调整的是语气强度,不是人格身份——同一段话可以更正式或更俏皮,但"是谁在说话"不变。

4. 产出并说明

写好文案后,用 1-2 句点明:

  • 用了哪些 We Are 特征
  • 语气为什么调到这个度(对应哪个场景)
  • 哪里为上下文做了让步

默认附带品牌应用说明;若指南里标记了 always-explain:false 且用户不想要,就只写一句「已按指南校准」。

5. 校验

对照指南逐条检查:有没有滑向"我们不是"?有没有出现禁用词?结尾和开头人格是否一致?把检查结论简短告诉用户。


冲突处理

当用户的要求和品牌声音冲突时:

  1. 说清冲突在哪
  2. 给出你的建议
  3. 给选项:严格按指南 / 为上下文调整 / 这次破例

默认建议为上下文做有限调整,并说明取舍(用户可能有临时理由)。


把指南存下来

指南建议保存为纯文本/文件(如 品牌声音指南.md),方便下次直接用。若本会话已生成,直接用;下次会话若不在,先让用户提供或重新提炼,别硬猜。用户素材是唯一真实来源,宁可少写不可编造——凡是没有证据的"我们是"都不进指南。

© open-octo, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in internal/skills/experts/brand-voice of open-octo/octo-agent.

Open the folder on GitHubat commit bbae80e

Compare with similar skills

Brand Voice next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Brand Voice compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Brand Voice this skillopen-octo/octo-agent125—~721Automated safety check: PassMIT
Brand Voice Guideluongnv89/claude-howto42k—~609Automated safety check: PassMIT
Ralph Copywritermuratcankoylan/ralph-wiggum-marketer778—~2.4kAutomated safety check: PassNone
Business Insight Essay Writerliangdabiao/liurun-bookwriter-skills277—~2.5kAutomated safety check: PassMIT
Prose Style Guide Creatorsamber/cc-skills227—~5.3kAutomated safety check: PassMIT
Brand Voice Guidelhfer/claude-howto-zh-cn2.3k—~178Automated safety check: PassMIT

Similar skills

  • Brand Voice Guide

    luongnv89/claude-howto

    Ensure all communication matches brand voice and tone guidelines. Use when creating marketing copy, customer communications, public-facing content, or when…

    42k GitHub stars~609 tokensUpdated today
    Writing & ContentAuto-check passed
  • Ralph Copywriter

    muratcankoylan/ralph-wiggum-marketer

    A skill your agent uses when the user asks to "analyze my content", "learn my writing style", "research competitors", "find content angles", "improve my blog", "write like me", "embody my brand…

    778 GitHub stars~2.4k tokensUpdated 6 mo ago
    Writing & ContentAuto-check passed
  • Business Insight Essay Writer

    liangdabiao/liurun-bookwriter-skills

    Drafts Chinese business-insight essays, short audio scripts and year-end speeches in a specific public commentator's rhythm, built from his books, talks and broadcasts.

    277 GitHub stars~2.5k tokensUpdated 3 mo ago
    Writing & ContentAuto-check passed
  • Builds a PROSE.md writing guide that captures how a person or brand writes, such as vocabulary, sentence rhythm and signature moves, separate from emotional tone.

    227 GitHub stars~5.3k tokensUpdated 10 days ago
    Writing & ContentAuto-check passed
  • Brand Voice Guide

    lhfer/claude-howto-zh-cn

    Keeps marketing copy and customer messages in one consistent brand voice, using a defined mission, tone, writing rules and lists of preferred and avoided terms.

    2.3k GitHub stars~178 tokensUpdated 2 mo ago
    Writing & ContentAuto-check passed
  • Keeps marketing copy, customer messages and public content in one brand voice, with tone rules, preferred and banned wording and sample sentences; written in Ukrainian.

    42k GitHub stars~614 tokensUpdated today
    Writing & ContentAuto-check passed

More from open-octo/octo-agent

All 40 skills in this repo
  • Image Gen

    open-octo/octo-agent

    Acquire images as files — generate them with an AI image model (14 providers: OpenAI/gpt-image, Gemini, Qwen, Zhipu, Volcengine, Stability, FLUX, Ideogram, MiniMax, and more), search openly-licensed…

    125 GitHub stars~3.1k tokensUpdated yesterday
    Auto-check: notes
  • Office XLSX

    open-octo/octo-agent

    Create, read, and edit Excel (.xlsx) spreadsheets programmatically with openpyxl — cell values, formulas, styling (fonts/fills/borders/alignment/number formats), merged cells, multiple sheets…

    125 GitHub stars~1.8k tokensUpdated yesterday
    Auto-check: notes
  • Artifact Design

    open-octo/octo-agent

    Design guidance for any HTML/Markdown file shown in octo's Artifacts panel — reports, dashboards, architecture/system diagrams, generated UIs, slide-style pages, 3D scenes.

    125 GitHub stars~2.7k tokensUpdated yesterday
    Auto-check passed
  • Code Review

    open-octo/octo-agent

    Review local code changes. An agent skill from open-octo/octo-agent.

    125 GitHub stars~942 tokensUpdated yesterday
    Auto-check passed
  • Ppt Master

    open-octo/octo-agent

    AI-driven multi-format SVG content generation system. An agent skill from open-octo/octo-agent.

    125 GitHub stars~23k tokensUpdated yesterday
    Auto-check: warnings
  • Config Setup

    open-octo/octo-agent

    Configure octo's global settings through guided conversation — set up AI model endpoints (providers, API keys, models), adjust agent defaults (reasoning effort, permission mode, coauthor, workspace…

    125 GitHub stars~3.3k tokensUpdated yesterday
    Auto-check passed

Questions about Brand Voice

What does Brand Voice do?

提炼并应用品牌声音(Brand Voice)。当用户要求"让文案符合品牌调性""定一下咱们的语气""按我们的风格写""这是我们的 on-brand 文案吗""写得更像我们""统一口吻""别这么官方/别这么网络梗"时使用。它先帮用户从已有素材里提炼出一份"品牌声音指南",再把这份指南套用到每一条文案上,确保多次产出依然稳定、一个调性。不适合:纯找素材(交给用户直接提供),也不适合一次性写文案不带品…. Brand Voice is an agent skill from open-octo/octo-agent.

When should I use Brand Voice?

Brand Voice fits situations like: tasks that involve Brand voice and tone; tasks that involve Copywriting.

How do I install Brand Voice in Claude Code?

Run `npx skills add open-octo/octo-agent --skill brand-voice -a claude-code`. Or copy the skill folder (internal/skills/experts/brand-voice in open-octo/octo-agent) into .claude/skills/brand-voice in your project. Claude Code loads it when a task matches its description.

How do I install Brand Voice in Codex?

Run `npx skills add open-octo/octo-agent --skill brand-voice -a codex`. Or copy the skill folder (internal/skills/experts/brand-voice in open-octo/octo-agent) into .agents/skills/brand-voice in your project. Codex loads it when a task matches its description.

Can I use Brand Voice in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add open-octo/octo-agent --skill brand-voice -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/brand-voice, .gemini/skills/brand-voice, .github/skills/brand-voice and .opencode/skills/brand-voice in your project.

What does Brand Voice need to run?

SKILL.md names no scripts, command-line tools or credentials: Brand Voice is instructions for the agent only.

Does Brand Voice access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Brand Voice safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Brand Voice use?

Brand Voice is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Brand Voice use?

About 721 tokens (SKILL.md is roughly 2.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Brand Voice?

Skills that share tags, products or a category with Brand Voice: Brand Voice Guide (luongnv89/claude-howto, 42k stars), Ralph Copywriter (muratcankoylan/ralph-wiggum-marketer, 778 stars), Business Insight Essay Writer (liangdabiao/liurun-bookwriter-skills, 277 stars) and Prose Style Guide Creator (samber/cc-skills, 227 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Brand Voice?

open-octo (a GitHub organization) maintains it in open-octo/octo-agent, which has 125 GitHub stars. The repository holds 40 skills in this directory. The repository was last updated on October 10, 2026.

Source: open-octo/octo-agent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.