Agent skill

SEO Audit

by magnus919 in magnus919/hermes-profiles

Full-spectrum SEO + AEO audit skill — technical crawl analysis, on-page content optimization, structured data (JSON-LD/Schema.org) validation, Ghost CMS metadata completion, answer engine…

MITAuto-check passedMarketing & SEO

Install SEO Audit

skills CLI
$ npx skills add magnus919/hermes-profiles --skill seo-audit -a claude-code

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

GitHub CLI
$ gh skill install magnus919/hermes-profiles 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/magnus919/hermes-profiles.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/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
289
Token cost
~1k tokens
SKILL.md length
278 words
Files
8 (incl. references, assets)
Skills in repo
31
Repo updated
First seen
Licence
MIT

At a glance

Full-spectrum SEO + AEO audit skill — technical crawl analysis, on-page content optimization, structured data (JSON-LD/Schema.org) validation, Ghost CMS metadata completion, answer engine…

  • The seo-specialist profile needs to audit a site
  • SKILL.md covers Output Contract, Contents and When to Use
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Optimize an article for search and AI citation

What it does

SEO Audit is an agent skill from magnus919/hermes-profiles. Full-spectrum SEO + AEO audit skill — technical crawl analysis, on-page content optimization, structured data (JSON-LD/Schema.org) validation, Ghost CMS metadata completion, answer engine optimization (AEO/GEO), content strategy gap analysis, and reporting. Produces artifact-pyramid-compliant output. Use when the seo-specialist profile needs to audit a site, optimize an article for search and AI citation, complete Ghost CMS metadata, or develop a content strategy.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files, including reference files and assets (for example `assets/audit-report-template.md`, `references/aeo-methodology.md` and `references/content-strategy-seo.md`).

It sits in Marketing & SEO, covering AI search optimization, Schema markup and SEO audit. The repository describes itself as: Curated Hermes Agent profiles for specialist swarms — opinionated, Hermes-optimized, artifact-pyramid native. The licence is MIT.

When your agent uses it

  • The seo-specialist profile needs to audit a site
  • Optimize an article for search and AI citation
  • Complete Ghost CMS metadata
  • Develop a content strategy

Example prompts

  • “/seo-audit”

What it can do on your machine

Read from SKILL.md and the folder at commit 867a555. 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 1k tokens when it runs, and up to ~13k if it reads all its reference files. Until then it costs about 120 tokens; SKILL.md has 278 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~120
When it runs · the whole SKILL.md, loaded when a task matches
~1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~13k

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 magnus919/hermes-profiles at commit 867a555, republished under its MIT licence (© magnus919). 278 words, ~1,046 tokens.

Download SKILL.mdSave it as .claude/skills/seo-audit/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
seo-audit
description
Full-spectrum SEO + AEO audit skill — technical crawl analysis, on-page content optimization, structured data (JSON-LD/Schema.org) validation, Ghost CMS metadata completion, answer engine optimization (AEO/GEO), content strategy gap analysis, and reporting. Produces artifact-pyramid-compliant output. Use when the seo-specialist profile needs to audit a site, optimize an article for search and AI citation, complete Ghost CMS metadata, or develop a content strategy.

SEO Audit

Full-spectrum audit for sites, articles, and content strategies. Covers both traditional SEO and Answer Engine Optimization (AEO/GEO) — the practice of structuring content so LLMs and AI answer engines (ChatGPT, Perplexity, Gemini, Claude, Google AI Overviews) extract and cite it.

All output is artifact-pyramid-compliant. The only response to the caller is the absolute path to 00-index.md.

Output Contract

Pyramid Structure
<slug>/
├── 00-index.md                    ← L1 summary + navigation
├── 01-summary/
│   └── seo-verdict.md             ← Overall score, priority findings, estimated impact
├── 02-analysis/
│   ├── technical-seo.md           ← Crawlability, indexability, speed, mobile, HTTPS
│   ├── onpage-seo.md              ← Title tags, meta, headings, content, internal links
│   ├── schema-validation.md       ← Structured data / JSON-LD audit
│   ├── ghost-metadata.md          ← Ghost CMS meta, social cards, code injection
│   ├── aeo-methodology.md         ← AEO / answer engine optimization
│   └── content-gap-analysis.md    ← Keyword gaps, topic clusters, SERP opportunities
└── 03-dossiers/
    ├── full-crawl-results.md      ← Raw technical findings
    ├── schema-test-results.md     ← Rich results test output
    └── keyword-research-data.md   ← Raw keyword and SERP data
