On-Page SEO Optimizer

Audit and optimize on-page SEO elements including titles, meta tags, headers, and image alt text.

This skill provides a systematic workflow to audit HTML content for SEO best practices. It evaluates title tags, meta descriptions, heading hierarchies, image accessibility, and internal/external linking structures to improve search visibility.

Install On-Page SEO Optimizer

Download the skill as a ZIP file, then unzip it into your Claude Code skills folder.

Download on-page-seo-optimizer.zip

Unzip to:

~/.claude/skills/on-page-seo-optimizer/

Core Audit Workflow

Follow these five steps for every SEO audit:

1. Title and Meta Description Analysis

Check for presence and length constraints:

  • Title Tag: Must be under 60 characters to avoid truncation. Place primary keywords at the beginning.
  • Meta Description: Aim for 140–160 characters. It must include a clear Call to Action (CTA) and secondary keywords.
  • Keyword Presence: Ensure the primary keyword, secondary keywords, and brand name are represented in these tags.

2. Header Tag Hierarchy (H1, H2, H3)

Analyze the structural organization of the page:

  • Single H1: Ensure there is exactly one <h1> tag per page containing the primary topic.
  • Logical Order: Tags must follow a nested order (H1 > H2 > H3). Never skip levels (e.g., going from H1 to H4).
  • Keyword-Rich Headers: Replace "filler" text (e.g., "Frequently Asked Questions", "Why it works") with descriptive, keyword-heavy alternatives (e.g., "Common Questions About Building Custom AI Agents").
  • Clean Code: Remove empty header markers (e.g., ## with no content).

3. Image Alt Attribute Audit

Evaluate image accessibility and SEO context:

  • Generic Text Check: Replace generic alt text like alt="avatar" or alt="image" with specific descriptions.
  • Formula for Testimonials: Use [Person Name], [Title] - [Company] Testimonial for [Product Name].
  • Keyword Integration: Incorporate secondary keywords into product illustration alt text.
  • File Naming: Recommend keyword-rich filenames (e.g., ai-workflow-builder.png) instead of generic ID strings.

4. Link Integrity and Structure

Review internal and external linking strategies:

  • Anchor Text: Avoid wrapping entire paragraphs in <a> tags. Use concise, descriptive anchor text (e.g., "Read the Success Story" instead of linking a 50-word quote).
  • Internal Links: Use relative paths (e.g., /features/automation) to help crawlers understand site structure.
  • External Links: Add rel="nofollow" or rel="noopener" to outbound links to preserve page authority when necessary.
  • Broken Links: Verify that URLs are consistent and not cut off or malformed.

5. Final Verdict and Prioritization

Summarize findings into a prioritized list of updates, focusing on the changes that will have the highest impact on CTR and rankings.

Rules and Constraints

  • Preserve Intent: When suggesting header changes, ensure they still reflect the original meaning of the section.
  • Mobile First: Keep in mind that truncated titles look worse on mobile; stick to strict character limits.
  • No Keyword Stuffing: Suggestions should remain natural and readable for humans, not just bots.

Verification Checklist

  • Does the page have exactly one H1?
  • Are all image alt tags descriptive and unique?
  • Is the meta description between 140-160 characters?
  • Are headers nested correctly without skipping levels?
  • Is anchor text descriptive and concise?