voice-and-tone

Validate technical documentation for voice, tone, and style consistency.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/withmartian-sandbox/ghrc-x-3126672651424eddb640ecc81321a665 --skill voice-and-tone-withmartian-sandbox
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: voice-and-tone
Source: https://github.com/withmartian-sandbox/ghrc-x-3126672651424eddb640ecc81321a665/tree/main/tw-team/skills/voice-and-tone
Command: npx skills add https://github.com/withmartian-sandbox/ghrc-x-3126672651424eddb640ecc81321a665 --skill voice-and-tone-withmartian-sandbox

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ensures documentation uses a consistent, human voice and tone so readers can understand technical systems quickly and confidently, reducing ambiguity and editorial drift across docs.

Core Features & Use Cases

  • Tone Principles: Assertive but never arrogant, encouraging, tech-savvy yet human, and humble.
  • Style Mechanics: Enforces second person, present tense, active voice, short sentences, and sentence-case headings.
  • Terminology & Capitalization: Standardizes product and entity capitalization rules and guidance for contractions and emphasis.
  • Use Cases: Writing new API docs, reviewing existing technical guides, onboarding docs, and preparing user-facing help content.
  • Quality Checklist: Provides a concise checklist for reviewers to verify voice consistency, grammar, emphasis, and readability with suggested rewrites.

Quick Start

Review the provided document for voice, tone, terminology, and style consistency and return a checklist of violations with suggested rewrites.

Frequently Asked Questions about voice-and-tone

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enforce voice and tone consistency in technical documentation?▼

To enforce voice and tone consistency in technical documentation, you can review your text against specific style mechanics like second-person usage, active voice, and sentence-case headings, generating a quality checklist with suggested rewrites for any violations found.

What is the best way to check API docs for style and terminology consistency?▼

The best way to check API docs for style and terminology consistency is to validate the text against standardized capitalization rules, contraction usage, and emphasis conventions, returning a concise checklist of violations with suggested rewrites to ensure clarity.

Does this technical writing style guide support reviewing onboarding guides and user manuals?▼

Yes, this technical writing style guide supports reviewing onboarding guides and user manuals by applying tone principles that are assertive yet encouraging, validating present tense and active voice to reduce ambiguity and editorial drift across docs.

How do I standardize capitalization and emphasis conventions in my technical writing?▼

You standardize capitalization and emphasis conventions in technical writing by applying rule-based checks that verify sentence-case headings, product entity capitalization, and appropriate contraction usage, providing suggested rewrites for any detected inconsistencies.

What tone should I use when writing user-facing technical help content?▼

When writing user-facing technical help content, you should use a tone that is assertive but never arrogant, encouraging, tech-savvy yet human, and humble, ensuring readers can understand technical systems quickly and confidently.