agentleFS
mrhinklemrhinkle/VibeCoding-a-Website/.claude/skills/content-auditor/SKILL.md

content-auditor

Skill17 starsChanged 7 months agoMITView on GitHub

The Content Auditor reviews all website copy for quality, consistency, and completeness. It identifies placeholder text, validates factual accuracy, checks brand voice consistency, verifies grammar and spelling, assesses CTAs, detects missing content sections, validates contact information, and identifies broken promises or contradictions. Business Value: Content quality directly impacts conversion rates, trust, SEO rankings, and user experience. This skill ensures every page meets professional standards before launch. The Content Auditor performs comprehensive copy auditing across your entire website, checking: Trust &…

The file

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 3 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Run after major updates: - Check new/modified content immediately

    line 156
  2. Distinctive:

    Not all suggestions are mandatory - prioritize by business impact

    line 163
  3. Distinctive:

    Create content templates to reduce placeholder problems

    line 168

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Content Auditor Skill

Skill Summary

The Content Auditor reviews all website copy for quality, consistency, and completeness. It identifies placeholder text, validates factual accuracy, checks brand voice consistency, verifies grammar and spelling, assesses CTAs, detects missing content sections, validates contact information, and identifies broken promises or contradictions.

Business Value: Content quality directly impacts conversion rates, trust, SEO rankings, and user experience. This skill ensures every page meets professional standards before launch.


What This Skill Does

The Content Auditor performs comprehensive copy auditing across your entire website, checking:

  1. Placeholder Text Detection - Identifies draft or template text that should have been replaced
  2. Factual Accuracy Checks - Flags claims that may need verification (dates, statistics, product features)
  3. Brand Voice Consistency - Ensures tone and language align across all pages
  4. Grammar and Spelling - Catches typos and grammatical errors
  5. CTA Quality Assessment - Evaluates call-to-action clarity, persuasiveness, and placement
  6. Consistent Messaging - Identifies contradictions in messaging across pages
  7. Contact Info Consistency - Verifies phone numbers, emails, addresses match across site
  8. Missing Content Sections - Identifies pages missing critical sections (about, contact, privacy)
  9. Broken Promises - Detects misalignment between claims and actual content

Why This Matters (Business Impact)

Trust & Credibility: Placeholder text or typos immediately signal an unprofessional, incomplete site

  • Poor copy quality costs customers. Studies show 59% of users leave poorly written sites
  • Grammar/spelling errors reduce trust perception by 71%

Conversion Optimization: Clear, consistent CTAs drive action

  • Weak or missing CTAs eliminate 30-50% of potential conversions
  • Inconsistent messaging confuses users and increases bounce rates

Legal & Compliance: Accurate contact info and consistent claims protect you legally

  • Outdated contact information creates support friction
  • Broken promises (on website vs. actual service) lead to customer complaints and chargebacks

SEO Impact: Quality, original content ranks better

  • Placeholder text damages rankings and wastes crawl budget
  • Factual errors or contradictions confuse search engines

Brand Perception: Consistent voice reinforces brand identity

  • Inconsistent tone appears unprofessional and chaotic
  • Weak CTAs undermine conversion goals

How to Use This Skill

Basic Usage

Run the content audit across my entire site

Common Scenarios

Before Launch:

Audit my site for placeholder text, grammar errors, and broken CTAs

Brand Consistency Check:

Check if my brand voice is consistent across all pages
Check for messaging contradictions on my site

Specific Page Audits:

Audit my homepage copy for clarity and CTAs
Review my pricing page for factual accuracy

Content Gap Analysis:

Find pages that are missing critical sections (about, contact, privacy, terms)

What You'll Get

The audit produces a comprehensive report with:

  1. Critical Issues (must fix before launch)
    • Placeholder text
    • Missing critical sections
    • Broken contact information
    • Factual contradictions
  2. High Priority Issues (fix within 1-2 weeks)
    • Grammar/spelling errors
    • Weak CTAs
    • Inconsistent brand voice
    • Missing contact info on pages that need it
  3. Medium Priority Issues (fix next sprint)
    • Messaging inconsistencies
    • CTA placement improvements
    • Voice tone variations
  4. Audit Summary
    • Pages audited
    • Total issues found by severity
    • Recommended fix priority
    • Estimated time to fix
  5. Detailed Issue List
    • Page and section location
    • Type of issue
    • Current text/content
    • Suggested fix
    • Business impact

