content-audit

Audit prose against content-design.md for banned words, voice violations, and register mismatches.

1|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/robritacca-dotcom/design-system --skill content-audit-robritacca-dotcom
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: content-audit
Source: https://github.com/robritacca-dotcom/design-system/tree/main/.claude/skills/content-audit
Command: npx skills add https://github.com/robritacca-dotcom/design-system --skill content-audit-robritacca-dotcom

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Shipped copy drifts from a project's writing standards over time, accumulating AI-writing tells, banned words, and tone mismatches that manual review misses. This Skill systematically scans prose against a single content guide and reports every violation with a suggested rewrite. ## Core Features & Use Cases - Scoped auditing: Accepts a file path or one of many named scopes (readme, registry, case-studies, chat, nav, footer, palette, mcp, cli, and more) that map to specific data files, page modules, and string literals across the repo. - Three severity levels: Classifies findings as Banned (hard-ban words, em dashes, Title Case, first person where prohibited), Rationed (density-checked words, American spellings), or Judgment (rhythm uniformity, rule-of-three stacks, register mismatches). - Actionable reports: Each finding includes the file path and line, the offending text, the rule it breaks, and a suggested rewrite, ending with per-severity counts and the strongest finding. - Use Case: Ask to audit the chat scope before a release to catch promotional tone or banned words in the site chat's greeting, starter chips, and guardrail notices that no build validator covers. ## Quick Start Ask the assistant to run a content audit on the readme scope and report any violations of content-design.md with suggested rewrites.

Frequently Asked Questions about content-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit website copy for AI-writing tells?▼

Invoke the content audit with a scope such as a page slug, a data file, or a named surface like chat or readme. The skill scans the prose against content-design.md and reports each violation with its location, severity, and a suggested rewrite.

What does the content audit check for?▼

It checks three severity tiers: banned items like hard-ban words, em dashes, Title Case, and first person where prohibited; rationed words flagged for density; and judgment issues like rhythm uniformity, adjective stacks, and register mismatches.

Can I audit a single page instead of the whole site?▼

Yes. Pass a specific file path or a page slug such as about to scope the audit to that page folder. Named scopes like case-studies, registry, or footer target specific data files and components.

What content is excluded from the audit?▼

The audit never flags content-design.md itself, quoted examples, skill instruction bodies, code and identifiers, third-party text, or the fictional demo copy in labs rebuilds and template screens.

Does the content audit modify files automatically?▼

No. It only reports findings with suggested rewrites. For generated files such as registry-driven README regions, it directs you to fix the source data or generator rather than the generated output.