All skills
asyrafhussin avatar

/seo-best-practices

@46bae0b

SEO patterns, conventions, and audit for web applications. Use when implementing meta tags, structured data, Core Web Vitals, sitemaps, Open Graph, auditing SEO, or optimizing pages for search engines. Triggers on "audit SEO", "check SEO", "review SEO", or tasks involving search optimization, schema markup, or social sharing meta tags.

Use this Skill: https://skilld.dev/gh/asyrafhussin/agent-skills/seo-best-practices

This session only. Nothing lands on disk.

rulesonpage-headings.md

≈567 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Heading Hierarchy and Structure

Impact: HIGH (Crawlers and screen readers rely on heading structure)

Search engines use headings to understand content hierarchy and topical relevance. A clear heading structure also improves accessibility for screen-reader users navigating by heading landmarks.

Incorrect

<!-- ❌ Multiple h1 tags on one page -->
<h1>Welcome to Our Store</h1>
<section>
  <h1>Latest Products</h1>
  <h4>Running Shoes</h4> <!-- Skipped h2 and h3 -->
  <p>High-performance running shoes for every terrain.</p>
  <h2>Customer Reviews</h2>
</section>
<section>
  <h1>About Us</h1> <!-- Third h1 on the same page -->
  <p>We have been selling shoes since 2010.</p>
</section>

<!-- ❌ Using headings purely for styling -->
<h3 class="big-text">Free shipping on orders over $50</h3>

Problems:

  • Multiple <h1> tags dilute the primary topic signal for crawlers
  • Skipping from <h1> to <h4> breaks the logical outline and confuses assistive technology
  • Using heading tags for visual styling instead of structure misleads search engines about content importance

Correct

<!-- ✅ Single h1 with target keyword, logical nesting -->
<h1>Running Shoes for Every Terrain</h1>

<section>
  <h2>Latest Products</h2>
  <h3>Trail Running Shoes</h3>
  <p>Grip-focused shoes designed for off-road surfaces.</p>
  <h3>Road Running Shoes</h3>
  <p>Lightweight cushioned shoes for pavement.</p>
</section>

<section>
  <h2>Customer Reviews</h2>
  <h3>Top-Rated This Month</h3>
  <p>See what runners are saying about our best sellers.</p>
</section>

<!-- Use CSS classes for styling, not heading tags -->
<p class="promo-banner">Free shipping on orders over $50</p>

Benefits:

  • Single <h1> clearly signals the page topic to search engines
  • Logical h1 > h2 > h3 nesting creates a scannable outline for crawlers and screen readers
  • Heading levels are never skipped, preserving document structure integrity

Reference: Google Search Central - Headings

Source: SKILL.md on GitHub

1 warning16d4 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    The skill is a comprehensive SEO reference and audit tool for React and Laravel applications. It provides detailed patterns for optimizing Core Web Vitals, technical SEO, and structured data. No malicious code, obfuscation, or data exfiltration patterns were identified. The skill is designed to analyze project code and provide structural feedback based on a predefined checklist.

  • Socket16d

    5 alerts: gptAnomaly

  • Snyk16d

    Risk: LOW · No issues

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at 46bae0b. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last month.

Steadyupdated 6 months ago
metadata
{
  "author": "agent-skills",
  "version": "1.2.0"
}

README badge

README badge for asyrafhussin/agent-skills/seo-best-practices