Agent skill

Better Writing

by Lily-404 in Lily-404/blog

UX writing and interface copy. An agent skill from Lily-404/blog.

No licenceAuto-check passedWriting & Content

Install Better Writing

skills CLI
$ npx skills add Lily-404/blog --skill better-writing -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Lily-404/blog better-writing --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Lily-404/blog.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/better-writing .claude/skills/better-writing && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
better-writing
GitHub stars
151
Used in
3 other repos
Token cost
~1.7k tokens
SKILL.md length
909 words
Files
2
Skills in repo
8
Repo updated
First seen
Licence
None found

At a glance

UX writing and interface copy. An agent skill from Lily-404/blog.

  • Reviewing any user-facing text
  • SKILL.md covers Recon the existing voice, One voice, flexible tone, Address the reader directly and Plain words over clever ones, plus 9 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Placeholder text

What it does

Better Writing is an agent skill from Lily-404/blog. UX writing and interface copy. Use when writing or reviewing any user-facing text. Triggers on UX writing, microcopy, button labels, link text, error messages, empty states, placeholder text, settings labels, capitalization, sentence case, voice and tone.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Writing & Content, covering Brand voice and tone.

When your agent uses it

  • Reviewing any user-facing text
  • Placeholder text
  • Settings labels

Example prompts

  • “/better-writing”

What it can do on your machine

Read from SKILL.md and the folder at commit cce7f29. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are html).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Better Writing loads about 1.7k tokens when it runs. Until then it costs about 68 tokens; SKILL.md has 909 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~68
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 909 words (~1,659 tokens).

“Clear and brief beats clever; consistent beats varied. The best error message is the interaction redesigned so the error cannot happen.”

— opening of SKILL.md by Lily-404
name
better-writing

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in .agents/skills/better-writing of Lily-404/blog.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit cce7f29

Used in 3 other repositories

We found 8 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 3 other GitHub owners. This page covers the copy in Lily-404/blog, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Better Writing next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Better Writing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Better Writing this skillLily-404/blog1513 repos~1.7kAutomated safety check: PassNone
Avoid AI Writingconorbronsdon/avoid-ai-writing4.9k3 repos~8.1kAutomated safety check: PassMIT
BrandOhh-889/skyroc79513 repos~733Automated safety check: PassMIT
Khazix WeChat Article WriterKKKKhazix/khazix-skills21k1 repos~2.9kAutomated safety check: PassMIT
Writing Guidelinesvercel-labs/agent-skills32k7 repos~309Automated safety check: PassNone
Unslop AI Writing Cleanuptheclaymethod/unslop518—~1.7kAutomated safety check: PassMIT

Similar skills

  • Avoid AI Writing

    conorbronsdon/avoid-ai-writing

    Audit and rewrite content to remove AI writing patterns ("AI-isms").

    4.9k GitHub starsUsed in 3 repos~8.1k tokens
    Writing & ContentAuto-check passed
  • Brand

    Ohh-889/skyroc

    Brand voice, visual identity, messaging frameworks, asset management, brand consistency.

    795 GitHub starsUsed in 13 repos~733 tokens
    Writing & ContentAuto-check passed
  • Khazix WeChat Article Writer

    KKKKhazix/khazix-skills

    Writes long-form WeChat official account articles in the personal style of the Khazix account, from briefs, links, PDFs or rough notes, with a topic quality check.

    21k GitHub starsUsed in 1 repo~2.9k tokens
    Writing & ContentAuto-check passed
  • Writing Guidelines

    vercel-labs/agent-skills

    Official

    Review docs/prose for Writing Guidelines compliance. An agent skill from vercel-labs/agent-skills.

    32k GitHub starsUsed in 7 repos~309 tokens
    Writing & ContentAuto-check passed
  • Unslop AI Writing Cleanup

    theclaymethod/unslop

    Removes AI writing tells from prose through an audit-first flow, routing to a two-pass rewrite, a report-only cleanup, voice teaching or mimicry depending on the sub-command used.

    518 GitHub stars~1.7k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • UX Writing

    content-designer/ux-writing-skill

    Applies UX writing practice to interface copy such as buttons, errors, forms and onboarding, using four quality standards and accessibility guidance.

    224 GitHub starsUsed in 1 repo~3.8k tokens
    Writing & ContentAuto-check passed

More from Lily-404/blog

All 8 skills in this repo
  • Better Typography

    Lily-404/blog

    Web typography. An agent skill from Lily-404/blog.

    151 GitHub starsUsed in 5 repos~2.8k tokens
    Auto-check passed
  • Accessibility engineering for product interfaces. An agent skill from Lily-404/blog.

    151 GitHub starsUsed in 3 repos~2.2k tokens
    Auto-check passed
  • Better Colors

    Lily-404/blog

    Color systems for digital products. An agent skill from Lily-404/blog.

    151 GitHub starsUsed in 3 repos~2k tokens
    Auto-check passed
  • Better Layout

    Lily-404/blog

    Layout structure for web interfaces. An agent skill from Lily-404/blog.

    151 GitHub starsUsed in 3 repos~1.5k tokens
    Auto-check passed
  • Interface Review

    Lily-404/blog

    Interface review of a change rather than a screen: uncommitted work, the current branch, or a pull request.

    151 GitHub starsUsed in 3 repos~2.7k tokens
    Auto-check passed
  • Better Interface

    Lily-404/blog

    Cross-discipline interface review. An agent skill from Lily-404/blog.

    151 GitHub starsUsed in 2 repos~2.4k tokens
    Auto-check passed

Questions about Better Writing

What does Better Writing do?

UX writing and interface copy. An agent skill from Lily-404/blog. Better Writing is an agent skill from Lily-404/blog. UX writing and interface copy.

When should I use Better Writing?

Better Writing fits situations like: reviewing any user-facing text; placeholder text; settings labels.

How do I install Better Writing in Claude Code?

Run `npx skills add Lily-404/blog --skill better-writing -a claude-code`. Or copy the skill folder (.agents/skills/better-writing in Lily-404/blog) into .claude/skills/better-writing in your project. Claude Code loads it when a task matches its description.

How do I install Better Writing in Codex?

Run `npx skills add Lily-404/blog --skill better-writing -a codex`. Or copy the skill folder (.agents/skills/better-writing in Lily-404/blog) into .agents/skills/better-writing in your project. Codex loads it when a task matches its description.

Can I use Better Writing in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Lily-404/blog --skill better-writing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/better-writing, .gemini/skills/better-writing, .github/skills/better-writing and .opencode/skills/better-writing in your project.

What does Better Writing need to run?

SKILL.md names no scripts, command-line tools or credentials: Better Writing is instructions for the agent only.

Does Better Writing access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Better Writing safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Better Writing use?

No licence was found for Better Writing or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Better Writing use?

About 1.7k tokens (SKILL.md is roughly 6.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Better Writing?

Skills that share tags, products or a category with Better Writing: Avoid AI Writing (conorbronsdon/avoid-ai-writing, 4.9k stars), Brand (Ohh-889/skyroc, 795 stars), Khazix WeChat Article Writer (KKKKhazix/khazix-skills, 21k stars) and Writing Guidelines (vercel-labs/agent-skills, 32k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Better Writing?

Lily-404 (a GitHub user) maintains it in Lily-404/blog, which has 151 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on September 23, 2026.

Source: Lily-404/blog on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.