Agent skill

Yao Geo Page Blueprint

by yaojingang in yaojingang/yao-geo-skills

A skill your agent uses when the user needs a GEO-friendly page blueprint for a specific product, topic, article, ranking, comparison, FAQ, knowledge-base, or case page, especially when the work…

MITAuto-check passedWriting & Content

Install Yao Geo Page Blueprint

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

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

GitHub CLI
$ gh skill install yaojingang/yao-geo-skills yao-geo-page-blueprint --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-blueprint .claude/skills/yao-geo-page-blueprint && 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-blueprint
GitHub stars
871
Token cost
~789 tokens
SKILL.md length
163 words
Files
36 (incl. scripts, references)
Skills in repo
24
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user needs a GEO-friendly page blueprint for a specific product, topic, article, ranking, comparison, FAQ, knowledge-base, or case page, especially when the work…

  • Works in 12 steps: 选择页面类型:产品页、专题页、榜单页、对比页、科普页、知识库页、案例页或 FAQ… → 判断数据模式:provided-source-pack、assisted-web-… → 对齐目标问题、用户路径、品牌事实、转化目标和合规边界。 → …
  • The user needs a GEO-friendly page blueprint for a specific product
  • SKILL.md covers 使用场景, 不适用场景, 必读资料 and 执行流程, plus 2 more sections
  • Especially when the work must become implementable page structure rather than only copywriting

What it does

Yao Geo Page Blueprint is an agent skill from yaojingang/yao-geo-skills. Use when the user needs a GEO-friendly page blueprint for a specific product, topic, article, ranking, comparison, FAQ, knowledge-base, or case page, especially when the work must become implementable page structure rather than only copywriting.

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

It sits in Writing & Content, covering Help center and FAQ content, Copywriting and Knowledge bases. 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

  • The user needs a GEO-friendly page blueprint for a specific product
  • Especially when the work must become implementable page structure rather than only copywriting

Example prompts

  • “/yao-geo-page-blueprint”

Workflow steps

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

  1. 选择页面类型:产品页、专题页、榜单页、对比页、科普页、知识库页、案例页或 FAQ 页。
  2. 判断数据模式:provided-source-pack、assisted-web-research、ai-answer-sample 或 synthetic-planning;需要真实数据时按 references/real-data-workflow.md 建立来源包。
  3. 对齐目标问题、用户路径、品牌事实、转化目标和合规边界。
  4. 建立输入、假设与边界表,明确已知事实、设计假设、缺口、合规限制和待确认项。
  5. 建立真实数据接入与核验计划,区分官方来源、客户知识库、第三方资料、AI 答案样本和方案假设。
  6. 建立研究依据映射:把 GEO 可见性、Google 生成式 AI 搜索、query fan-out、长上下文位置偏置、RAG 证据可追溯、结构化特征、Schema 和 WCAG/WAI 规则转成页面设计原则。
  7. 扩展 query fan-out:覆盖定义、对比、风险、价格、替代方案、实施、案例、FAQ 和转化相关子问题,并映射到页面模块。
  8. 生成信息架构:首屏直接答案、结构化摘要、核心事实卡、判断框架、对比表、实体关系、证据区、FAQ、案例、来源和转化模块。
  9. 设计 AI 可抽取模块:键值对、表格、步骤、原子事实、实体关系、问答、上下文无关摘要和 Schema @id 连接关系。
  10. 设计用户转化模块:CTA、表单、咨询、下载、试用、案例入口和内链;CTA 不能干扰核心答案和证据区。
  11. 输出 HTML 语义结构与 Schema 候选,包括 Article、FAQPage、Product、Organization、BreadcrumbList、Review 等;HTML 可视化报告必须带固定跟随菜单栏。
  12. 输出 CMS 字段清单,说明字段 key、中文名、类型、必填性、来源、校验规则、前端位置和是否进入 Schema。

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 Blueprint loads about 789 tokens when it runs, and up to ~5.7k if it reads all its reference files. Until then it costs about 67 tokens; SKILL.md has 163 words of instructions outside code blocks.

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

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). 163 words, ~789 tokens.

