Agent skill

Yao Geo Page Audit

by yaojingang in yaojingang/yao-geo-skills

Diagnose a website page or small page set for GEO readiness with authoritative public evidence, systematic page analysis, code/content/schema fixes, and four-format Chinese report delivery.

MITAuto-check passedMarketing & SEO

Install Yao Geo Page Audit

skills CLI
$ npx skills add yaojingang/yao-geo-skills --skill yao-geo-page-audit -a claude-code

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

GitHub CLI
$ gh skill install yaojingang/yao-geo-skills yao-geo-page-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/yaojingang/yao-geo-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/yao-geo-page-audit .claude/skills/yao-geo-page-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
yao-geo-page-audit
GitHub stars
871
Token cost
~1.2k tokens
SKILL.md length
530 words
Files
35 (incl. scripts, references)
Skills in repo
24
Repo updated
First seen
Licence
MIT

At a glance

Diagnose a website page or small page set for GEO readiness with authoritative public evidence, systematic page analysis, code/content/schema fixes, and four-format Chinese report delivery.

  • Works in 11 steps: Read references/research-foundation.md,… → Identify page type and sample scope. If… → Build an evidence ledger. Prefer… → …
  • Marketing & SEO work in your project
  • SKILL.md covers Job, Workflow, Boundaries and Outputs

What it does

Yao Geo Page Audit is an agent skill from yaojingang/yao-geo-skills. Diagnose a website page or small page set for GEO readiness with authoritative public evidence, systematic page analysis, code/content/schema fixes, and four-format Chinese report delivery.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 39 other files, including scripts and reference files (for example `agents/interface.yaml`, `evals/expected_artifacts.json` and `evals/quality_cases.json`).

It sits in Marketing & SEO. The repository describes itself as: An open-source Skill collection for GEO content and workflows, continuously updated. The licence is MIT.

When your agent uses it

  • Marketing & SEO work in your project

Example prompts

  • “/yao-geo-page-audit”

Workflow steps

11 steps, taken from the first numbered list in SKILL.md.

  1. Read references/research-foundation.md, references/authority-reference-model.md, and references/report-module-taxonomy.md. Frame the audit…
  2. Identify page type and sample scope. If the input is a homepage, select homepage, one representative first-level page, and one…
  3. Build an evidence ledger. Prefer official pages, official docs, schema/source code, standards, and peer-reviewed or arXiv research before…
  4. Check crawlability and renderability: status code, robots, sitemap, canonical, meta robots, mobile-first parity, JavaScript dependency…
  5. Check structural quality: H1-H3, main/article, summary, table of contents, FAQ, tables, lists, breadcrumbs, internal links, anchor text…
  6. Check content evidence: conclusions first, full entity names, data, citations, cases, dates, author/source, freshness, objectivity, price…
  7. Check AI extractability and public-answer material coverage: key-value facts, atomic facts, comparison tables, steps, Q&A…
  8. Produce code-layer fixes, content-layer fixes, page-module suggestions, schema/HTML snippets, priority, owner, acceptance test, risk, and…
  9. Deliver Word, PDF, sticky-menu HTML, and Markdown from one Markdown content source. Use the kami editorial report style in…
  10. After DOCX generation, run scripts/polish_docx.py to apply Kami-style Word typography, margins, and table formatting.
  11. Run scripts/review_report_layout.py and references/quality-gates.md before claiming completion.

What it can do on your machine

Read from SKILL.md and the folder at commit d21bfc1. 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

    Ships 1 file in scripts/, which the agent can run.

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

  • Network

    Links to these hosts (documentation or services it may open):

    • x.com

    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

Yao Geo Page Audit loads about 1.2k tokens when it runs, and up to ~6.2k if it reads all its reference files. Until then it costs about 52 tokens; SKILL.md has 530 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from yaojingang/yao-geo-skills at commit d21bfc1, republished under its MIT licence (© yaojingang). 530 words, ~1,217 tokens.

