secondary-text-audit

Featured

Audit the subordinate copy in a UI — section descriptions, field helper text, hints, card subtitles, empty-state body copy, tooltip bodies — against the secondary-text ruleset, and emit a per-string keep/rewrite/delete verdict table a coding agent can apply. Use this skill whenever the user asks to review, tighten, trim, or clean up UI copy, microcopy, descriptions, helper text, subtitles, hints, or empty states; asks "is this copy necessary?", "does this description earn its place?", "why is our UI so wordy?"; wants a settings page or dialog decluttered; or is writing new secondary text and wants it checked before it ships — even if they don't say "audit". For view-level UX behavior (labels, missing states, redundancy, one-primary-action), use ux-semantics-audit; for palette and tokens, use color-audit. This skill owns everything about whether a piece of subordinate copy should exist at all and how it should read.

AI & Automation 488 stars 37 forks Updated today MIT

Install

View on GitHub

Quality Score: 88/100

Stars 20%
90
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Secondary-Text Audit Extract every piece of subordinate copy in a surface and put each one on trial. The ruleset's premise is that **secondary text defaults to absent**: it exists only to carry information the user needs before acting that the label, the control's shape, and the surrounding context do not already give them. Most shipped secondary text describes what something *is*, which the label already did. That text goes. The output is a verdict table, not prose commentary. Every row resolves to `keep`, `rewrite`, or `delete`, and every `rewrite` carries its replacement string. ## Design philosophy (read this — it shapes every judgment call) 1. **Delete is the expected majority outcome.** This is the inversion that makes the skill useful. An audit that keeps most of what it finds has not applied the ruleset; it has admired the copy. If your table is mostly `keep`, re-run the category test on every `keep` row and mean it. 2. **Uncertainty resolves to `delete`.** When a string sits between `delete` and `rewrite`, choose `delete` — the primary label almost always suffices. This is the opposite of the precision-over-recall bias in `ux-semantics-audit`, and deliberately so: there, a false positive makes an agent break working UI; here, the cost of a wrong `delete` is one line of copy, and the cost of a wrong `keep` is permanent noise on the screen. 3. **Judge the rendered pair, never the key name.** A verdict needs the label the user actually s...

Details

Author
rome-os
Repository
rome-os/rome
Created
2 weeks ago
Last Updated
today
Language
TypeScript
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

audit

Analyses code from several independent perspectives, then makes those perspectives argue with each other until they converge on a shared verdict. Each lens reviews blind, every finding is cross-examined by a lens that wants to kill it, conflicts are resolved as explicit trade-offs rather than averaged away, and the result is a ranked findings table with recorded dissent plus a full analysis. Use when the user says "/audit", "audit this code", "red-team this", "review this code from every angle", "review this code", "critique this", "analyse this code", "what's wrong with this", "look at this from every angle", "is this any good". For rewriting use rewrite, for improving in place use refactor, for UI use reskin. This skill judges code — for measuring data and writing the result up as a report, use report instead.

0 Updated today
olcayseygan
AI & Automation Listed

ai-writing-audit

Audit and repair text that reads as machine written. Any length, any format: a two line direct message, an automated message sequence, an objection reply, a caption, a carousel slide, a spoken script, a landing page, an essay. Runs two layers, surface tells and discourse tells, behind a false positive gate, and returns findings with a repair for each. Use on an existing draft. Do not use to compose a first draft.

0 Updated 5 days ago
thebgtagency
AI & Automation Listed

unhobble

Audit and rightsize a context surface — CLAUDE.md, AGENTS.md, a SKILL.md, a system prompt, or a single prompt — against the Claude-5 context-engineering reversals. Measures the surface (token budget, how much of it is phrased as hard rules vs judgment, near-duplicate sections, contradiction candidates, filesystem-derivable content, progressive-disclosure gaps), then adjudicates each section keep / relocate / delete using a grounding-aware predicate: prose backed by an independent mechanism is decorative and free to cut, prose that is the only carrier of a behavior is a real bet. Also rewrites prompts and skills from prohibition-form into judgment-form. Anthropic deleted >80% of Claude Code's system prompt for Claude 5 with no eval loss; this is the repeatable version of that cut. Use when: (1) a CLAUDE.md or AGENTS.md has grown and you want to know what is safe to remove, (2) an agent is ignoring or colliding with its own instructions, (3) a prompt is long and over-constrained and underperforming, (4) auditin

3 Updated today
broomva