seo-audit

Audit and fix technical and content SEO for Zola, Hugo, 11ty, and Astro sites.

Updated Apr 1, 2018
One-click install
npx skills add https://github.com/reset/dotfiles --skill seo-audit-reset
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: seo-audit
Source: https://github.com/reset/dotfiles/tree/main/.claude/skills/seo-audit
Command: npx skills add https://github.com/reset/dotfiles --skill seo-audit-reset

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Static sites built with generators like Zola, Hugo, 11ty, and Astro often suffer from poor search engine visibility due to missing technical SEO baselines (canonical tags, schema markup, meta tags) and unoptimized content (weak meta descriptions, unfront-loaded page titles, missing alt text) that hurt click-through rates and search rankings.

Core Features & Use Cases

  • Technical SEO Baseline Implementation: Adds missing canonical URLs, JSON-LD Schema.org markup, Open Graph/Twitter cards, robots.txt, and sitemap configurations for all page archetypes in one pass.
  • Content-Level SEO Optimization: Rewrites meta descriptions to the 140-160 character sweet spot, front-loads page titles with search intent keywords, adds descriptive alt text to images, and builds internal linking structures to boost authority flow.
  • Tiered Workflow Guidance: Prioritizes work to avoid wasting time on low-impact tweaks, focusing first on one-time technical fixes then high-impact content improvements. Use case: For a Zola-based game studio blog, use this skill to add missing BlogPosting schema, rewrite truncated meta descriptions, and fix heading hierarchy to improve search visibility.

Quick Start

Use the seo-audit skill to run a full audit of your static site's SEO and implement prioritized fixes to improve search rankings.

Frequently Asked Questions about seo-audit

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

FAQPage Schema
How do I fix poor search rankings for my static site built with Hugo or Astro?

Improve static site SEO visibility by implementing a tiered workflow that first applies one-time technical fixes like canonical URLs and JSON-LD schema, then optimizes high-impact content like meta descriptions and page titles.

What is the best way to add Schema.org markup and Open Graph tags to an 11ty blog?

The best way to add Schema.org and Open Graph tags is through a comprehensive SEO audit that implements missing JSON-LD structured data and configures social sharing cards across all page archetypes in one pass.

Why does my Zola static site have missing meta descriptions and how do I fix them?

Meta descriptions are missing or truncated due to unoptimized content; fix them by rewriting descriptions to the 140-160 character sweet spot and front-loading page titles with search intent keywords.

Does an SEO audit workflow work for both technical and content-level static site optimization?

Yes, a static site SEO audit addresses both technical baselines like robots.txt, sitemaps, and canonical tags, as well as content-level improvements like descriptive image alt text and internal linking structures.

Can I prioritize SEO fixes to avoid wasting time on low-impact tweaks for my static site?

Yes, you can prioritize SEO fixes using a tiered workflow that focuses first on one-time technical configurations, then moves to high-impact content improvements to efficiently boost search visibility.