Download SKILL.mdSave it as .claude/skills/yao-geo-page-audit/SKILL.md (or your agent's skills folder). This skill also uses 34 other files; get the full folder from GitHub.
name
yao-geo-page-audit
description
Diagnose a website page or small page set for GEO readiness with authoritative public evidence, systematic page analysis, code/content/schema fixes, and four-format Chinese report delivery.
metadata.owner
Yao Team
metadata.family
geo-page-technical
metadata.maturity
beta
metadata.requires_web
true
metadata.default_outputs
Word, PDF, HTML, Markdown
<!--
Copyright © 2026 姚金刚. All rights reserved.
Project: yao-geo-page-audit
Created by: 姚金刚
Date: 2026-05-16
X: https://x.com/yaojingang
-->

yao-geo-page-audit

Use this skill when the user wants a GEO Page Audit, website/page GEO diagnosis, page technical audit, AI extractability audit, schema/HTML module advice, or code/content repair list for a URL.

Job

Given a target URL or website, diagnose the homepage, a representative first-level page, and a representative second-level page when possible. Output development-ready and content-ready recommendations that improve how public pages can be discovered, parsed, cited, and summarized by search-driven AI systems. By default, analyze public page readiness and public evidence coverage only; do not estimate AI-platform recall, rankings, citation share, or internal platform behavior unless the user provides platform sampling data.

Workflow

  1. Read references/research-foundation.md, references/authority-reference-model.md, and references/report-module-taxonomy.md. Frame the audit as a five-stage chain: discovery, retrieval candidate, main-content extraction, evidence quality, generated citation.
  2. Identify page type and sample scope. If the input is a homepage, select homepage, one representative first-level page, and one representative second-level page. State the selection basis and unresolved input gaps.
  3. Build an evidence ledger. Prefer official pages, official docs, schema/source code, standards, and peer-reviewed or arXiv research before third-party commentary. Mark each finding as observed, official, standard, research, inferred, or input gap.
  4. Check crawlability and renderability: status code, robots, sitemap, canonical, meta robots, mobile-first parity, JavaScript dependency, and whether primary content appears in initial HTML.
  5. Check structural quality: H1-H3, main/article, summary, table of contents, FAQ, tables, lists, breadcrumbs, internal links, anchor text, accessibility headings, and schema.
  6. Check content evidence: conclusions first, full entity names, data, citations, cases, dates, author/source, freshness, objectivity, price, service boundaries, regional constraints, and source accountability.
  7. Check AI extractability and public-answer material coverage: key-value facts, atomic facts, comparison tables, steps, Q&A, context-independent summary, paragraph independence, entity graph, sameAs links, and chunk-level citation readiness. Convert domestic platform concerns into high-intent question material gaps, not platform recall claims.
  8. Produce code-layer fixes, content-layer fixes, page-module suggestions, schema/HTML snippets, priority, owner, acceptance test, risk, and estimated cost.
  9. Deliver Word, PDF, sticky-menu HTML, and Markdown from one Markdown content source. Use the kami editorial report style in references/report-formatting-spec.md and references/output-layout-policy.md.
  10. After DOCX generation, run scripts/polish_docx.py to apply Kami-style Word typography, margins, and table formatting.
  11. Run scripts/review_report_layout.py and references/quality-gates.md before claiming completion.
Show full SKILL.md (164 more words)Show less

Boundaries

  • Without crawl/log access, only report front-end observable evidence. Do not infer log-level crawl frequency.
  • Without AI-platform sampling data, do not analyze platform recall, ranking, answer frequency, citation share, or platform-internal weighting. Replace that section with public material coverage and high-intent question readiness.
  • Distinguish user-visible content, crawler-readable content, and AI-extractable content.
  • Schema must match page body facts. Do not use schema to invent facts absent from the page.
  • Cite or name the evidence source for important claims. If the source is not available, label the recommendation as a hypothesis or input gap.
  • Domestic answer-material adaptation should consider search results, public webpages, news pages, encyclopedia pages, WeChat public articles, documentation, and help-center pages as possible public material. Treat actual platform answer performance as optional user-supplied evidence.

Outputs

  • Page GEO diagnosis report.
  • Code-layer repair checklist.
  • Content-structure remodeling advice.
  • Schema and HTML module suggestions.
  • Evidence ledger and report completeness self-check.
  • Default four-piece deliverable: Word, PDF, HTML package, Markdown.
  • quality-report.json with artifact existence, byte size, and layout checks.

© yaojingang, 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 34 other files (scripts, references) in skills/yao-geo-page-audit of yaojingang/yao-geo-skills.

  • SKILL.md
  • agents/interface.yaml
  • evals/expected_artifacts.json
  • evals/quality_cases.json
  • evals/trigger_cases.json
  • examples/README.md
  • examples/example-site-demo/example-site-geo-page-audit.docx
  • examples/example-site-demo/example-site-geo-page-audit.html
  • examples/example-site-demo/example-site-geo-page-audit.md
  • examples/example-site-demo/example-site-geo-page-audit.pdf
  • examples/example-site-demo/quality-report.json
  • examples/hubspot-domestic-ai-demo/README.md
  • examples/hubspot-domestic-ai-demo/hubspot-geo-page-audit.docx
  • examples/hubspot-domestic-ai-demo/hubspot-geo-page-audit.html
  • examples/hubspot-domestic-ai-demo/hubspot-geo-page-audit.md
  • examples/hubspot-domestic-ai-demo/hubspot-geo-page-audit.pdf
  • … and 19 more

Open the folder on GitHubat commit d21bfc1

Compare with similar skills

Yao Geo Page 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.

Yao Geo Page Audit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Yao Geo Page Audit this skillyaojingang/yao-geo-skills871—~1.2kAutomated safety check: PassMIT
Geo Fundamentalswasp-lang/wasp19k9 repos~861Automated safety check: PassMIT
Ab Testingcoreyhaines31/marketingskills54k3 repos~3.1kAutomated safety check: PassMIT
Hreflang and International SEOAgriciDaniel/claude-seo19k5 repos~3.4kAutomated safety check: PassMIT
Referralscoreyhaines31/marketingskills54k2 repos~2.6kAutomated safety check: PassMIT
SEO GeoReScienceLab/opc-skills1.8k4 repos~2.1kAutomated safety check: PassApache-2.0

Similar skills

  • Geo Fundamentals

    wasp-lang/wasp

    Generative Engine Optimization for AI search engines (ChatGPT, Claude, Perplexity).

    19k GitHub starsUsed in 9 repos~861 tokens
    Marketing & SEOAuto-check passed
  • Ab Testing

    coreyhaines31/marketingskills

    When the user wants to plan, design, or implement an A/B test or experiment, or build a growth experimentation program.

    54k GitHub starsUsed in 3 repos~3.1k tokens
    Marketing & SEOAuto-check passed
  • Hreflang and International SEO

    AgriciDaniel/claude-seo

    Audits, validates and generates hreflang tags for multi-language and multi-region sites in HTML, HTTP headers or XML sitemaps, flagging common code and return-tag mistakes.

    19k GitHub starsUsed in 5 repos~3.4k tokens
    Marketing & SEOAuto-check passed
  • Referrals

    coreyhaines31/marketingskills

    When the user wants to create, optimize, or analyze a referral program, affiliate program, or word-of-mouth strategy.

    54k GitHub starsUsed in 2 repos~2.6k tokens
    Marketing & SEOAuto-check passed
  • SEO Geo

    ReScienceLab/opc-skills

    SEO & GEO (Generative Engine Optimization) for websites. An agent skill from ReScienceLab/opc-skills.

    1.8k GitHub starsUsed in 4 repos~2.1k tokens
    Marketing & SEOAuto-check passed
  • Ad Creative

    LeoYeAI/openclaw-marketing-skills

    When the user wants to generate, iterate, or scale ad creative — headlines, descriptions, primary text, or full ad variations — for any paid advertising platform.

    1k GitHub starsUsed in 8 repos~3.4k tokens
    Marketing & SEOAuto-check passed

More from yaojingang/yao-geo-skills

All 24 skills in this repo
  • Yao Geo Knowledge Base Builder

    yaojingang/yao-geo-skills

    Build evidence-backed GEO brand knowledge bases from official sites, product pages, help centers, white papers, sales materials, media releases, certifications, and trusted third-party sources.

    871 GitHub stars~1.8k tokensUpdated 10 days ago
    Auto-check passed
  • Yao Geo Title Optimizer

    yaojingang/yao-geo-skills

    A skill your agent uses when Chinese content teams need GEO title candidates, scoring, compliance review, or title-to-article mapping for articles, pages, FAQs, comparisons, and topic hubs.

    871 GitHub stars~2k tokensUpdated 10 days ago
    Auto-check passed
  • Yao Geo Tracking

    yaojingang/yao-geo-skills

    Build a company-specific GEO backend tracking plan from a company name plus optional supporting information, using authoritative retrieval anchored on the official website, business-feature…

    871 GitHub stars~1.5k tokensUpdated 10 days ago
    Auto-check passed
  • Yao Deepseek Crawler

    yaojingang/yao-geo-skills

    A skill your agent uses when a user provides DeepSeek web AI-search keywords, repeat count, target entity, and entity type, then needs repeated fresh-window crawls aggregated into JSON plus a Kami…

    871 GitHub stars~624 tokensUpdated 10 days ago
    Auto-check passed
  • Yao Geo Execution Roadmap

    yaojingang/yao-geo-skills

    当用户需要把 GEO 全景诊断、机会地图、AI 平台采样结论或品牌事实底座转成 30/60/90 天综合实施方案时使用,输出页面技术、内容矩阵、标题体系、知识库、外部证据、监测闭环、角色分工、验收指标和四格式报告;覆盖 DeepSeek、豆包、千问、Kimi、元宝;不用于从零做全景采样诊断或只写单篇内容。

    871 GitHub stars~646 tokensUpdated 10 days ago
    Auto-check passed
  • Yao Geo Intent Miner

    yaojingang/yao-geo-skills

    A skill your agent uses when a user asks for GEO 意图拓词、AI 搜索意图挖掘、AI 搜索问题集、问题簇、追问链路、查询重写、内容选题库、FAQ 题库、监测 Prompt 库, or AI Intent Miner.

    871 GitHub stars~500 tokensUpdated 10 days ago
    Auto-check passed

Categories

Questions about Yao Geo Page Audit

What does Yao Geo Page Audit do?

Diagnose a website page or small page set for GEO readiness with authoritative public evidence, systematic page analysis, code/content/schema fixes, and four-format Chinese report delivery. Yao Geo Page Audit is an agent skill from yaojingang/yao-geo-skills. Diagnose a website page or small page set for GEO readiness with authoritative public evidence, systematic page analysis, code/content/schema fixes, and four-format Chinese report delivery.

When should I use Yao Geo Page Audit?

Yao Geo Page Audit fits situations like: marketing & SEO work in your project.

How do I install Yao Geo Page Audit in Claude Code?

Run `npx skills add yaojingang/yao-geo-skills --skill yao-geo-page-audit -a claude-code`. Or copy the skill folder (skills/yao-geo-page-audit in yaojingang/yao-geo-skills) into .claude/skills/yao-geo-page-audit in your project. Claude Code loads it when a task matches its description.

How do I install Yao Geo Page Audit in Codex?

Run `npx skills add yaojingang/yao-geo-skills --skill yao-geo-page-audit -a codex`. Or copy the skill folder (skills/yao-geo-page-audit in yaojingang/yao-geo-skills) into .agents/skills/yao-geo-page-audit in your project. Codex loads it when a task matches its description.

Can I use Yao Geo Page 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 yaojingang/yao-geo-skills --skill yao-geo-page-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/yao-geo-page-audit, .gemini/skills/yao-geo-page-audit, .github/skills/yao-geo-page-audit and .opencode/skills/yao-geo-page-audit in your project.

What does Yao Geo Page Audit need to run?

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

Does Yao Geo Page Audit access the network?

SKILL.md names 1 domain. As links in the text: x.com. This is read from the text; nothing was executed.

Is Yao Geo Page 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Yao Geo Page Audit use?

Yao Geo Page 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 Yao Geo Page Audit use?

About 1.2k tokens (SKILL.md is roughly 4.9k 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 5k tokens, read only when the agent opens those files.

What are the alternatives to Yao Geo Page Audit?

Skills that share tags, products or a category with Yao Geo Page Audit: Geo Fundamentals (wasp-lang/wasp, 19k stars), Ab Testing (coreyhaines31/marketingskills, 54k stars), Hreflang and International SEO (AgriciDaniel/claude-seo, 19k stars) and Referrals (coreyhaines31/marketingskills, 54k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Yao Geo Page Audit?

yaojingang (a GitHub user) maintains it in yaojingang/yao-geo-skills, which has 871 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on October 1, 2026.

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