---
name: copy
description: Writes interface labels in Title Case, short and plain, with one-line descriptions and no em dashes.
title: copy
canonical_url: https://skilld.dev/gh/raphaelsalaja/skills/copy
last_updated: 2026-11-22T01:08:19.000Z
---

> Index of every page on this site: [llms.txt](https://skilld.dev/llms.txt)

> **Skill from skilld.dev.** Follow the user's requested action.
> If the user asked to fork this Skill, follow the fork workflow below. Do not execute the Skill instructions while copying it.
> Otherwise, follow the instructions below for this session. You do not need to install anything.
>
> Supporting files, fetch one when the Skill refers to it: [agents/openai.yaml](https://skilld.dev/api/skills-raw/raphaelsalaja/skills/copy/agents/openai.yaml).
>
> If the user asked to install this Skill, run `npx skilld install raphaelsalaja/skills/copy`. Install writes the Skill files into the project, so every session loads them.
>
> ## Fork workflow
>
> A fork creates an editable local Skill with its original author and licence. The request authorizes copying and local installation.
> 1. Check `./skills/copy`, the project lockfile, and selected Agent targets together. If the local directory or installed Skill exists, stop. Never overwrite an existing directory or Agent target.
> 2. Read [source metadata](https://skilld.dev/api/v1/skills/raphaelsalaja/skills/copy) once. Use sourceUrl, sourceCommit, skillPath, sourceGone, and license. If the source is gone or its path is missing, stop. If license is null, read licence files at the source commit.
> 3. Fetch only the source commit into a temporary Git repository. Do not clone full history. Derive repository_url from sourceUrl, including repository renames. If sourceCommit is absent, resolve the sourceUrl ref once. Set source_commit to that actual commit. Run these commands in one shell call:
>
> ```sh
> git init --quiet "$temporary_dir"
> git -C "$temporary_dir" fetch --quiet --depth=1 "$repository_url" "$source_commit"
> git -C "$temporary_dir" checkout --quiet --detach FETCH_HEAD
> ```
>
> Read applicable licence declarations and notices at that commit. If copying is not permitted, report the restriction and stop.
> 4. Inspect source entries together, then copy the directory containing skillPath into `./skills/copy`. Use the user's path if selected. Keep the original SKILL.md, relative links, scripts, binary assets, and executable modes. Exclude .git metadata. Reject symlinks and paths outside the Skill directory. After checking entries, use cp -a where available. A regular source directory needs no custom copy script. Do not save this page wrapper as SKILL.md.
> Preserve author credit, notices, and applicable licence files from repository or parent directories. Add PROVENANCE.md with the Skill page, source URL, actual commit, original path, and licence. Retain any existing PROVENANCE.md and record new provenance separately. Batch source inspection, copying, and provenance work where practical.
> 5. In the project root, run `skilld install ./skills/copy --mode copy --plain`. If skilld is unavailable, use `npx skilld install ./skills/copy --mode copy --plain`. This known command needs no help lookup. Install does not support --json. Use detected Agent targets, or add --agent for the targets the user selected. Install the local path, never the upstream selector. If installation fails, preserve the local copy and report the exact failure.
> 6. Confirm the local lockfile source and installed Agent copies once. Report the local path, actual commit, and Agent targets. After edits, reinstall the same local path. Upstream updates must not replace it. Do not publish or push unless the user asks.

# Copy

This skill writes and reviews the words inside an interface. It covers labels, placeholders, descriptions, errors, status text and the punctuation they use.

## Casing and punctuation are exact

A label in sentence case is a finding. An em dash is a finding. A label that could lose a word is a finding only when the shorter label still says what happens.

Extra interface beyond the words belongs to `restraint`. Which state a message appears in, such as filtered to zero, belongs to `states`. Where a field error sits and how it ties to its field belong to `forms`.

## Labels take Title Case

Buttons, menu items, tabs, headings and setting names use Title Case. Articles, coordinating conjunctions and prepositions of three letters or fewer stay lowercase unless they come first or last. That is a, an, the, and, but, or, nor, for, so, yet, as, at, by, in, of, off, on, per, to and via. Prepositions of four letters or more, such as With, From and Into, take a capital, and so do short verbs and pronouns such as Is, It and Be. "Add to library" or "Import from CSV" is `copy-title-case`.

## Verbs keep their space

A two-word verb stays two words on a button: `Log In`, `Sign Up`, `Set Up`, `Check Out` and `Back Up`. The joined form is the noun, as in `Login Settings` or `Setup Guide`. Write `Log In to the Dashboard`, never `Log Into`. `Login` or `Setup` on a button is `copy-phrasal-verbs`.

## As few words as still say what happens

"Start Download" on a download screen is `copy-fewest-words`. Show a number on its own when the context already names the noun. "12 items" is `copy-number-not-noun`.

## The key word comes first

In navigation, settings lists and headings, the first two words carry the meaning, and siblings never open on the same word. Buttons keep their verb first. `Manage Users`, `Manage Billing` and `Manage Teams` in one menu is `copy-key-word-first`.

## Buttons start with the verb

A button names what it does, starting with the verb. "OK", "Yes" or "Let's Go" on an action with consequences is `copy-verb-first`.

A confirm button repeats the action from its question, so "Delete Project" answers "Delete this project?" without reading the body. "Yes" there is `copy-confirm-names-the-action`.

The confirm dialog's body names the object and what goes with it: "Delete Q3 Roadmap and its 12 files?" A body reading "Are you sure?" is `copy-confirm-names-the-target`.

The last step of a stepped flow names what it does, such as `Create Workspace`, while earlier steps may read `Next`. `Next` on the step that creates the workspace is `copy-last-step-names-action`.

## Errors say what to do

An error says how to fix the problem in plain words, with no blame and no exclamation mark. "Invalid name" or "Oops! Something went wrong." is `copy-errors-say-the-fix`.

A field error is a sentence in sentence case, an instruction to the user that reuses the label's words. Empty reads "Enter your full name", too long reads "Summary must be 400 characters or less" and a wrong format reads "Enter a date like 27 3 2026". "Please", "sorry", "oops", "valid", "invalid" and "you forgot" never appear, so "Please enter a valid name" is `copy-error-by-kind`.

## Links make sense alone

Link text says where it goes, so it still reads in a list of every link on the page. "Click here", or two "Learn More" links on one page, is `copy-link-text`.

## Instructions name the control

An instruction names the control, never only its shape, colour, position or sound. "Click the green button on the right" is `copy-not-by-place`.

## Toggles name the on state

A switch or checkbox label says what happens when it is on. "Don't Send Read Receipts" is `copy-toggle-on-state`.

## Sentences stay whole

A sentence holding a value is one translatable string with a placeholder. Joining fragments around the value is `copy-whole-sentences`.

## Plain names, never ids

An internal acronym or an invented persona is `copy-plain-words`. Show a thing's display name, not its id. `instagram_graph` in a select is `copy-display-names`.

## One point of view

Things the user owns take one possessive everywhere, either "your" or "my", so the sidebar, page titles and settings agree. A checkbox the user ticks may speak as them, as in "Remember my device". Say "we" only for something a person on the team does, such as "We'll review your appeal". `My Projects` in the sidebar over a `Your Projects` title, or "Change your preferences in My Account", is `copy-one-point-of-view`.

## One action, one name

An action carries the same label in every menu, button, toast and shortcut list. Remove, Delete and Trash for one action is `copy-one-name-per-action`.

Create makes something new, and Add puts something that already exists into a place, such as `Add to Folder`. `Add Project` on a button that makes a blank project is `copy-create-vs-add`.

## One line of description or none

Move optional detail into a tooltip or a linked page. Two lines under a setting is `copy-one-line-description`. Anything the user needs to act, such as a limit, a price or a warning, stays on the page, because `overlays` keeps it out of tooltips. Input requirements, such as password rules and formats, sit between the label and the field, as `forms` sets out.

## Placeholders show an example or nothing

A placeholder holds a sample value in the expected format, such as `name@example.com`, or stays empty. It never repeats the label or gives an instruction, which vanishes on the first keystroke. A search box is the exception and may read `Search…`. `Enter your email` inside an Email field is `copy-placeholder-example`.

## Status matches the moment

"Searched" while the search still runs is `copy-state-tense`.

A status after an action names what changed, so it still reads alone in a toast or a screen reader announcement. "Success!" or "Done" after a delete is `copy-status-names-the-change`. The page that ends a finished flow belongs to `states`.

## Numbers keep their units and their symbols

A non-breaking space keeps a number with its unit, a key with the next key and a short name with its number. Write `10&nbsp;MB`, `⌘&nbsp;K` and `Step&nbsp;2`, or `\u00A0` in a string. `10` ending one line and `MB` starting the next is `copy-nbsp-units`.

Negative numbers and decrements take the minus sign `−`, U+2212. Dimensions and multipliers take `×`, U+00D7, as in `1920 × 1080` and `2×`. A hyphen in `-12` or a letter x in `1920x1080` is `copy-true-symbols`. Values meant to be copied as code keep the hyphen.

## No em dashes, ellipses only for more input

Use a comma or a full stop where an em dash would go. That is `copy-no-em-dash`. Use an ellipsis only in a search placeholder or on a menu item that needs more input before it runs, such as `Export…` or `Rename…`. Wherever it is allowed, the ellipsis is the single character `…`, never three periods. A loading label drops it entirely. "Loading..." or `Export...` is `copy-no-ellipsis`.

## The pair

Every check is a pair. The broken line sits beside the line that replaces it.

| Rule | Broken | Replacement |
| --- | --- | --- |
| `copy-title-case` | `Add to library` and `Import from CSV` | `Add to Library` and `Import From CSV` |
| `copy-phrasal-verbs` | `Login` and `Setup` on buttons | `Log In` and `Set Up`, with `Login Settings` as the page |
| `copy-fewest-words` | `Start Download` on the download screen | `Start` |
| `copy-number-not-noun` | `12 items` | `12` |
| `copy-key-word-first` | `Manage Users`, `Manage Billing`, `Manage Teams` | `Users`, `Billing`, `Teams` |
| `copy-verb-first` | `OK` on a save dialog | `Save` |
| `copy-confirm-names-the-action` | `Yes` under "Delete this project?" | `Delete Project` |
| `copy-confirm-names-the-target` | "Are you sure?" above a delete | "Delete Q3 Roadmap and its 12 files?" |
| `copy-last-step-names-action` | `Next` on the final step of a workspace setup | `Create Workspace` |
| `copy-errors-say-the-fix` | `Oops! Something went wrong.` | `Couldn't save. Check your connection and try again.` |
| `copy-error-by-kind` | `Please enter a valid name` | `Enter your full name` |
| `copy-link-text` | Two `Learn More` links on one page | `Learn More About Exports` |
| `copy-not-by-place` | "Click the green button on the right" | "Select Continue" |
| `copy-toggle-on-state` | `Don't Send Read Receipts` | `Send Read Receipts` |
| `copy-whole-sentences` | `"You have " + count + " new messages"` | `t("inbox.new", { count })` holding the whole sentence |
| `copy-plain-words` | `PDP` | `Product Page` |
| `copy-display-names` | `instagram_graph` | `Instagram` |
| `copy-one-point-of-view` | `My Projects` in the sidebar, `Your Projects` as the page title | `Your Projects` in both |
| `copy-one-name-per-action` | `Remove`, `Delete` and `Trash` for one action | `Delete` everywhere |
| `copy-create-vs-add` | `Add Project` on a button that makes a blank project | `Create Project`, with `Add to Folder` for an existing one |
| `copy-one-line-description` | Two lines under a setting | One line, the optional rest in a tooltip |
| `copy-placeholder-example` | `placeholder="Enter your email"` under an Email label | `placeholder="name@example.com"`, or none |
| `copy-state-tense` | `Searched` while running | `Searching`, then `Searched` |
| `copy-status-names-the-change` | `Success!` after a delete | `Q3 Roadmap deleted` |
| `copy-nbsp-units` | `10 MB` breaking between `10` and `MB` | `10&nbsp;MB` |
| `copy-true-symbols` | `-12` and `1920x1080` | `−12` and `1920 × 1080` |
| `copy-no-em-dash` | `Synced &mdash; 2 minutes ago` | `Synced 2 minutes ago` |
| `copy-no-ellipsis` | `Loading...` and `Export...` | `Loading` and `Export…` |

## Reporting

**Severity.** `HIGH` is an id or internal jargon shown to the user, or a status that says the wrong thing. It is also a confirm button that does not name its action, or a confirm body that does not name its target. `MEDIUM` is a label in the wrong case, a two-line description or an em dash. It is also a button with no verb, an error with no fix, a link that means nothing alone, a negative toggle or a sentence joined from fragments. It is also an instruction that points by colour or place, or one action under two names. It is also a field error that pleads, blames or says "invalid", or `Next` on a flow's last step. It is also a status that does not say what changed. `LOW` is a label one word longer than it needs, a noun the context already names beside a number or siblings that open on the same word. It is also Add for something new, a unit wrapped away from its number or three periods for an ellipsis. It is also a hyphen for a minus sign, or a letter x for a times sign. It is also a joined verb such as `Login` on a button, two possessives for one user or a placeholder that repeats its label.

**Format.** One finding per root cause:

```
file:line - [rule-id] what is wrong
```

Then a `Rule | Count | Severity` summary. `Block` when any `HIGH` remains, `Approve` otherwise. Never `Approve` a file you did not read. Mark every check you could not run as `Not verified`.