Download SKILL.mdSave it as .claude/skills/yao-geo-page-blueprint/SKILL.md (or your agent's skills folder). This skill also uses 35 other files; get the full folder from GitHub.
name
yao-geo-page-blueprint
description
Use when the user needs a GEO-friendly page blueprint for a specific product, topic, article, ranking, comparison, FAQ, knowledge-base, or case page, especially when the work must become implementable page structure rather than only copywriting.
metadata.owner
Yao Team
metadata.family
geo-page-technical
metadata.maturity
beta
metadata.requires_web
false
metadata.default_outputs
Word, PDF, HTML, Markdown
<!--
Copyright © 2026 姚金刚. All rights reserved.
Project: yao-geo-page-blueprint
Created by: 姚金刚
Date: 2026-05-16
X: https://x.com/yaojingang
-->

Yao GEO Page Blueprint

使用场景

  • 把目标内容、目标问题、品牌知识库、用户路径和转化目标,落成 GEO 友好的页面方案。
  • 页面类型属于产品页、专题页、文章页、榜单页、对比页、科普页、知识库页、案例页或 FAQ 页。
  • 页面要同时服务国内 AI 平台抓取、答案抽取、真实用户阅读和转化。
  • 交付物需要包含 HTML 语义结构、Schema 建议、CMS 字段清单和四格式报告。

不适用场景

  • 全站品牌、竞品、信源和 AI 答案样本诊断;应改用 yao-geo-panorama-audit。
  • GEO 后端效果归因、埋点或追踪闭环;应改用 yao-geo-tracking。
  • 只写文章、标题、公众号推文或内容改写,而不需要页面落地方案。

必读资料

  • references/page-blueprint-method.md
  • references/research-foundation.md
  • references/cn-ai-platform-adaptation.md
  • references/schema-html-cms-contract.md
  • references/real-data-workflow.md
  • references/artifact-layout.md
  • references/quality-gates.md
  • references/output-file-workflow.md

执行流程

  1. 选择页面类型:产品页、专题页、榜单页、对比页、科普页、知识库页、案例页或 FAQ 页。
  2. 判断数据模式:provided-source-pack、assisted-web-research、ai-answer-sample 或 synthetic-planning;需要真实数据时按 references/real-data-workflow.md 建立来源包。
  3. 对齐目标问题、用户路径、品牌事实、转化目标和合规边界。
  4. 建立输入、假设与边界表,明确已知事实、设计假设、缺口、合规限制和待确认项。
  5. 建立真实数据接入与核验计划,区分官方来源、客户知识库、第三方资料、AI 答案样本和方案假设。
  6. 建立研究依据映射:把 GEO 可见性、Google 生成式 AI 搜索、query fan-out、长上下文位置偏置、RAG 证据可追溯、结构化特征、Schema 和 WCAG/WAI 规则转成页面设计原则。
  7. 扩展 query fan-out:覆盖定义、对比、风险、价格、替代方案、实施、案例、FAQ 和转化相关子问题,并映射到页面模块。
  8. 生成信息架构:首屏直接答案、结构化摘要、核心事实卡、判断框架、对比表、实体关系、证据区、FAQ、案例、来源和转化模块。
  9. 设计 AI 可抽取模块:键值对、表格、步骤、原子事实、实体关系、问答、上下文无关摘要和 Schema @id 连接关系。
  10. 设计用户转化模块:CTA、表单、咨询、下载、试用、案例入口和内链;CTA 不能干扰核心答案和证据区。
  11. 输出 HTML 语义结构与 Schema 候选,包括 Article、FAQPage、Product、Organization、BreadcrumbList、Review 等;HTML 可视化报告必须带固定跟随菜单栏。
  12. 输出 CMS 字段清单,说明字段 key、中文名、类型、必填性、来源、校验规则、前端位置和是否进入 Schema。
  13. 输出桌面端、移动端、公众号版、无障碍和实施验收建议。
  14. 如需文件交付,使用 scripts/render_yao_geo_page_blueprint.py 从 report_input.json 生成 Markdown、HTML、Word、PDF。
  15. 按 references/quality-gates.md 自 review;发现分析不完整、数据来源不清、格式缺失、溢出、字段英文化、Schema 越界、固定菜单缺失或 CTA 干扰时,先修复再交付。

输出契约

  • GEO 页面设计方案
  • 输入、假设与边界
  • 真实数据接入与核验计划
  • 查询意图与 Query Fan-out 覆盖
  • 页面模块与信息架构图
  • 研究依据与页面设计原则
  • 实体关系与知识图谱字段
  • 证据区与来源台账
  • AI 可抽取模块设计
  • 用户转化模块设计
  • HTML 结构样例
  • Schema 建议
  • CMS 字段清单
  • 无障碍与页面体验要求
  • 实施验收与监测计划
  • 桌面端、移动端和公众号版建议
  • 默认四格式交付:Word(.docx)、PDF(.pdf)、HTML(.html)、Markdown(.md)

校验清单

  • 首屏不能只有营销口号,必须有直接答案、关键事实和摘要。
  • 报告不能只列模块,必须系统、详细、完整地说明输入边界、query fan-out、实体关系、证据、Schema、CMS、无障碍和实施验收。
  • 需要真实数据时必须先建立来源包和核验日期;没有真实来源时必须标注为方案假设,不能把模型记忆写成事实。
  • FAQ 不能只放页面底部;高价值问题要进入页面中前段或关键模块旁。
  • HTML 语义必须清楚,表格、问答、步骤和事实卡不能只靠视觉卡片表达。
  • HTML 可视化报告必须有固定跟随菜单栏,目录锚点不能遮挡模块标题,移动端菜单不能溢出。
  • Schema 不得包含正文没有的事实,不得伪造评分、评价、价格、资质或案例。
  • 证据区必须明确来源、页面内位置、核验日期和用途,不能只列参考链接。
  • FAQPage 不能被当成通用流量技巧或 Google 富结果承诺;FAQ 内容必须真实可见,且不用于广告目的。
  • 四格式报告必须白底、对齐稳定、表格可读、无溢出、无异常行距,并完成自 review。

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

  • SKILL.md
  • agents/interface.yaml
  • evals/expected_artifacts.json
  • evals/failure_cases.md
  • evals/quality_cases.json
  • evals/rubric.md
  • evals/trigger_cases.json
  • examples/demo/lingxu-yao-geo-page-blueprint-demo-quality-review.json
  • examples/demo/lingxu-yao-geo-page-blueprint-demo.docx
  • examples/demo/lingxu-yao-geo-page-blueprint-demo.html
  • examples/demo/lingxu-yao-geo-page-blueprint-demo.md
  • examples/demo/lingxu-yao-geo-page-blueprint-demo.pdf
  • examples/demo/report_input.json
  • examples/hubspot-cn-demo/hubspot-cn-yao-geo-page-blueprint-quality-review.json
  • examples/hubspot-cn-demo/hubspot-cn-yao-geo-page-blueprint.docx
  • examples/hubspot-cn-demo/hubspot-cn-yao-geo-page-blueprint.html
  • … and 20 more

Open the folder on GitHubat commit d21bfc1

Compare with similar skills

Yao Geo Page Blueprint 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 Blueprint compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Yao Geo Page Blueprint this skillyaojingang/yao-geo-skills871—~789Automated safety check: PassMIT
Amazon Working Backwardsamplitude/builder-skills159—~1.4kAutomated safety check: PassNone
Bmad Prfaqaj-geddes/claude-code-bmad-skills488—~2.6kAutomated safety check: PassCustom licence
Etsy Product Descriptionnexscope-ai/eCommerce-Skills1.1k—~437Automated safety check: PassMIT
LLMs Txtthedaviddias/Front-End-Checklist74k—~652Automated safety check: PassMIT
Update Knowledge Baseamplitude/builder-skills159—~746Automated safety check: PassNone

Similar skills

  • Amazon Working Backwards

    amplitude/builder-skills

    Write a PR/FAQ for a product idea using Amazon's Working Backwards process.

    159 GitHub stars~1.4k tokensUpdated 2 mo ago
    Writing & ContentAuto-check passed
  • Bmad Prfaq

    aj-geddes/claude-code-bmad-skills

    Amazon-style Working-Backwards PRFAQ: a future press release plus internal and external FAQs that stress-test a product concept before any building begins.

    488 GitHub stars~2.6k tokensUpdated 3 mo ago
    Writing & ContentAuto-check passed
  • Etsy Product Description

    nexscope-ai/eCommerce-Skills

    Product description writing — keyword integration, benefit-focused copy, FAQ, formatting

    1.1k GitHub stars~437 tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • LLMs Txt

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing public documentation portals, API references, help centers, SDK docs, or large knowledge bases.

    74k GitHub stars~652 tokensUpdated 5 days ago
    Marketing & SEOAuto-check passed
  • Update Knowledge Base

    amplitude/builder-skills

    Cross-reference recently shipped tickets against your help center and changelog to detect outdated articles, missing documentation, and undocumented features.

    159 GitHub stars~746 tokensUpdated 2 mo ago
    Sales & SupportAuto-check passed
  • Cs Kb Article

    evolution-foundation/evo-nexus

    Redige um artigo para base de conhecimento a partir de um problema resolvido ou pergunta frequente.

    545 GitHub stars~3.4k tokensUpdated 5 mo ago
    Sales & SupportAuto-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

Questions about Yao Geo Page Blueprint

What does Yao Geo Page Blueprint do?

A skill your agent uses when the user needs a GEO-friendly page blueprint for a specific product, topic, article, ranking, comparison, FAQ, knowledge-base, or case page, especially when the work…. Yao Geo Page Blueprint is an agent skill from yaojingang/yao-geo-skills. Use when the user needs a GEO-friendly page blueprint for a specific product, topic, article, ranking, comparison, FAQ, knowledge-base, or case page, especially when the work must become implementable page structure rather than only copywriting.

When should I use Yao Geo Page Blueprint?

Yao Geo Page Blueprint fits situations like: the user needs a GEO-friendly page blueprint for a specific product; especially when the work must become implementable page structure rather than only copywriting.

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

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

How do I install Yao Geo Page Blueprint in Codex?

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

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

What does Yao Geo Page Blueprint need to run?

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

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

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

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

What are the alternatives to Yao Geo Page Blueprint?

Skills that share tags, products or a category with Yao Geo Page Blueprint: Amazon Working Backwards (amplitude/builder-skills, 159 stars), Bmad Prfaq (aj-geddes/claude-code-bmad-skills, 488 stars), Etsy Product Description (nexscope-ai/eCommerce-Skills, 1.1k stars) and LLMs Txt (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 Yao Geo Page Blueprint?

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.