L1 Verdict Format
## SEO + AEO Audit: [Site/Page URL]

**Overall Health:** [Good / Fair / Poor]
**Score:** [N/100]

### SEO Priority Findings
1. [Critical] → [Action]

### AEO Priority Findings
1. [Critical] → [Action]

### Quick Wins
1. [Low effort, high impact] → [Action]

### Verdict
[One paragraph summarizing the single most important thing to fix and expected impact.]

Contents

FileWhat it covers
references/technical-seo.mdCrawlability, indexability, robots.txt, sitemaps, page speed, Core Web Vitals, mobile-friendliness, HTTPS, canonical URLs, hreflang
references/onpage-seo.mdTitle tags, meta descriptions, heading hierarchy, keyword placement, content quality, internal linking, image optimization
references/schema-markup.mdSchema.org types (TechArticle, FAQPage, HowTo, Article, BlogPosting, BreadcrumbList, Organization), JSON-LD format, Google rich results, validation
references/content-strategy-seo.mdTopic clusters, pillar pages, keyword research, gap analysis, SERP feature targeting, topical authority
references/ghost-metadata.mdGhost CMS metadata fields (meta_title, meta_description, custom_excerpt), social media cards (OG, Twitter), code-injected schema (JSON-LD, FAQPage, TechArticle, @graph), per-post and site-wide injection, validation
references/aeo-methodology.mdAnswer Engine Optimization — LLM RAG pipeline, answer-first content architecture, AEO-specific schema (FAQPage 3.2× boost), Ethan Smith/Graphite frameworks, question clusters, llms.txt, content negotiation, measurement
assets/audit-report-template.mdBlank report scaffold for new audits

When to Use

Load this skill when:

  • Auditing a site for technical SEO issues
  • Optimizing a new article for search and AI citation before publication
  • Validating structured data on an existing page
  • Completing Ghost CMS metadata (meta, social cards, schema injection) before publish
  • Running an AEO readiness audit (llms.txt, content negotiation, question-cluster coverage)
  • Developing a content strategy with SEO + AEO in parallel
  • Diagnosing why a site or page isn't performing in search or AI citation

Do NOT load when:

  • Only mechanical content fixes are needed (use copy-edit)
  • Only writing is needed (use writer profile)

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

Files

SKILL.md and 7 other files (references, assets) in skills/seo-audit of magnus919/hermes-profiles.

  • SKILL.md
  • assets/audit-report-template.md
  • references/aeo-methodology.md
  • references/content-strategy-seo.md
  • references/ghost-metadata.md
  • references/onpage-seo.md
  • references/schema-markup.md
  • references/technical-seo.md

Open the folder on GitHubat commit 867a555

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 skillmagnus919/hermes-profiles289—~1kAutomated safety check: PassMIT
Universal SEO AnalysisAgriciDaniel/claude-seo19k—~4.9kAutomated safety check: PassMIT
SEO Geoericrisco/rsc-harness180—~2.8kAutomated safety check: PassMIT
Site ArchitectureAvdLee/RocketSimApp80611 repos~3.3kAutomated safety check: PassCustom licence
GEO-First SEO Audit Toolzubair-trabzada/geo-seo-claude11k—~2.8kAutomated safety check: NotesMIT
SEO Optimizerailabs-393/ai-labs-claude-skills4551 repos~3.2kAutomated safety check: PassMIT

