Agent skill

Stop Describing UI Skill: Cut Explanatory Copy From Interfaces

Stop Describing UI is a small agent skill with nine rules that remove explanatory sentences from headings, empty states, toggles and dialogs, and replace them with specific verbs and controls.

Install
git clone https://github.com/artouc/stop-describing-ui.git
View on GitHub

Stars, license and last push from GitHub. Install count as reported by the open skills directory.

What is the Stop Describing UI skill?

Stop Describing UI is an MIT-licensed skill by artouc, built from one SKILL.md. It tells your coding agent to delete copy that explains a feature, lists side effects or describes backend behavior, and to use precise verbs, icons and spacing instead. It applies when writing or reviewing any interface text.

Stop Describing UI is a copy-editing skill, not a visual one. Its SKILL.md opens with a plain principle: an interface shows what the user can do and does not explain itself, so a sentence stays only when the user would otherwise make a real mistake.

It works in two modes. While writing UI, the agent applies the rules as it goes. While reviewing, it goes through every string, applies each rule and presents the result as before and after.

The nine rules in short

  • Do not describe the feature; name the action.
  • Use specific verbs with their object, so New becomes Connect repository.
  • Keep only the most critical consequence of an action.
  • Do not describe backend behavior such as logging or syncing.
  • Do not explain undo when the same control undoes it.
  • Do not repeat what the page title or navigation already says.
  • Do not state what does not exist.
  • Put the upgrade or enable button on screen instead of a sentence about it.
  • Do not rely on text alone; use icon-led short lines and spacing.

Who it is for and who it is not for

Best for

  • Product and front-end teams whose AI-built screens are full of helper text.
  • Reviews of settings pages, empty states, permission notices and onboarding.
  • Developers who want a before and after list for each string.

Not for

  • Marketing copy or long-form content. The rules aim at interface strings. For metadata work, see fixing-metadata.
  • Layout, color or type decisions. Pair it with typeset or layout.
  • Legal or safety text that the user must read. The skill says irreversible and destructive effects always stay.

Use it with UiChemy

This skill tightens the words inside an interface your agent built. When that build must become an editable WordPress page, UiChemy AI to WordPress imports an existing AI build. Click Get Started on uichemy.com.