Agent skill

SEO Audit

by kostja94 in kostja94/marketing-skills

When the user wants to run an SEO audit, technical SEO audit, or site health check.

MITAuto-check passedMarketing & SEO

Install SEO Audit

skills CLI
$ npx skills add kostja94/marketing-skills --skill seo-audit -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install kostja94/marketing-skills seo-audit --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/kostja94/marketing-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/strategies/structure/seo-audit .claude/skills/seo-audit && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
seo-audit
GitHub stars
1k
Token cost
~988 tokens
SKILL.md length
371 words
Files
1
Skills in repo
102
Repo updated
First seen
Licence
MIT

At a glance

When the user wants to run an SEO audit, technical SEO audit, or site health check.

  • Wants to run an SEO audit
  • SKILL.md covers Audit Order, Technical Checklist, On-Page Checklist and Content & Off-Page, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Technical SEO audit

What it does

SEO Audit is an agent skill from kostja94/marketing-skills. When the user wants to run an SEO audit, technical SEO audit, or site health check. Also use when the user mentions "SEO audit," "technical audit," "site audit," "crawl audit," "indexing audit," "SEO health," or "fix SEO issues." For prioritization and organic strategy, use seo-strategy. For GSC data analysis, use google-search-console.

Its SKILL.md is about 990 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering SEO audit and Technical SEO. It works with Google Search Console. The repository describes itself as: Agent Skills for Marketing — SEO, Social, Influencer & More. 160+ open-source skills for SEO, content, 40+ page types, paid ads, channels, and strategies. Add project context… The licence is MIT.

When your agent uses it

  • Wants to run an SEO audit
  • Technical SEO audit
  • Site health check
  • The user mentions SEO audit

Example prompts

  • “SEO audit,”
  • “technical audit,”
  • “site audit,”
  • “/seo-audit”

What it can do on your machine

Read from SKILL.md and the folder at commit 8dd89c5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

SEO Audit loads about 988 tokens when it runs. Until then it costs about 87 tokens; SKILL.md has 371 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~87
When it runs · the whole SKILL.md, loaded when a task matches
~988

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from kostja94/marketing-skills at commit 8dd89c5, republished under its MIT licence (© kostja94). 371 words, ~988 tokens.

