Avoid keyword stuffing

SkillDev tools

Keyword-stuffing is a skill for auditing web pages for over-optimisation. It checks content, meta tags, and alt text for unnatural keyword accumulation, which is useful when reviewing AI-generated text that may repeat target phrases excessively.

Available today. Use it from your connected AI after setup.

Have the skill available to your agent alongside the pages or content you want reviewed.

Then ask your AI: use the Avoid keyword stuffing skill

What your AI can do with it

  • Audit content pages for over-optimisation
  • Detect excessive repeated target phrases in AI-generated content
  • Check meta tags for unnatural keyword accumulation
  • Check alt text for unnatural keyword accumulation

Getting started

  1. Have the skill available to your agent alongside the pages or content you want reviewed.
  2. Ask the agent to audit a content page for over-optimisation.
  3. Ask it to review AI-generated text for excessive repetition of target phrases.
  4. Ask it to check meta tags and alt text for unnatural keyword accumulation.

What this skill tells your AI

The instructions your AI receives, as published by thedaviddias/front-end-checklist in skills/keyword-stuffing/SKILL.md and read by ahel’s review.

Google's spam detection algorithms penalise pages that unnaturally repeat keywords to manipulate rankings. Keyword-stuffed pages are demoted in search results or removed from the index entirely. Natural, reader-focused writing with topical variation outperforms keyword-dense content.

Quick Reference

  • Keyword density above ~2–3% for any single term is a signal of keyword stuffing — write for readers, not keyword counters
  • Repeating keywords unnaturally in titles, headers, alt text, or meta descriptions triggers Google's spam filters
  • Google's algorithms (Panda, SpamBrain) penalise pages with manipulative keyword density; natural language variation is rewarded

Check

Analyse the page's main content body, <title>, <meta name='description'>, heading elements (H1–H6), and <img alt> attributes. Flag: (1) Any single keyword or phrase appearing more than 3× in the title tag. (2) Any keyword with a density above 3% of total word count. (3) Lists of keywords with no context (e.g., 'cheap flights, affordable flights, discount flights, best flight deals'). (4) Alt text that is a comma-separated list of keywords instead of a description. (5) Hidden text (white text on white background, or display:none containing keywords).

Fix

  1. Rewrite keyword-dense passages using natural language variation:
    • Instead of repeating "SEO best practices" 8 times, use: "search engine optimisation", "ranking strategies", "organic search tips", "on-page SEO"
  2. Remove keyword lists from meta descriptions — write a single natural sentence.
  3. Fix keyword-stuffed alt text: replace "cheap flights london paris affordable flights" with "Passenger cabin view on London to Paris flight"
  4. If AI-generated content was used, review for repetitive phrasing and rewrite with varied terminology.
  5. Check for hidden text using browser DevTools CSS computed styles — remove any keyword content in hidden elements.
  6. Test the page's readability with the Flesch Reading Ease score — awkward keyword insertion lowers readability scores.

Explain

Google's Panda algorithm (now core to its main ranking system) and SpamBrain spam detection specifically target content with unnatural keyword density. Pages that appear to manipulate keyword frequency are demoted or removed from results. Google's documentation explicitly cites 'stuffing keywords into your content' as a violation of its quality guidelines. Natural writing that covers a topic comprehensively, using synonyms and related terms, outperforms keyword-dense content.

Code Review

Extract text content from the page body (strip HTML tags). Tokenise into words. Compute frequency of each unique word and common phrases (bigrams, trigrams). Flag any word/phrase appearing more than 3% of total word count. Also check <title>, <meta name='description'>, and alt attributes for repeated keywords. Report top 5 most frequent terms and their density percentages.


For full implementation details, code examples, and framework-specific guidance, see references/rule.md.

Rule page: https://frontendchecklist.io/en/rules/seo/keyword-stuffing

Signals

GitHub stars
74k
Forks
7k
Last commit
Aug 2026

Questions

When should this skill be used?
Use it when auditing content pages for over-optimisation, reviewing AI-generated content that may repeat target phrases excessively, or checking meta tags and alt text for unnatural keyword accumulation.
What does it check?
It looks for excessive repeated keywords in page content, meta tags, and alt text.
Is it useful for AI-generated content?
Yes. It is intended for reviewing AI-generated content that may repeat target phrases excessively.
Advanced
Item type
skill
Key
keyword-stuffing-thedaviddias
Source
github.com/thedaviddias/front-end-checklist