Audit Rubric

The Content Auditor uses a detailed scoring rubric that evaluates:

CategoryExcellent (100)Good (75)Fair (50)Poor (25)Critical (0)
Placeholder TextNo placeholdersMinimal (1-2)Some (3-5)Many (6+)Extensive placeholders detected
Factual AccuracyAll claims verified and currentMinor date updates neededSome claims unclearMultiple unverified claimsFalse or misleading claims
Brand VoicePerfectly consistent across all pages1-2 slight variations3-4 tone inconsistenciesVoice varies significantlyNo consistent brand voice
Grammar/SpellingPerfect1-2 typos3-5 errors6+ errors10+ errors, hard to read
CTA QualityClear, compelling, properly placedGood with minor improvementsSome CTAs weakMost CTAs unclearMissing or broken CTAs
Consistent MessagingNo contradictions1 minor contradiction2-3 contradictions4+ contradictionsMajor contradictory claims
Contact InfoComplete, consistent, currentMinor variationsSome outdated infoMultiple discrepanciesCritical contact info missing
Content CompletenessAll sections present1 minor section missing2-3 sections missing4+ sections missingMultiple critical sections missing
Broken PromisesNo discrepancies between claims and reality1 minor misalignment2-3 misalignments4+ broken promisesMajor contradiction between claims and delivery

See references/audit-rubric.md for detailed scoring criteria and examples.


Checklist: Before Running Audit

  • Site is publicly accessible or you have a staging URL
  • Homepage is complete and representative of final state
  • At least 80% of site pages are published (drafts excluded)
  • You've identified key pages to audit (or we'll audit all pages)
  • Brand guidelines document exists (helps with voice consistency)

Optimization Tips

For Best Results

  1. Run before launch - Catch issues while you can still fix them easily
  2. Run quarterly - Content evolves; maintain quality over time
  3. Run after major updates - Check new/modified content immediately
  4. Combine with SEO audit - SEO and content quality work together

Understanding Results

  • Critical issues block launch - fix immediately
  • High priority issues affect conversions - fix within 1-2 weeks
  • Medium priority issues improve polish - fix when you have capacity
  • Not all suggestions are mandatory - prioritize by business impact

Making Fixes Efficient

  1. Group issues by page for batch editing
  2. Establish brand voice guidelines to prevent future issues
  3. Create content templates to reduce placeholder problems
  4. Schedule monthly content reviews to catch issues early

Output & Deliverables

Your audit produces:

  1. Audit Report (HTML or PDF)
    • Executive summary with score by category
    • Page-by-page breakdown
    • Issue list with severity and recommendations
  2. Detailed Findings
    • Location of each issue (page, section, paragraph)
    • Current text and suggested fix
    • Business impact explanation
  3. Priority Fix List
    • Organized by severity (critical → medium)
    • Estimated time to fix each issue
    • Quick wins (issues that take <5 min to fix)
  4. Before/After Examples
    • Shows how copy will improve with fixes
    • Helps content team understand expectations

FAQ

Q: Will this audit catch every typo? A: The audit catches obvious spelling and grammar errors, but relies on your review for context-specific issues. Consider professional proofreading for critical pages.

Q: How do I know what's a "broken promise"? A: The auditor flags discrepancies between claims and actual content. Example: "24/7 support" claimed but contact form says "replies in 24 hours."

Q: Can I audit just specific pages? A: Yes! You can specify which pages to audit, or we'll audit the entire site and prioritize results by page importance.

Q: How often should I run this audit? A: Run before launch, then quarterly or after major content updates. High-traffic sites benefit from monthly audits.

Q: What if I have multiple brand voices (for different audiences)? A: Document these in your brand guidelines so the auditor knows they're intentional. It will still flag inconsistencies within each voice/audience segment.

Q: How do I fix the issues found? A: The audit provides specific recommendations for each issue. For content rewrites, consult with your copywriter or marketing team.

Q: Does this check for plagiarism or AI-generated content? A: This audit focuses on quality, clarity, and consistency. For plagiarism detection, use a dedicated tool like Copyscape or Turnitin.


Next Steps

  1. Run your first audit to establish baseline content quality
  2. Prioritize critical and high-priority issues for immediate fixing
  3. Create a content update plan for medium-priority improvements
  4. Schedule quarterly re-audits to maintain standards
  5. Share findings with your content team to prevent future issues

Last updated: 2024

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.