string-reviewer

Review user-facing text and UI strings for clarity, brevity, and consistent style.

107k|14.5k|Updated Apr 17, 2025
One-click install
npx skills add https://github.com/google-gemini/gemini-cli --skill string-reviewer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: string-reviewer
Source: https://github.com/google-gemini/gemini-cli/tree/main/.gemini/skills/string-reviewer
Command: npx skills add https://github.com/google-gemini/gemini-cli --skill string-reviewer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Inconsistent, verbose, or unclear user-facing strings degrade the user experience and create friction in CLI and UI interactions. This Skill audits text against a strict UX writing checklist to catch violations before they ship.

Core Features & Use Cases

  • Voice and Identity Auditing: Enforces deterministic clarity, active voice, and proper attribution between Gemini (analysis) and the system (execution).
  • Structural Scannability Checks: Validates the 5-word rule, goal-first sequencing, and telemetry-over-etiquette principles for status updates and labels.
  • Terminology Consistency: Cross-references strings against a curated word list of preferred, forbidden, and cautionary terms.
  • Settings Schema Compliance: Applies specific labeling rules (noun-first, positive boolean logic, verb stripping) when reviewing settings configuration files.
  • Use Case: Run this Skill after modifying error messages or settings labels in packages/cli/src/config/settingsSchema.ts to ensure all new strings comply with project voice and style guidelines.

Quick Start

Review the user-facing strings in the modified settings file and suggest improvements following the standard checklist format.

Frequently Asked Questions about string-reviewer

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

FAQPage Schema
How do I review user-facing strings for clarity and brevity?

Apply a structured checklist covering voice, scannability, and terminology. Flag strings exceeding 5 words for status updates, remove first-person pronouns, and replace polite filler with raw telemetry or progress indicators.

What is the difference between system and Gemini voice in CLI strings?

Use the system for execution verbs (is, will, must) describing deterministic infrastructure states. Use Gemini for probabilistic analysis verbs (suggests, appears, identifies) describing AI-generated output.

Does this skill automatically rewrite strings or only suggest changes?

It only suggests changes by default. The skill presents a formatted list of violations with incorrect and corrected phrases, requiring explicit user approval before any modifications are applied.

Why are my settings labels failing the noun-first rule?

Labels starting with action verbs like Enable, Use, or Show violate scannability. Strip the leading verb so the label begins with the subject noun, for example changing Enable prompt completion to Prompt completion.

When should I use caution terminology in CLI text?

Reserve disclaimers and warnings for P0 destructive or irreversible tasks only. Every warning must include a specific corrective action to avoid warning-fatigue and provide immediate recovery paths.