# Yao Geo Page Blueprint

Use when the user needs a GEO-friendly page blueprint for a specific product, topic...

- Repository: https://github.com/yaojingang/yao-geo-skills (912 stars)
- Category: Marketing
- License: MIT
- Last updated: 2026-10-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add yaojingang/yao-geo-skills --skill yao-geo-page-blueprint -g -a claude-code -y`
Codex: `npx skills add yaojingang/yao-geo-skills --skill yao-geo-page-blueprint -g -a codex -y`
Cursor: `npx skills add yaojingang/yao-geo-skills --skill yao-geo-page-blueprint -g -a cursor -y`
Gemini CLI: `npx skills add yaojingang/yao-geo-skills --skill yao-geo-page-blueprint -g -a gemini-cli -y`

## 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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

<!--
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 干扰时，先修复再交付。

## 输出契约

The rest: https://github.com/yaojingang/yao-geo-skills/blob/HEAD/skills/yao-geo-page-blueprint/SKILL.md
