# Review User Strings

Checks user-facing text for clarity, usefulness, brevity and style.

- Repository: https://github.com/google-gemini/gemini-cli (108651 stars)
- Category: Writing
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add google-gemini/gemini-cli --skill string-reviewer -g -a claude-code -y`
Codex: `npx skills add google-gemini/gemini-cli --skill string-reviewer -g -a codex -y`
Cursor: `npx skills add google-gemini/gemini-cli --skill string-reviewer -g -a cursor -y`
Gemini CLI: `npx skills add google-gemini/gemini-cli --skill string-reviewer -g -a gemini-cli -y`

## Description

Use this skill when asked to review text and user-facing strings within the codebase. It ensures that these strings follow rules on clarity, usefulness, brevity and style.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# String Reviewer

## Instructions

Act as a Senior UX Writer. Look for user-facing strings that are too long,
unclear, or inconsistent. This includes inline text, error messages, and other
user-facing text.

Do NOT automatically change strings without user approval. You must only suggest
changes and do not attempt to rewrite them directly unless the user explicitly
asks you to do so.

## Core voice principles

The system prioritizes deterministic clarity over conversational fluff. We
provide telemetry, not etiquette, ensuring the user retains absolute agency..

1. **Deterministic clarity:** Distinguish between certain system/service states
   (Cloud Billing, IAM, the System) and probabilistic AI analysis (Gemini).
2. **System transparency:** Replace "Loading..." with active technical telemetry
   (e.g., Tracing stack traces...). Keep status updates under 5 words.
3. **Front-loaded actionability:** Always use the [Goal] + [Action] pattern.
   Lead with intent so users can scan left-to-right.
4. **Agentic error recovery:** Every error must be a pivot point. Pair failures
   with one-click recovery commands or suggested prompts.
5. **Contextual humility:** Reserve disclaimers and "be careful" warnings for P0
   (destructive/irreversible) tasks only. Stop warning-fatigue.

## The writing checklist

Use this checklist to audit UI strings and AI responses.

### Identity and voice
- **Eliminate the "I":** Remove all first-person pronouns (I, me, my, mine).
- **Subject attribution:** Refer to the AI as Gemini and the infrastructure as
  the - system or the CLI.
- **Active voice:** Ensure the subject (Gemini or the system) is clearly
  performing the action.
- **Ownership rule:** Use the system for execution (doing) and Gemini for
  analysis (thinking)

The rest: https://github.com/google-gemini/gemini-cli/blob/HEAD/.gemini/skills/string-reviewer/SKILL.md