Content Writer
chrispangg/deepagentsdk
Writing content across different platforms and styles. An agent skill from chrispangg/deepagentsdk.
Direct technical voice for docs, README, user-facing text. An agent skill from softspark/ai-toolkit.
Install Brand Voice
$ npx skills add softspark/ai-toolkit --skill brand-voice -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install softspark/ai-toolkit brand-voice --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/softspark/ai-toolkit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/app/skills/brand-voice .claude/skills/brand-voice && rm -rf skills-srcUse ~/.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/
Install the "brand-voice" agent skill from https://github.com/softspark/ai-toolkit/tree/main/app/skills/brand-voice into .claude/skills/brand-voice/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "brand-voice", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/softspark/ai-toolkit/tree/main/app/skills/brand-voiceType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add softspark/ai-toolkit --skill brand-voice -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install softspark/ai-toolkit brand-voice --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/softspark/ai-toolkit.git skills-src && mkdir -p .agents/skills && cp -r skills-src/app/skills/brand-voice .agents/skills/brand-voice && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "brand-voice" agent skill from https://github.com/softspark/ai-toolkit/tree/main/app/skills/brand-voice into .agents/skills/brand-voice/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "brand-voice", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add softspark/ai-toolkit --skill brand-voice -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install softspark/ai-toolkit brand-voice --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/softspark/ai-toolkit.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/app/skills/brand-voice .cursor/skills/brand-voice && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "brand-voice" agent skill from https://github.com/softspark/ai-toolkit/tree/main/app/skills/brand-voice into .cursor/skills/brand-voice/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "brand-voice", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/softspark/ai-toolkit.git --path app/skills/brand-voice--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add softspark/ai-toolkit --skill brand-voice -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install softspark/ai-toolkit brand-voice --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/softspark/ai-toolkit.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/app/skills/brand-voice .gemini/skills/brand-voice && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "brand-voice" agent skill from https://github.com/softspark/ai-toolkit/tree/main/app/skills/brand-voice into .gemini/skills/brand-voice/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "brand-voice", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install softspark/ai-toolkit brand-voiceInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add softspark/ai-toolkit --skill brand-voice -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/softspark/ai-toolkit.git skills-src && mkdir -p .github/skills && cp -r skills-src/app/skills/brand-voice .github/skills/brand-voice && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "brand-voice" agent skill from https://github.com/softspark/ai-toolkit/tree/main/app/skills/brand-voice into .github/skills/brand-voice/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "brand-voice", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add softspark/ai-toolkit --skill brand-voice -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install softspark/ai-toolkit brand-voice --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/softspark/ai-toolkit.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/app/skills/brand-voice .opencode/skills/brand-voice && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "brand-voice" agent skill from https://github.com/softspark/ai-toolkit/tree/main/app/skills/brand-voice into .opencode/skills/brand-voice/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "brand-voice", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
brand-voice- GitHub stars
- 179
- Token cost
- ~2.1k tokens
- SKILL.md length
- 1,041 words
- Files
- 4 (incl. scripts)
- Skills in repo
- 112
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
Direct technical voice for docs, README, user-facing text. An agent skill from softspark/ai-toolkit.
- Works in 3 steps: Project-level (preferred): add… → Session-level: user types /brand-voice… → Reset: /brand-voice default or remove…
- Tasks that involve Brand voice and tone
- SKILL.md covers Anti-Trope List (Banned Phrases), Voice Principles, Sentence-Level Rules and Formatting Discipline, plus 5 more sections
- Runs Python scripts from its folder; calls python3
What it does
Brand Voice is an agent skill from softspark/ai-toolkit. Direct technical voice for docs, README, user-facing text. Concise/strict modes. Triggers: documentation, README, content, output-mode, voice, prose style.
Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts (for example `modes/concise.md`, `modes/strict.md` and `scripts/measure.py`).
It sits in Writing & Content, covering Brand voice and tone and Technical documentation. The repository describes itself as: Professional-grade AI coding toolkit: 94 skills, 44 agents, multi-platform (Claude, Cursor, Windsurf, Copilot, Gemini, Cline, Roo Code, Aider, Augment, Antigravity, Codex CLI… The licence is Apache-2.0.
When your agent uses it
- Tasks that involve Brand voice and tone
- Tasks that involve Technical documentation
Example prompts
- “/brand-voice”
Requirements
- Python 3
- Node.js
- Pre-approved tools (allowed-tools): Read
Workflow steps
3 steps, taken from the first numbered list in SKILL.md.
- Project-level (preferred): add output-mode: concise to project CLAUDE.md frontmatter or .claude/settings.json under aiToolkit.outputMode
- Session-level: user types /brand-voice concise or /brand-voice strict to switch for the current session
- Reset: /brand-voice default or remove the project setting
What it can do on your machine
Read from SKILL.md and the folder at commit e40ed87. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
Read
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 1 file in scripts/ (Python), which the agent can run.
Shell commands in SKILL.md call:
python3
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 2.1k tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 1,041 words of instructions outside code blocks.
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); the scripts in this folder are not scanned.
SKILL.md
The full file from softspark/ai-toolkit at commit e40ed87, republished under its Apache-2.0 licence (© softspark). 1,041 words, ~2,137 tokens.
Download SKILL.mdSave it as
.claude/skills/brand-voice/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.- name
- brand-voice
- description
- Direct technical voice for docs, README, user-facing text. Concise/strict modes. Triggers: documentation, README, content, output-mode, voice, prose style.
- allowed-tools
- Read
- effort
- medium
- user-invocable
- true
Brand Voice
Auto-loaded when writing documentation, content, or user-facing text. Enforces consistent, direct voice and eliminates LLM rhetoric.
Also loaded when a project sets output-mode: concise or output-mode: strict in CLAUDE.md, to govern conversational response length and structure (see Output Modes).
Anti-Trope List (Banned Phrases)
Opening Tropes (Never Start With)
- "In today's fast-paced world..."
- "In the ever-evolving landscape of..."
- "Let's dive into..."
- "Let's explore..."
- "Welcome to this comprehensive guide..."
- "Are you looking for...?"
- "Whether you're a beginner or an expert..."
Filler Adjectives (Remove or Replace)
| Banned | Replacement |
|---|---|
| "cutting-edge" | Describe what it does |
| "game-changer" | State the specific impact |
| "revolutionary" | State the concrete improvement |
| "robust" | Describe what makes it reliable |
| "seamless" | Describe the integration mechanism |
| "state-of-the-art" | Cite specific capabilities |
| "leveraging" | "using" |
| "harnessing" | "using" |
| "utilizing" | "using" |
| "delve" / "delve into" | "examine" / "look at" |
| "holistic" | "complete" / "full" |
| "synergy" | Describe the actual interaction |
| "paradigm shift" | Describe the change |
| "best-in-class" | Cite the benchmark or drop it |
| "empower" | Say what it enables |
| "streamline" | Say what step it removes |
| "elevate" | Say what improves and by how much |
| "unlock" | Say what becomes possible |
Closing Tropes (Never End With)
- "Happy coding!"
- "And that's it! You're all set!"
- "I hope this helps!"
- "Feel free to reach out if you have any questions"
- "Now go build something amazing!"
Structural Tropes
- Do not number every single point when prose works better
- Do not use headers for 2-sentence sections
- Do not add a "Conclusion" section that restates the intro
- Do not add "Overview" sections that say nothing the title didn't already say
- Do not pad lists to look longer than they are
Voice Principles
| Principle | Rule |
|---|---|
| Direct over diplomatic | Say what you mean. "This function is slow" not "This function could potentially benefit from optimization." |
| Specific over general | Numbers, names, versions. "Reduces cold start by 40ms" not "Improves performance significantly." |
| Evidence over assertion | Show, don't tell. Include benchmarks, examples, or code. |
| Short over long | One sentence beats three. Cut filler words on every pass. |
| Active over passive | "The function returns X" not "X is returned by the function." |
| Technical over casual | Match the audience's expertise. Never dumb down for developers. |
| Honest over promotional | State limitations alongside strengths. |
| Accountable over apologetic | Own a mistake once, fix it, move on. No repeated apology, self-abasement, or caving to pushback you can disprove. |
Sentence-Level Rules
- Lead with the action or outcome, not the context. Bad: "In order to configure X, you need to..." Good: "Configure X by..."
- Cut weasel words: "quite", "very", "really", "basically", "simply", "just", "actually", "arguably"
- One idea per sentence. If a sentence has "and" linking two distinct ideas, split it.
- Use concrete subjects. Bad: "It is important to note that..." Good: (delete the phrase, state the fact)
Formatting Discipline
- Default to prose. Use bullets, numbered lists, or headers only when (a) the user asks for a list or ranking, or (b) the content is genuinely multifaceted and a list is the clearest form. A list of one or two items is a sentence — write the sentence.
- Every bullet carries content. Each bullet is at least one full clause, usually one to two sentences. A one-word bullet is a sentence in disguise.
- Match format to document type. Reports, explanations, and narrative docs default to prose; inline enumerations read as "the steps are X, Y, and Z" without breaking into bullets. Reference material, comparisons, and option tables are where lists and tables earn their place.
- Minimum formatting for clarity. Reach for the lightest structure that makes the content clear. Headers, bold, and nesting are tools, not decoration.
Before Publishing Checklist
- No banned phrases from anti-trope list?
- Opening sentence provides value (not filler)?
- Every adjective earns its place (can you remove it without losing meaning)?
- No "comprehensive guide" or "complete overview" unless it truly is?
- Consistent terminology throughout?
- Active voice used by default?
- No weasel words remaining?
- Technical claims backed by evidence or examples?
Show full SKILL.md (406 more words)Show less
Example
Bad (filler, marketing, generic):
In today's ever-evolving landscape of AI, our cutting-edge toolkit empowers
developers to seamlessly leverage state-of-the-art skills. Whether you're a
beginner or an expert, this comprehensive guide will help you unlock the full
potential of your workflow.Good (direct, specific, active):
ai-toolkit installs 108 skills and 44 agents via `npm install -g @softspark/ai-toolkit`.
After install, run `ai-toolkit doctor` to verify symlinks and hooks. Typical
install takes under 30 seconds on a local disk.Rules
- MUST remove every phrase from the anti-trope list before publishing — the list is a hard filter, not a suggestion
- MUST lead with the action or outcome in the opening sentence, never with context or framing
- NEVER open with "In today's...", "Let's dive into...", "Whether you're...", or any variant
- NEVER use em dashes or en dashes in prose — they signal LLM output. Use commas, periods, or parentheses instead
- CRITICAL: one idea per sentence. If you write "and" linking two distinct ideas, split the sentence
- MANDATORY: technical claims include a concrete number, name, or example — never assert quality without evidence
- NEVER format a refusal, a "no", or a correction as bullet points — prose carries it with less abruptness
Output Modes
Three modes govern conversational response length. Default applies always; concise and strict activate per-project or per-session.
| Mode | Token target vs default | Used when |
|---|---|---|
default | 100% (no extra constraints) | No output-mode configured |
concise | ≤60% | Daily work, short Q&A, code edits, short reviews |
strict | ≤40% | Long sessions, expensive models, batch operations, code-only tasks |
Mode rules live in this skill's modes/ directory. Read the file matching the active mode:
modes/concise.md— bullet-first, no preamble, max 3-sentence prose blocksmodes/strict.md— telegraphic, no prose blocks, only lists/tables/code
Activation
- Project-level (preferred): add
output-mode: conciseto projectCLAUDE.mdfrontmatter or.claude/settings.jsonunderaiToolkit.outputMode - Session-level: user types
/brand-voice conciseor/brand-voice strictto switch for the current session - Reset:
/brand-voice defaultor remove the project setting
What modes do NOT change
- Code blocks (always full, never truncated)
- File paths, line numbers, error messages (always exact)
- Lists of items the user must see (file lists, test failures, security findings)
- Plan documents and ADRs (always full structure)
Modes change prose, not data. If you cut a fact to fit a length budget, you have failed the mode, not honored it.
Measurement
Run python3 ${CLAUDE_SKILL_DIR}/scripts/measure.py --fixtures tests/fixtures/output-modes/ to compare baseline vs mode tokens on the fixture set. Report shows per-fixture deltas and an aggregate ratio.
When NOT to Load
- For code or technical specs with no user-facing prose — the voice rules do not apply
- For structured logs, CSV, or machine-readable output — formatting matters, voice does not
- For creative writing, poetry, or marketing copy where playfulness is a feature
- For non-English content — the anti-trope list is English-specific and would flag valid Polish/Spanish/etc. phrases
- In code comments inside functions — comments target developers; the rules above are for user-facing prose
© softspark, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 3 other files (scripts) in app/skills/brand-voice of softspark/ai-toolkit.
- SKILL.md
- modes/concise.md
- modes/strict.md
- scripts/measure.py
Open the folder on GitHubat commit e40ed87
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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Brand Voice this skillsoftspark/ai-toolkit | 179 | — | ~2.1k | Automated safety check: Pass | Apache-2.0 | |
| Content Writerchrispangg/deepagentsdk | 128 | — | ~3.3k | Automated safety check: Pass | MIT | |
| Adk Style GuideBrainDAO/adk-ts | 119 | — | ~1.8k | Automated safety check: Pass | MIT | |
| Writewaynesutton/markdown-site | 628 | — | ~3k | Automated safety check: Pass | MIT | |
| Writerrileyhilliard/claude-essentials | 130 | — | ~2k | Automated safety check: Pass | MIT | |
| Agent Stylepchalasani/claude-code-tools | 2k | — | ~1.4k | Automated safety check: Pass | MIT |
Similar skills
Adk Style Guide
BrainDAO/adk-ts
ADK-TS brand voice, terminology, and writing conventions. An agent skill from BrainDAO/adk-ts.
Write
waynesutton/markdown-site
Writing style guide for technical content, social media, blog posts, READMEs, git commits, and developer documentation.
Writer
rileyhilliard/claude-essentials
Writing style and tone guide for human-sounding content. An agent skill from rileyhilliard/claude-essentials.
Agent Style
pchalasani/claude-code-tools
Literature-backed English technical-prose writing rules (agent-style, 21 rules).
Documentation Guide
volfpeter/holm
A skill your agent uses when writing or modifying documentation, guides, or example READMEs.
More from softspark/ai-toolkit
All 112 skills in this repoPrepare Test Env
softspark/ai-toolkit
Prepare or verify a project QA environment with source identity, readiness, browser access, evidence paths and owned cleanup.
A11y Validate
softspark/ai-toolkit
Accessibility validator: WCAG 2.1 AA, EN 301 549, EAA. An agent skill from softspark/ai-toolkit.
Analyze
softspark/ai-toolkit
Analyzes code quality, complexity, patterns across codebase.
Autonomous Dev
softspark/ai-toolkit
Drives a brief, specification, issue or existing PR through implementation, review, tests and QA to a ready PR.
CI
softspark/ai-toolkit
Detect/generate/debug CI pipeline config (GitHub Actions, GitLab CI).
Commit
softspark/ai-toolkit
Creates Conventional Commits with pre-commit validation. An agent skill from softspark/ai-toolkit.
Related
Categories
Questions about Brand Voice
What does Brand Voice do?
Direct technical voice for docs, README, user-facing text. An agent skill from softspark/ai-toolkit. Brand Voice is an agent skill from softspark/ai-toolkit. Direct technical voice for docs, README, user-facing text.
When should I use Brand Voice?
Brand Voice fits situations like: tasks that involve Brand voice and tone; tasks that involve Technical documentation.
How do I install Brand Voice in Claude Code?
Run `npx skills add softspark/ai-toolkit --skill brand-voice -a claude-code`. Or copy the skill folder (app/skills/brand-voice in softspark/ai-toolkit) 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 softspark/ai-toolkit --skill brand-voice -a codex`. Or copy the skill folder (app/skills/brand-voice in softspark/ai-toolkit) 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 softspark/ai-toolkit --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?
Going by SKILL.md and its folder, Brand Voice needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3; Node.js. Its frontmatter pre-approves these tools: Read.
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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Brand Voice use?
Brand Voice is published under the Apache-2.0 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 2.1k tokens (SKILL.md is roughly 8.5k 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: Content Writer (chrispangg/deepagentsdk, 128 stars), Adk Style Guide (BrainDAO/adk-ts, 119 stars), Write (waynesutton/markdown-site, 628 stars) and Writer (rileyhilliard/claude-essentials, 130 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Brand Voice?
softspark (a GitHub user) maintains it in softspark/ai-toolkit, which has 179 GitHub stars. The repository holds 112 skills in this directory. The repository was last updated on October 8, 2026.
Source: softspark/ai-toolkit on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.