ux-writing SKILL.md skillA
ux-writing from scarletkc/agents is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add scarletkc/agents/ux-writing@git:20260824.d5a3123Pins git:20260824.d5a3123 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- scarletkc/agents
- Path
skills/ux-writing/SKILL.md- Versions recorded
- 5
- Latest version
- git:20260824.d5a3123, committed Aug 24, 2026
- First version recorded
- Aug 15, 2026
- Size
- 16,614 bytes
- Repository stars
- 225
- License
- Apache-2.0
Judgment rules for user-facing text and docs: CLI and diagnostic output, error and help text, README and docs structure, code comments, titles, and generated reports, decks, or exports. Use when writing or changing any user-visible string, when adding or restructuring docs or deciding which page owns a fact, when a page is about to record a version, a deployment state, or a value the code already owns, when a comment, title, or artifact could carry the reasoning or an abandoned option behind…
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# UX Writing & Docs User-visible text is product behavior and carries the same quality bar as code. Every rule below is distilled from a real defect caught in review, and keeps its counter-example because the reasoning is the point. When in doubt, re-read the output as the user who just hit the problem. ## Status output & diagnostics - **Report effective values, not stored ones.** A status display answers "what will happen when I run this", so resolve values exactly the way the runtime does, including environment variables and layered config. *Counter-example: a config viewer printed "API key set: no" while an env var held the key the next run would actually use.* - **Diagnostics must stay truthful under failure.** When one config layer fails to load, fall back to the most complete state that still loads, never to blank defaults. A diagnostic that misreports is worse than one that aborts. *Counter-example: a broken project-level config made a doctor command check blank defaults and report a missing API key that was in fact configured; the fake failure buried the real one.* - **Show deltas, not dumps.** A health/diagnostic command lists what …
Read the whole file at its exact version.
How to install
mdr add scarletkc/agents/ux-writing@sha256:bbee2699b22587a0The line at the top of this page pins the label git:20260824.d5a3123, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_oxz77rshbzenfjkr)
5 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 5 versions of this file, between Aug 15, 2026 and Aug 24, 2026, about one every 2 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260824.d5a3123 latest | 2026-08-24 | d5a3123 | 16,614 B | A | view · diff |
| git:20260820.2cc8926 | 2026-08-20 | 2cc8926 | 16,625 B | A | view · diff |
| git:20260820.6861763 | 2026-08-20 | 6861763 | 15,740 B | A | view · diff |
| git:20260815.47b8ddd | 2026-08-15 | 47b8ddd | 12,126 B | A | view · diff |
| git:20260815.c29dad1 | 2026-08-15 | c29dad1 | 11,680 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (16614 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
scarletkc/agents · 225 stars · license Apache-2.0 · pushed 2026-10-18 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_oxz77rshbzenfjkr GET https://markdownregistry.com/api/v1/resolve?ref=scarletkc/agents/ux-writing GET https://markdownregistry.com/api/v1/blob/bbee2699b22587a072d5f6fd7a0b931c2db508892768035f46ffdbd6092e4020
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.
More from scarletkc/agents
Every file in scarletkc/agents