Yao GEO Skills
面向 GEO(Generative Engine Optimization)工作流的开源 Skill 仓库。
英文说明文档: 英文版 README
可视化导航页: index.html
说明:
本仓库里的 GEO 指生成式引擎优化,不是地理信息或地图相关工具。
当前状态
当前仓库包含 17 个 GEO 相关 skill,覆盖战略诊断、页面技术、内容生产、知识资产、监测归因、研究拓词和 GEOFlow 运营。
| 分类 | 数量 | 代表场景 |
|---|---|---|
geo-operations | 3 | GEOFlow CLI 操作、模板映射、Laravel Blade 主题编辑 |
geo-strategy | 2 | GEO 全景诊断、30/60/90 天执行路线图 |
geo-page-technical | 2 | 页面 GEO 诊断、GEO 友好页面蓝图 |
geo-content-production | 5 | 标题、科普、对比、旧文改造、榜单评测 |
geo-knowledge-assets | 2 | 品牌知识图谱、品牌知识库和事实卡 |
geo-measurement | 2 | GEO 归因追踪、AI 答案监测月报 |
geo-research | 1 | AI 搜索问题集、意图簇和监测 Prompt |
每个正式 skill 至少包含:
SKILL.md:Agent 调用入口和执行边界manifest.json:公开元信息templates/brief-template.md:输入简报模板evals/trigger_cases.json与evals/expected_artifacts.json:触发和产物校验docs/skills/<skill-id>.md:适合 GitHub 用户阅读的说明页
可运行仓库校验:
python3 scripts/validate_repository.py
仓库定位与背景
yao-geo-skills 用来沉淀一批可复用、可验证、可开源分享的 GEO Skill。
这里关注的不是零散 prompt,而是完整的执行资产:
- 有清晰边界的
SKILL.md - 有稳定接口的
agents/interface.yaml - 有参考方法、样例、脚本和 eval 的完整包
- 有公开可复用的示例输入、输出和截图
这个仓库适合沉淀以下类型的能力:
- GEO 运营流程
- GEO 效果追踪与归因
- GEO 研究与证据扫描
- GEO 相关的共享模板、schema、rubric 和交付规则
如果一句话概括,这个仓库的目标是: 把 GEO 相关的重复工作,整理成团队可以长期复用的 Skill 包。
仓库特点
- 强调可复用:每个 skill 都应该能在相似任务里重复使用,而不是一次性 prompt。
- 强调可验证:仓库和 skill 都有结构校验,不鼓励“能跑就行”的散装内容。
- 强调边界:明确什么时候该用、什么时候不该用,避免 skill 泛化成空话。
- 强调开源安全:公开案例必须去隐私、去内网依赖、去私有系统绑定。
- 强调交付:不少 skill 不只输出文字,还会生成 HTML、DOCX 等可直接交付的产物。
- 强调方法沉淀:复杂方法会拆到
references/、scripts/、evals/中,而不是堆在一个超长 prompt 里。
适用范围
适合:
- 想复用 GEO 相关方法,而不是每次重写 prompt
- 想把 GEO 任务做成标准化 skill 包
- 想公开分享 GEO 工作流,同时控制质量和隐私
- 想沉淀可阅读、可验证、可演示的 GEO 样例
不适合:
- 只想存放一批零散 prompt
- 只想记录临时脑暴,不关心复用与维护
- 需要私有系统、私有文档、私有 API 才能运行的内容
- 与 GEO 无关的通用型 skill 仓库
仓库逻辑
本仓库的组织逻辑很简单:
- 一个 skill 解决一个明确工作。
skills/存技能包本体。docs/skills/存更适合人读的说明页。registry/skills.json记录仓库内 skill 清单。shared/存共享模板、schema、约定。scripts/validate_repository.py负责做仓库级结构校验。
对外展示时,这个仓库优先传达三件事:
- 这个 skill 是干什么的
- 这个 skill 怎么保证质量
- 这个 skill 有没有公开可看的示例
下载方式
下载整个仓库
方式 1:git clone
git clone https://github.com/yaojingang/yao-geo-skills.git cd yao-geo-skills
方式 2:GitHub 页面下载 ZIP
在 GitHub 仓库页面点击:
Code -> Download ZIP
只拉取某个 skill
方式 1:Sparse Checkout
git clone --filter=blob:none --no-checkout https://github.com/yaojingang/yao-geo-skills.git cd yao-geo-skills git sparse-checkout init --cone git sparse-checkout set skills/yao-geo-tracking docs/skills/yao-geo-tracking.md git checkout main
方式 2:手动下载
直接打开对应 skill 目录,在 GitHub 页面按需下载文件:
- skills/yao-geo-tracking
- skills/yao-geo-effect-monitor
- skills/yao-geo-panorama-audit
- skills/yao-geo-page-audit
- skills/yao-geo-ranking-article-builder
- skills/yao-geo-explainer-builder
- skills/yao-geo-content-refiner
- skills/yao-geo-title-optimizer
- skills/yao-geo-comparison-builder
- skills/yao-geo-execution-roadmap
- skills/yao-geo-page-blueprint
- skills/yao-geo-brand-graph
- skills/yao-geo-knowledge-base-builder
- skills/yao-geo-intent-miner
- skills/yao-geoflow-cli
- skills/yao-geoflow-template
- skills/yao-geoflow-design
Skills 导航
当前 catalog 按工作类型分成 operations / strategy / page-technical / content-production / knowledge-assets / measurement / research,方便快速判断一个 skill 是偏执行、偏战略诊断、偏页面技术、偏内容生产、偏知识资产、偏监测,还是偏研究。
operations
yao-geoflow-cli作用:通过本地 geoflow CLI 或 Laravel /api/v1 fallback 操作已有的 GEOFlow 系统,用于目录查询、任务管理、文章上传、审核与发布。适合:已经有 GEOFlow 系统,需要通过 CLI/API 做运营动作、批量处理、Docker 部署预检或自动化编排。 相关入口: 说明页 · Skill 包 · GEOFlow 项目 |
yao-geoflow-template作用:把参考网址的前台视觉风格映射成 GEOFlow 兼容的主题包方案,输出模块映射、设计 token 和 preview-first 模板结构。 适合:GEOFlow 前台模板复刻、参考站样式映射、主题包规划、模板预览与启用前的前置准备。 相关入口: 说明页 · English Guide · Skill 包 · GEOFlow 项目 |
yao-geoflow-design作用:识别 GEOFlow 当前 Laravel Blade 主题,指定目标主题进入 preview-first 编辑会话,并完成模板复刻、现有模板优化与局部样式调整。 适合:GEOFlow 当前主题迭代、指定模板改版、预览态样式优化、参考站风格映射后落地,以及在不破坏 SEO/schema、Markdown 渲染和主题 fallback 契约的前提下新增或替换模板。 相关入口: 说明页 · English Guide · Skill 包 · GEOFlow 项目 |
strategy
yao-geo-panorama-audit作用:建立品牌 GEO 全景基线,面向 DeepSeek、豆包、千问、Kimi、元宝诊断 AI 答案可见性、竞品差距、内容页面缺口、官网证据和外部信源,并输出机会地图与 P0/P1 优先级。 适合:项目启动、季度复盘、竞品追赶、投放前评估,以及需要先判断 GEO 机会和资源优先级的战略诊断。 合成示例: Markdown · HTML · Word · PDF 相关入口: 说明页 · Skill 包 |
yao-geo-execution-roadmap作用:把 GEO 全景诊断、机会地图和平台采样结论转成系统、详细、完整的 30/60/90 天执行路线图,覆盖真实数据采集计划、来源新鲜度、分析完整性矩阵、证据成熟度、资源预算、治理节奏、六个项目包、国内平台适配和 kami 风格四格式交付。 适合:诊断完成后,需要面向 CEO、市场、增长、内容、技术和客户交付团队拆项目包、责任分工、验收指标、预算优先级和风险预案。 公开示例: 输入 · Markdown · HTML · Word · PDF 相关入口: 说明页 · Skill 包 |
page-technical
yao-geo-page-audit作用:输入网址后诊断首页、代表性一级页和二级页的可抓取性、结构规范性、内容信号、权威证据和 AI 可抽取性,输出代码层与内容层修复清单、Schema/HTML 建议和固定目录 HTML 报告。 适合:官网首页、栏目页、产品页、文章页、帮助中心、文档页、案例页和落地页的 GEO Page Audit,以及需要 Word/PDF/HTML/Markdown 四件套报告的页面诊断交付。 公开示例: Markdown · HTML · Word · PDF 相关入口: 说明页 · Skill 包 |
yao-geo-page-blueprint作用:生成 GEO 友好页面的信息架构、真实数据核验计划、AI 可抽取模块、用户转化模块、HTML 语义结构、Schema 建议、CMS 字段清单,以及 Word/PDF/HTML/Markdown 四格式页面蓝图报告。 适合:官网产品页、专题页、文章页、榜单页、对比页、FAQ页、知识库页和案例页设计,尤其是需要同时服务国内 AI 平台抽取和真实用户转化的页面技术场景。 公开示例: 输入 · Markdown · HTML · Word · PDF 相关入口: 说明页 · Skill 包 |
content-production
yao-geo-title-optimizer作用:为文章、页面、FAQ 和专题生成 GEO 标题候选库,覆盖国内 AI 平台适配、品牌隔离、公开证据快照、分析维度、合规过滤、标题评分和文章结构映射。 适合:内容矩阵标题库、选题命名、标题候选评审、标题到文章结构映射,以及需要 Word/PDF/HTML/Markdown 四格式交付的标题系统。 相关入口: 说明页 · Skill 包 |
yao-geo-comparison-builder作用:生成目标品牌与竞品、同类方案、传统方案或自建方案的 GEO 对比内容,覆盖真实数据获取、来源访问验证、同口径维度、证据锚点、场景选择、FAQ、风险治理和国内 AI 平台适配。 适合:品牌替代方案、选型页、竞品对比页、FAQ 页、商业决策类内容,以及需要 Word/PDF/HTML/Markdown 四格式交付的对比内容生产。 HubSpot 示例: Markdown · HTML · Word · PDF · 质量报告 相关入口: 说明页 · Skill 包 |
yao-geo-ranking-article-builder作用:基于品牌 Brief、选题 JSON、竞品库和可信来源生成 GEO 榜单评测文章,覆盖真实数据边界、来源可达审计、分析完整性、评选方法、核心对比表、榜单正文、适合人群、FAQ 和来源表。 适合:best、top、alternatives、vs、人群和场景类榜单内容生产,以及需要 Word/PDF/HTML/Markdown 四格式文章包的投放和代理商交付。 公开示例: Markdown · HTML · Word · PDF 相关入口: 说明页 · Skill 包 |
yao-geo-explainer-builder作用:生成可发布的完整 GEO 科普文章,并附带 How-to 教程、概念解释、怎么选、避坑指南、FAQ、术语表、真实数据接入状态、事实核验矩阵和品牌自然植入建议。 适合:品牌教育、行业知识、购买前科普、公众号教程、AI 搜索问答素材,以及需要 kami 版式 Word/PDF/HTML/Markdown 四格式交付的内容生产。 公开示例: Markdown · HTML · Word · PDF · 质量报告 相关入口: 说明页 · Skill 包 |
yao-geo-content-refiner作用:把已有 SEO 文章、公众号文章、官网文章、白皮书和产品页文案改造成结构化、可信、可引用、可抽取的 GEO 内容。 适合:旧文 GEO 改造、AI 可引用内容修复、FAQ、原子事实、真实数据核验、语义实体、平台适配、证据强度、CMS 发布建议,以及带 sticky HTML 菜单和 Kami 编辑排版的 Word/PDF/HTML/Markdown 四格式交付。 HubSpot 国内 AI 平台测试示例: Markdown · HTML · Word · PDF · 质量报告 相关入口: 说明页 · Skill 包 |
knowledge-assets
yao-geo-brand-graph作用:把企业信息转成品牌、产品、人物、地点、案例、证据和场景之间的实体关系图,输出来源核验、实体清单、关系清单、可信等级、Mermaid、JSON-LD、三元组和图谱补强建议。 适合:知识库升级、页面结构设计、监测纠偏、品牌百科化和 AI 内容一致性治理,尤其是需要解决品牌错指、简称歧义、产品关系不清和证据链缺失的场景。 公开示例: 输入 · Markdown · HTML · Word · PDF 相关入口: 说明页 · Skill 包 |
yao-geo-knowledge-base-builder作用:基于官网、产品页、帮助中心、白皮书、销售材料、媒体稿和资质文件生成系统化 GEO 品牌知识库、完整实体清单、真实数据获取边界、事实卡、FAQ、禁用表达、Prompt 输入包和来源索引。 适合:内容生成、内容改造、页面设计、监测和客服问答前置准备,尤其是面向 Kimi、千问、DeepSeek、豆包、元宝复用结构化品牌事实的知识资产场景。 公开示例: 输入 · HTML · Markdown · Word · PDF 相关入口: 说明页 · Skill 包 |
measurement
yao-geo-tracking作用:输入公司名称和辅助信息,基于官网与官方资产生成 GEO 后端效果追踪方案,显式区分国内 / 海外 / 混合 GEO 的不同监测逻辑。 适合:官网优先检索、业务识别、直接与间接效果设计、可视化 HTML 报告、DOCX 交付。 公开示例: 海外示例:HubSpot 输入 · HTML · DOCX 国内合成示例:岭序商机云输入 · HTML · DOCX 相关入口: 说明页 · Skill 包 · 海外截图 · 国内截图 |
yao-geo-effect-monitor作用:设计 GEO Signal Monitor,面向 DeepSeek、豆包、千问、Kimi、元宝建立 AI 答案监测、引用追踪、真实数据获取、报告完整性模型、品牌事实纠偏、月报告警和谨慎归因闭环。 适合:GEO 长期运营、客户月报、内容迭代、页面优化、外部信源建设、品牌事实纠偏和看板/API 字段规划。 示例报告:Markdown · HTML · Word · PDF 相关入口: 说明页 · Skill 包 |
research
yao-geo-intent-miner作用:把种子词、品牌、产品、竞品、区域、人群和业务材料扩展成 AI 搜索问题集、意图簇、追问链路、查询重写、内容选题、FAQ 题库、知识库条目计划、证据缺口和监测 Prompt 库。 适合:内容生产前建立问题底座,尤其是需要面向 DeepSeek、豆包、千问、Kimi、元宝适配国内平台问法,并输出 Word/PDF/HTML/Markdown 四格式交付的意图拓词场景。 公开示例: 示例输入 · HTML · Word · PDF · Markdown · 质量报告 相关入口: 说明页 · Skill 包 |
相关示例
仓库内已包含多组公开或合成示例,重点用于展示输入结构、方法链路、四格式交付和质量门:
yao-geo-tracking:海外公开公司示例 HubSpot、国内公开合成示例岭序商机云yao-geo-panorama-audit:岭序商机云 GEO 全景诊断合成示例、HubSpot 国内 AI 平台测试示例yao-geo-page-audit:示例云服页面 GEO 诊断合成示例、HubSpot 页面诊断示例yao-geo-page-blueprint:页面蓝图示例和 HubSpot 中文页面蓝图示例yao-geo-ranking-article-builder:榜单评测文章合成示例和 HubSpot 示例yao-geo-comparison-builder:HubSpot 中文对比报告示例yao-geo-content-refiner:HubSpot 旧文 GEO 改造示例yao-geo-explainer-builder:Acme Sleep 科普文章、真实数据核验和 kami 四格式报告示例yao-geo-brand-graph:HubSpot 国内 AI 平台品牌图谱示例yao-geo-knowledge-base-builder:HubSpot 品牌知识库示例yao-geo-intent-miner:HubSpot 中文 AI 意图拓词示例- 示例输出形态:
Markdown、HTML、Word、PDF、report_input.json、quality-report.json、截图或预览图(视 skill 类型而定)
这些示例的作用不是给出“真实经营结论”,而是展示:
- 方法论如何落到结构化输入
- Skill 如何把方法渲染成可视化交付物
- 国内与海外 GEO 的监测逻辑有什么不同
目录导航
yao-geo-skills/ ├── index.html ├── README.md ├── LICENSE ├── .github/ ├── docs/ │ ├── README.en.md │ ├── repository-design.md │ ├── input-output-contract.md │ ├── naming-conventions.md │ ├── eval-policy.md │ ├── publishing-rules.md │ └── skills/ ├── registry/ ├── scripts/ ├── shared/ └── skills/
常用目录说明:
- skills/:Skill 包本体
- docs/skills/:适合直接阅读的 skill 说明文档
- registry/skills.json:仓库 skill 清单
- scripts/validate_repository.py:仓库级校验脚本
- docs/:仓库规则、契约、命名和发布说明
仓库文档
设计原则
- 一个 skill 只做一件明确的事
- 优先公开可验证资料,不鼓励事实型 skill 依赖未授权信息
- 输出既要人能读,也要机器能校验
- 公开示例必须去隐私、去内网依赖、去私有客户数据
- eval 和结构检查是默认要求,不是可选项
- 与其堆提示词,不如沉淀长期可维护的技能包
贡献与发布流程
- 在
skills/<skill-id>/下新增或更新 skill。 - 在
docs/skills/下补充对应说明页。 - 在
registry/skills.json中登记 skill。 - 运行仓库校验:
python3 scripts/validate_repository.py
- 自查 diff,确认没有私有数据、临时文件或错误示例。
- 提交并推送。
- 非小改动建议通过 PR 方式合并。
更细的发布规则见: docs/publishing-rules.md