Index of every page on this site: llms.txt
All skills
jakubkrehel avatar

/better-writing

@672ae44
by Jakub Kreheljakubkrehel/skills12k stars
484
Run it yourself

Writes and reviews interface copy, from labels and errors to empty states and confirmations, so it matches the product's voice and tells people what to do next.

  • 4 files
  • 12.4 KB
  • Updated 3 days ago
  • GitHub
Use this Skill: https://skilld.dev/gh/jakubkrehel/skills/better-writing

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

patterns.md

≈715 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Copy patterns

Templates for destructive flows and status copy, and recipes for plurals and locale formatting.

Destructive flows

Situation Copy
Reversible, frequent action Toast: "Project archived" with an Undo action
Irreversible, one item Title: "Delete 'Q3 report'?" Body: "This permanently deletes the report and its 4 comments." Buttons: Delete report, Cancel
Irreversible, many items Title: "Delete 12 files?" Body: "You can't undo this." Buttons: Delete 12 files, Cancel
Affects other people Body names who: "The 8 members of Design lose access."
Account, workspace or repository Field label: "Type 'acme-web' to confirm". The button stays disabled until it matches

An undo toast carries an action, so how long it stays on screen is better-accessibility's.

Status copy

State Pattern Example
In progress Verb in -ing plus the object "Saving changes…", "Loading invoices…"
Done Object plus past-tense verb, no "successfully" "Changes saved", "Invite sent to sam@example.com"
Failed What didn't happen, then the next step "Changes not saved. Check your connection and try again."
Unavailable Why, and what unlocks it, beside the control "Add a payment method to publish"
Partial Counts for both outcomes "9 of 12 files uploaded. Retry 3 failed files"

Keep the in-progress and done strings parallel, so "Saving changes…" resolves to "Changes saved".

Plurals and placeholders

Write one message per sentence in the project's message format, shown here in ICU MessageFormat. The variable sits inside the sentence and the translator moves it:

inbox.count = {count, plural,
  =0 {No new messages}
  one {# new message}
  other {# new messages}
}
invite.sent = {name} invited you to {project}

=0 matches the number zero exactly. one and other are plural categories, and a translator adds few or many where the language needs them. Without a library, pick the category with new Intl.PluralRules(locale).select(count).

Locale formatting

Never hand-build a number, date or list. Pass the user's locale to Intl:

Value Call en-US output
Currency new Intl.NumberFormat(locale, { style: "currency", currency: "EUR" }) €4,320.00
Unit new Intl.NumberFormat(locale, { style: "unit", unit: "megabyte" }) 12 MB
Date new Intl.DateTimeFormat(locale, { dateStyle: "medium" }) Jun 30, 2026
Relative time new Intl.RelativeTimeFormat(locale, { numeric: "auto" }).format(-1, "day") yesterday
List new Intl.ListFormat(locale, { type: "conjunction" }) Ana, Ben, and Cy

Intl.ListFormat follows each locale's own comma and conjunction rules, so never join names with ", " and " and " by hand.

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No third-party reports yet.

Signed by skilld at 672ae44. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 3 days ago

README badge

README badge for jakubkrehel/skills/better-writing