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.