How does the scoring system work?

The audit starts at 100 points and subtracts points based on the severity of findings: Critical (-15), Warning (-7), and Info (-2), providing a measurable quality metric.

What is Textual UX in the context of software development?

Textual UX refers to how a solution communicates with users through text, including error messages, prompts, and labels that shape user perception and productivity.

What is 'jargon leakage' in a software audit?

Jargon leakage occurs when internal technical concepts, variable names, or architecture terms are exposed to end users who may not have the technical context to understand them.

Can this skill help with internationalization or grammar?

Yes, it specifically checks for common textual bugs like pluralization errors, incorrect article usage, and inconsistent punctuation across the codebase.

How does the Textual UX skill identify user-facing text?

The skill scans the codebase for common output patterns such as console logs, print statements, exception handlers, and string literals within UI or CLI handler files.

Textual UX Auditor

Name: Textual UX Auditor
Author: nsalvacao

bynsalvacao

0•

Herramientas de Diseño

Audits and improves the quality of user-facing text, error messages, and microcopy to ensure consistent and professional communication.

The Textual UX skill provides a comprehensive audit of all user-facing communication within a solution, including error messages, logs, help text, and interactive prompts. By scanning the codebase for output patterns and string literals, it evaluates clarity, tone, and verbosity while identifying problematic 'jargon leakage' where internal technical terms are exposed to end users. This skill is essential for developers and product teams aiming to build empathetic, professional, and highly usable interfaces by ensuring every micro-interaction communicates effectively and provides actionable feedback.

Características Principales

01Qualitative assessment of error messages based on clarity and context

020 GitHub stars

03Tone consistency analysis across different codebase modules

04Automated inventory of error messages, logs, help text, and prompts

05Detection of internal jargon and technical leakage in user output

06Standardized UX scoring system to track communication quality

Casos de Uso

01Removing developer-centric jargon and variable names from production-facing alerts

02Ensuring a consistent brand voice and tone across a large, multi-contributor codebase

03Refining CLI error messages to be more helpful and actionable for end users

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nsalvacao/nsalvacao-claude-code-plugins textual-ux

For use in Claude.ai and ChatGPT

Características Principales

01Qualitative assessment of error messages based on clarity and context

020 GitHub stars

03Tone consistency analysis across different codebase modules

04Automated inventory of error messages, logs, help text, and prompts

05Detection of internal jargon and technical leakage in user output

06Standardized UX scoring system to track communication quality

Casos de Uso

01Removing developer-centric jargon and variable names from production-facing alerts

02Ensuring a consistent brand voice and tone across a large, multi-contributor codebase

03Refining CLI error messages to be more helpful and actionable for end users

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nsalvacao/nsalvacao-claude-code-plugins textual-ux

For use in Claude.ai and ChatGPT