Download SKILL.mdSave it as .claude/skills/seo-audit/SKILL.md (or your agent's skills folder).
name
seo-audit
description
When the user wants to run an SEO audit, technical SEO audit, or site health check. Also use when the user mentions "SEO audit," "technical audit," "site audit," "crawl audit," "indexing audit," "SEO health," or "fix SEO issues." For prioritization and organic strategy, use seo-strategy. For GSC data analysis, use google-search-console.
metadata.version
1.1.0

Strategies: SEO Audit

Guides end-to-end SEO audit: technical foundation, on-page, content, and off-page. Execute in order—technical blockers prevent indexing; on-page limits rankings; content and off-page build authority. Use when auditing an existing site or planning fixes.

When invoking: On first use, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On subsequent use or when the user asks to skip, go directly to the main output.

Audit Order

PhaseFocusSkills
1. TechnicalCrawl, index, sitemaprobots-txt, xml-sitemap, canonical-tag, indexing, site-crawlability
2. On-PageMetadata, structure, schematitle-tag, meta-description, page-metadata, schema-markup, internal-links, heading-structure
3. ContentGaps, intent, optimizationkeyword-research, content-strategy, content-optimization
4. Off-PageBacklinks, authoritylink-building, backlink-analysis

Principle: Fix foundation before optimizing pages. See seo-strategy for workflow and prioritization.

Technical Checklist

ItemCheckSkill
robots.txtSyntax; not blocking important pagesrobots-txt
SitemapSubmitted to GSC; indexable pages only; ≤50K URLs per sitemapxml-sitemap
HTTPSSitewide; valid certificatecanonical-tag
404/5xxProper status codes; fix or redirectsite-crawlability
noindexNo accidental noindex on key pagesindexing
CanonicalCorrect; no conflictscanonical-tag
Core Web VitalsLCP ≤2.5s, INP ≤200ms, CLS <0.1core-web-vitals
MobileMobile-first; content parity; no intrusive interstitialsmobile-friendly
CrawlabilityRedirect chains, broken links, orphan pagessite-crawlability
Show full SKILL.md (166 more words)Show less

On-Page Checklist

ItemCheckSkill
TitleUnique; 50–60 chars; keyword in first 10 wordstitle-tag
Meta description150–160 chars; CTAmeta-description
HeadingsOne H1; H1→H2→H3 hierarchyheading-structure
ImagesAlt text; no decorative alt for decorative imagesimage-optimization
SchemaValid; Rich Results Testschema-markup
Internal linksFrom strong pages; descriptive anchorsinternal-links
Duplicate contentCanonical; consolidate or differentiatecanonical-tag

Content & Off-Page

PhaseFocusSkill
Content gapMissing topics vs competitorscontent-strategy, competitor-research
Intent matchContent matches search intentcontent-optimization
BacklinksToxic links; link gap vs competitorsbacklink-analysis, link-building

Frequency

CadenceUse
Full auditQuarterly
Check-insMonthly (GSC, indexing, Core Web Vitals)

Output Format

  • Phase 1–4 findings (technical → on-page → content → off-page)
  • Priority list (P0 blocker → P1 core → P2 important)
  • Skill mapping (which skill for each fix)
  • Timeline (immediate vs short-term vs ongoing)
  • seo-strategy: Workflow order, prioritization, when to invest in SEO
  • google-search-console: Performance, indexing, Core Web Vitals data
  • site-crawlability: Redirect chains, broken links, crawl budget
  • indexing: Indexing issues, noindex, Search Console
  • core-web-vitals: LCP, INP, CLS optimization

© kostja94, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/strategies/structure/seo-audit of kostja94/marketing-skills.

Open the folder on GitHubat commit 8dd89c5

Compare with similar skills

SEO Audit next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

SEO Audit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
SEO Audit this skillkostja94/marketing-skills1k—~988Automated safety check: PassMIT
Google SEO APIsAgriciDaniel/claude-seo19k1 repos~4.2kAutomated safety check: PassMIT
SEO Coachakseolabs-seo/seo-coach146—~2.8kAutomated safety check: PassNone
SEO Auditfreekmurze/dotfiles1k34 repos~2.2kAutomated safety check: PassNone
Geo Meta Tags Auditthedaviddias/Front-End-Checklist74k—~763Automated safety check: PassMIT
SEONexus-JPF/note-companion870—~2.2kAutomated safety check: PassMIT

Similar skills

  • Google SEO APIs

    AgriciDaniel/claude-seo

    Pulls real Google data for SEO work: Search Console, PageSpeed Insights, CrUX field data, the Indexing API and GA4 organic traffic, through /seo google commands.

    19k GitHub starsUsed in 1 repo~4.2k tokens
    Marketing & SEOAuto-check passed
  • SEO Coach

    akseolabs-seo/seo-coach

    Beginner-first SEO coaching for people who want to learn by doing one safe, verifiable step at a time.

    146 GitHub stars~2.8k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • SEO Audit

    freekmurze/dotfiles

    When the user wants to audit, review, or diagnose SEO issues on their site.

    1k GitHub starsUsed in 34 repos~2.2k tokens
    Marketing & SEOAuto-check passed
  • Geo Meta Tags Audit

    thedaviddias/Front-End-Checklist

    Audits and fixes geo.region, geo.placename and geo.position meta tags on regional pages, noting where they help (Bing) and where they do not (Google).

    74k GitHub stars~763 tokensUpdated 4 days ago
    Marketing & SEOAuto-check passed
  • SEO

    Nexus-JPF/note-companion

    Use and read this skill immediately if the user request is in any way related to SEO or a site's organic search or AI search presence.

    870 GitHub stars~2.2k tokensUpdated 3 days ago
    Marketing & SEOAuto-check passed
  • Site Architecture

    AvdLee/RocketSimApp

    When the user wants to plan, map, or restructure their website's page hierarchy, navigation, URL structure, or internal linking.

    805 GitHub starsUsed in 11 repos~3.3k tokens
    Marketing & SEOAuto-check passed

More from kostja94/marketing-skills

All 102 skills in this repo
  • Grokipedia Recommendations

    kostja94/marketing-skills

    When the user wants to add recommendations, links, or content to Grokipedia.

    1k GitHub starsUsed in 1 repo~4.2k tokens
    Auto-check passed
  • AI Traffic Tracking

    kostja94/marketing-skills

    When the user wants to track AI search traffic in GA4 or GSC.

    1k GitHub stars~959 tokensUpdated 4 days ago
    Auto-check passed
  • Analytics Tracking

    kostja94/marketing-skills

    When the user wants to set up, audit, or optimize analytics tracking (GA4, events, conversions).

    1k GitHub stars~1.5k tokensUpdated 4 days ago
    Auto-check passed
  • Brand Visual Generator

    kostja94/marketing-skills

    When the user wants to define, audit, or apply visual identity (typography, colors, spacing, design tokens, frontend aesthetics).

    1k GitHub stars~3k tokensUpdated 4 days ago
    Auto-check passed
  • Canonical Tag

    kostja94/marketing-skills

    When the user wants to configure canonical URLs, fix duplicate content, or consolidate URL signals.

    1k GitHub stars~1.2k tokensUpdated 4 days ago
    Auto-check passed
  • Content Strategy

    kostja94/marketing-skills

    When the user wants to plan content for SEO, create content calendar, or build topic clusters.

    1k GitHub stars~1.8k tokensUpdated 4 days ago
    Auto-check passed

Categories

Questions about SEO Audit

What does SEO Audit do?

When the user wants to run an SEO audit, technical SEO audit, or site health check. SEO Audit is an agent skill from kostja94/marketing-skills. When the user wants to run an SEO audit, technical SEO audit, or site health check.

When should I use SEO Audit?

SEO Audit fits situations like: wants to run an SEO audit; technical SEO audit; site health check; the user mentions SEO audit.

How do I install SEO Audit in Claude Code?

Run `npx skills add kostja94/marketing-skills --skill seo-audit -a claude-code`. Or copy the skill folder (skills/strategies/structure/seo-audit in kostja94/marketing-skills) into .claude/skills/seo-audit in your project. Claude Code loads it when a task matches its description.

How do I install SEO Audit in Codex?

Run `npx skills add kostja94/marketing-skills --skill seo-audit -a codex`. Or copy the skill folder (skills/strategies/structure/seo-audit in kostja94/marketing-skills) into .agents/skills/seo-audit in your project. Codex loads it when a task matches its description.

Can I use SEO Audit in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add kostja94/marketing-skills --skill seo-audit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/seo-audit, .gemini/skills/seo-audit, .github/skills/seo-audit and .opencode/skills/seo-audit in your project.

What does SEO Audit need to run?

SKILL.md names no scripts, command-line tools or credentials: SEO Audit is instructions for the agent only.

Does SEO Audit access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is SEO Audit safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does SEO Audit use?

SEO Audit is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does SEO Audit use?

About 988 tokens (SKILL.md is roughly 4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to SEO Audit?

Skills that share tags, products or a category with SEO Audit: Google SEO APIs (AgriciDaniel/claude-seo, 19k stars), SEO Coach (akseolabs-seo/seo-coach, 146 stars), SEO Audit (freekmurze/dotfiles, 1k stars) and Geo Meta Tags Audit (thedaviddias/Front-End-Checklist, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SEO Audit?

kostja94 (a GitHub user) maintains it in kostja94/marketing-skills, which has 1,025 GitHub stars. The repository holds 102 skills in this directory. The repository was last updated on October 6, 2026.

Source: kostja94/marketing-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.