Similar skills

  • Universal SEO Analysis

    AgriciDaniel/claude-seo

    Hub for site-wide SEO work: audits, technical checks, schema, content quality, local, hreflang and AI-search readiness, run through slash commands.

    19k GitHub stars~4.9k tokensUpdated 6 days ago
    Marketing & SEOAuto-check passed
  • SEO Geo

    ericrisco/rsc-harness

    A skill your agent uses when one existing page needs to rank in Google AND get cited by AI answer engines — auditing a URL for on-page SEO, structured-data JSON-LD, GEO citation levers, Core Web…

    180 GitHub stars~2.8k tokensUpdated yesterday
    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.

    806 GitHub starsUsed in 11 repos~3.3k tokens
    Marketing & SEOAuto-check passed
  • GEO-First SEO Audit Tool

    zubair-trabzada/geo-seo-claude

    Audits a website for AI search visibility across ChatGPT, Claude, Perplexity and Google AI Overviews while checking traditional SEO, schema and E-E-A-T content quality.

    11k GitHub stars~2.8k tokensUpdated yesterday
    Marketing & SEOAuto-check: notes
  • SEO Optimizer

    ailabs-393/ai-labs-claude-skills

    This skill should be used when analyzing HTML/CSS websites for SEO optimization, fixing SEO issues, generating SEO reports, or implementing SEO best practices.

    455 GitHub starsUsed in 1 repo~3.2k tokens
    Marketing & SEOAuto-check passed
  • SEO Aeo Audit

    warpdotdev/oz-skills

    Optimize for search engine visibility, ranking, and AI citations.

    824 GitHub stars~4.9k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed

More from magnus919/hermes-profiles

All 31 skills in this repo
  • Data Scientist

    magnus919/hermes-profiles

    PhD-level expertise in data science, statistics, and machine learning.

    289 GitHub stars~3.3k tokensUpdated 3 mo ago
    Auto-check passed
  • Brand Designer

    magnus919/hermes-profiles

    Create comprehensive brand identity documentation for any brand.

    289 GitHub stars~2.3k tokensUpdated 3 mo ago
    Auto-check passed
  • Sdd Authoring

    magnus919/hermes-profiles

    Specification authoring for AI-native SDD — writes formal specifications in structured formats (Gherkin, user stories, acceptance criteria), enforces spec quality gates, and produces…

    289 GitHub stars~1.4k tokensUpdated 3 mo ago
    Auto-check passed
  • Sdd Verification

    magnus919/hermes-profiles

    SDD acceptance criteria verification — maps specification acceptance criteria to tests, validates implementation output against spec requirements, and produces artifact-pyramid-compliant…

    289 GitHub stars~1.8k tokensUpdated 3 mo ago
    Auto-check passed
  • Sdd Work Decomposition

    magnus919/hermes-profiles

    SDD work decomposition — translates formal specifications into dependency-aware task plans with per-task acceptance criteria.

    289 GitHub stars~1.4k tokensUpdated 3 mo ago
    Auto-check passed
  • Artifact Pyramids

    magnus919/hermes-profiles

    Progressive disclosure for what AI agents produce. An agent skill from magnus919/hermes-profiles.

    289 GitHub stars~2.5k tokensUpdated 3 mo ago
    Auto-check passed

Categories

Questions about SEO Audit

What does SEO Audit do?

Full-spectrum SEO + AEO audit skill — technical crawl analysis, on-page content optimization, structured data (JSON-LD/Schema.org) validation, Ghost CMS metadata completion, answer engine…. SEO Audit is an agent skill from magnus919/hermes-profiles.org) validation, Ghost CMS metadata completion, answer engine optimization (AEO/GEO), content strategy gap analysis, and reporting.

When should I use SEO Audit?

SEO Audit fits situations like: the seo-specialist profile needs to audit a site; optimize an article for search and AI citation; complete Ghost CMS metadata; develop a content strategy.

How do I install SEO Audit in Claude Code?

Run `npx skills add magnus919/hermes-profiles --skill seo-audit -a claude-code`. Or copy the skill folder (skills/seo-audit in magnus919/hermes-profiles) 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 magnus919/hermes-profiles --skill seo-audit -a codex`. Or copy the skill folder (skills/seo-audit in magnus919/hermes-profiles) 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 magnus919/hermes-profiles --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 1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 12k tokens, read only when the agent opens those files.

What are the alternatives to SEO Audit?

Skills that share tags, products or a category with SEO Audit: Universal SEO Analysis (AgriciDaniel/claude-seo, 19k stars), SEO Geo (ericrisco/rsc-harness, 180 stars), Site Architecture (AvdLee/RocketSimApp, 806 stars) and GEO-First SEO Audit Tool (zubair-trabzada/geo-seo-claude, 11k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SEO Audit?

magnus919 (a GitHub user) maintains it in magnus919/hermes-profiles, which has 289 GitHub stars. The repository holds 31 skills in this directory. The repository was last updated on June 27, 2026.

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