string-reviewer

Reviews user-facing strings in codebases against UX writing style and terminology rules.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/bkrsna/gemini-cli --skill string-reviewer-bkrsna
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: string-reviewer
Source: https://github.com/bkrsna/gemini-cli/tree/main/.gemini/skills/string-reviewer
Command: npx skills add https://github.com/bkrsna/gemini-cli --skill string-reviewer-bkrsna

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Inconsistent, unclear, or overly verbose user-facing text degrades product quality, and manually auditing every string against style guidelines is slow and error-prone. This Skill reviews inline text, error messages, and UI labels against defined voice principles, terminology rules, and settings conventions. ## Core Features & Use Cases - UX Writing Audit: Evaluates strings against voice principles such as deterministic clarity, front-loaded actionability, and agentic error recovery. - Terminology Enforcement: Flags terms marked "do not use" or "use with caution" in the project word list and suggests preferred alternatives. - Settings Label Review: Applies noun-first labeling, positive boolean logic, and verb stripping rules when settingsSchema.ts is modified. - Use Case: After adding a new error message to the CLI, ask for a string review to receive a structured list of violations with corrected phrasing, without any automatic rewrites. ## Quick Start Review the user-facing strings I just added in this branch and suggest improvements following the project writing guidelines.

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 in my codebase for clarity?

Invoke the string-reviewer skill on the files or diff containing your UI text. It audits strings against voice principles like front-loaded actionability and the 5-word status rule, then returns a numbered list of violations with corrected phrasing.

How to enforce consistent terminology across UI text?

The skill checks every string against the project word list in references/word-list.md. Terms marked "do not use" or "use with caution" are flagged, and corrections based on preferred terms are suggested.

Does the string reviewer automatically rewrite my UI text?

No, it only suggests changes and never modifies strings directly. Rewrites happen only when the user explicitly asks, keeping full control over final copy with the developer.

What rules apply to settings labels in settingsSchema.ts?

Settings labels follow noun-first labeling, positive boolean logic, and verb stripping. For example, "Disable auto update" becomes "Auto update", and redundant verbs like "Enable" or "Show" are removed.

What output format does a string review produce?

Each suggestion is a numbered list item naming the violated principle, followed by the incorrect phrase and the corrected phrase. No suggestions are given outside this structured list format.