Claude AI

Pagination Audit Claude Skill

This skill audits a website's paginated series, blog listings, category pages, and search results, and produces an actionable report focused on keeping deep, paginated content indexable. It crawls pages and inspects canonical tags, meta robots, rel=next/prev, and page-number URL patterns to find paginated pages that canonicalize to page 1 (hiding deep content from the index), noindexed component pages, paginated pages missing a self-canonical, broken or inconsistent rel=next/prev, and redundant ?page=1 first pages.

What The Skill Checks

  • Indexation traps: paginated pages that canonicalize to page 1 (hiding deep content) and noindexed component pages.
  • Canonical and series signals: paginated pages missing a self-canonical and broken or inconsistent rel=next/prev.
  • URL hygiene: redundant ?page=1 first pages that duplicate the series root.

How The Skill Is Packaged

The skill follows the standard Claude Agent Skill structure: a SKILL.md file with YAML frontmatter and workflow instructions, a references/ folder with the full audit check definitions and report template, and a scripts/ folder with Python scripts that crawl the site and extract pagination signals (canonicals, meta robots, rel=next/prev, and page-number URL patterns), then audit the resulting series. Every report can be exported to a shareable Word .docx or a flat .csv of findings via the bundled md_to_docx.py and findings_to_csv.py scripts. Install it with npx claude-seo-skills install pagination-audit, or copy the skill folder into your Claude skills directory; Claude invokes it automatically when a request matches its description.

Skill Files

Every file in the skill is embedded below directly from the Claude-SEO-Skills repository, so you can review exactly what the skill instructs Claude to do before installing it.

SKILL.md

The skill definition: frontmatter, inputs to collect, the workflow, and the resources the skill relies on.

Audit Checks Reference (references/audit-checks.md)

Full definitions, severities, and rationale for every check across the high, medium, and low tiers.

Report Template (references/report-template.md)

The output structure the skill follows, including the sections issues are grouped into.

Pagination Extractor Script (scripts/extract_pagination.py)

Crawls pages and inventories pagination signals: canonical tags, meta robots, rel=next/prev, and page-number URL patterns.

Pagination Auditor Script (scripts/audit_pagination.py)

Audits each paginated series against the checks and outputs the structured report data.