onpage-optimization

Validate HTML on-page SEO heading hierarchy, keyword density, and link patterns.

7|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/thisisAhsanIqbal/nextjs-seo-audit --skill onpage-optimization
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: onpage-optimization
Source: https://github.com/thisisAhsanIqbal/nextjs-seo-audit/tree/main/skills/onpage-optimization
Command: npx skills add https://github.com/thisisAhsanIqbal/nextjs-seo-audit --skill onpage-optimization

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes guesswork from on-page SEO by validating your HTML’s heading structure, keyword usage, and internal/external link patterns against practical best-practice rules.

Core Features & Use Cases

  • Heading hierarchy validation: Detect missing headings, multiple H1s, skipped levels (e.g., H2 → H4), and empty heading text.
  • Keyword analysis: Check keyword density and placement across title, H1, meta description, the first paragraph, and image alt text.
  • Link health checks: Classify internal vs external links, flag weak internal linking, missing anchor text, and internal links marked with rel="nofollow".
  • Use Case: Audit a Next.js-rendered HTML page to pinpoint why it may be underperforming by surfacing SEO issues with specific PASS/WARN/FAIL outcomes and fix guidance.

Quick Start

Ask your AI agent to audit the provided HTML and report heading, keyword, and link optimization issues.

Frequently Asked Questions about onpage-optimization

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

FAQPage Schema
How do I audit HTML on-page SEO for heading hierarchy and keyword density?

To audit HTML on-page SEO, you need to validate heading hierarchy for skipped levels or multiple H1s, check keyword density across title and meta tags, and analyze internal link patterns for missing anchor text.

What is the best way to check internal linking health and find missing anchor text?

Checking internal linking health involves classifying internal vs external links, flagging weak internal linking strategies, detecting missing anchor text, and identifying internal links incorrectly marked with rel="nofollow".

How does heading hierarchy validation detect skipped levels and multiple H1 tags?

Heading hierarchy validation detects structural SEO issues by scanning standard HTML tags to find missing headings, multiple H1 tags, skipped levels like H2 to H4 transitions, and empty heading text.

Can I analyze keyword placement in the meta description and first paragraph of a Next.js page?

Yes, you can analyze keyword placement on a Next.js-rendered HTML page by scanning standard tags to verify keyword density and placement across the title, H1, meta description, first paragraph, and image alt text.

What happens to an on-page SEO audit if my HTML page has no links or missing keywords?

If an HTML page has no links or missing keywords, the on-page SEO audit handles these edge cases by applying deterministic PASS/WARN/FAIL classification rules to ensure consistent structure and relevance signal reporting.