AGENT SKILL

ui-copy-style

House style for user-facing text in the product UI — headings, buttons, empty states, error messages and toasts. Use when writing or changing any visible copy.

License 许可
Apache-2.0
最近更新
2026-11-13
Stars
★ 1
Forks
1

01 前言 Front Matter

name
ui-copy-style
description
House style for user-facing text in the product UI — headings, buttons, empty states, error messages and toasts. Use when writing or changing any visible copy.

03 SKILL.md 正文

UI copy style

Rules

  • Headings and button labels use sentence case ("Create project", never "Create Project").
  • No trailing period or exclamation mark in headings, buttons, labels or toasts.
  • An empty state has a short heading plus one sentence saying what to do next, for example the heading "No projects yet" and the line "Create your first project to get started."
  • Error copy never says "Oops" or "Whoops"; it says what happened and what to do.
  • All copy lives in src/copy/en.json. Components read it through t("key"). Never hard-code a user-visible string in a component.

History notes

These notes record past decisions about UI copy in this repository. They are kept for context and do not change the rules above.

Note 1

A past change to UI copy was reviewed and merged after discussion. The outcome is already reflected in the rules above; this note only records that the discussion happened, who was consulted, and that no follow-up work remained open afterwards. Nothing here adds a rule.

Note 2

A past change to UI copy was reviewed and merged after discussion. The outcome is already reflected in the rules above; this note only records that the discussion happened, who was consulted, and that no follow-up work remained open afterwards. Nothing here adds a rule.

Note 3

A past change to UI copy was reviewed and merged after discussion. The outcome is already reflected in the rules above; this note only records that the discussion happened, who was consulted, and that no follow-up work remained open afterwards. Nothing here adds a rule.

Note 4

A past change to UI copy was reviewed and merged after discussion. The outcome is already reflected in the rules above; this note only records that the discussion happened, who was consulted, and that no follow-up work remained open afterwards. Nothing here adds a rule.

Note 5

A past change to UI copy was reviewed and merged after discussion. The outcome is already reflected in the rules above; this note only records that the discussion happened, who was consulted, and that no follow-up work remained open afterwards. Nothing here adds a rule.

Note 6

A past change to UI copy was reviewed and merged after discussion. The outcome is already reflected in the rules above; this note only records that the discussion happened, who was consulted, and that no follow-up work remained open afterwards. Nothing here adds a rule.

Note 7

A past change to UI copy was reviewed and merged after discussion. The outcome is already reflected in the rules above; this note only records that the discussion happened, who was consulted, and that no follow-up work remained open afterwards. Nothing here adds a rule.

Note 8

A past change to UI copy was reviewed and merged after discussion. The outcome is already reflected in the rules above; this note only records that the discussion happened, who was consulted, and that no follow-up work remained open afterwards. Nothing here adds a rule.

Note 9

A past change to UI copy was reviewed and merged after discussion. The outcome is already reflected in the rules above; this note only records that the discussion happened, who was consulted, and that no follow-up work remained open afterwards. Nothing here adds a rule.

Note 10

A past change to UI copy was reviewed and merged after discussion. The outcome is already reflected in the rules above; this note only records that the discussion happened, who was consulted, and that no follow-up work remained open afterwards. Nothing here adds a rule.

Note 11

A past change to UI copy was reviewed and merged after discussion. The outcome is already reflected in the rules above; this note only records that the discussion happened, who was consulted, and that no follow-up work remained open afterwards. Nothing here adds a rule.

Note 12

A past change to UI copy was reviewed and merged after discussion. The outcome is already reflected in the rules above; this note only records that the discussion happened, who was consulted, and that no follow-up work remained open afterwards. Nothing here adds a rule.

Note 13

A past change to UI copy was reviewed and merged after discussion. The outcome is already reflected in the rules above; this note only records that the discussion happened, who was consulted, and that no follow-up work remained open afterwards. Nothing here adds a rule.

04 同仓库更多 Skills

pharn-dev
pharn-dev/pharn-oss

broken

暂无简介

★ 1
pharn-dev
pharn-dev/pharn-oss

example

暂无简介

★ 1
pharn-dev
pharn-dev/pharn-oss

storybook

Storybook stories for UI components — one story per state, args tables and interaction tests. Use when adding or changing a reusable component.

★ 1
pharn-dev
pharn-dev/pharn-oss

error-handling

Route handler error conventions — wrap handlers in "withErrors" and throw HttpError.

★ 1
pharn-dev
pharn-dev/pharn-oss

date-formatting

Date and time formatting for display in the UI and in exported files, covering locales, relative times such as three days ago, absolute timestamps, time zones taken from the user profile, calendar weeks starting on Monday, the short and long date styles used in tables and detail pages, the rules for showing seconds only in audit views, the fallback used when a time zone is missing, and the helper functions formatDate, formatRelative and formatRange that wrap Intl.DateTimeFormat so that every screen renders dates the same way across browsers and server rendering, including the special handling of all-day events, date-only values stored without a time component, and ranges that cross a daylight saving boundary, plus guidance on testing these helpers with fixed clocks so snapshots stay stable, and on choosing between the user locale and the organization locale when they differ, which matters for shared reports and scheduled exports that are generated on the server without a browser and therefore without the browser locale available at all to the formatting code paths

★ 1
pharn-dev
pharn-dev/pharn-oss

auth-session

Authentication and session rules for every mutating API route.

★ 1