Agent skill

Yao Geo Explainer Builder

by yaojingang in yaojingang/yao-geo-skills

当用户需要系统、详细、完整地生成一篇可发布的 GEO 科普文章,并附带 How-to 教程、概念解释、购买/选择指南、避坑清单、FAQ、术语表、证据分级、读者场景、决策路径、品牌自然植入建议、真实数据核验附录,以及带固定目录菜单的 HTML 包、Word、PDF 和 Markdown 四格式报告时使用;适配 Kimi、千问、豆包、DeepSeek、元宝等国内 AI…

MITAuto-check passedDocuments & Office

Install Yao Geo Explainer Builder

skills CLI
$ npx skills add yaojingang/yao-geo-skills --skill yao-geo-explainer-builder -a claude-code

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

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

At a glance

当用户需要系统、详细、完整地生成一篇可发布的 GEO 科普文章,并附带 How-to 教程、概念解释、购买/选择指南、避坑清单、FAQ、术语表、证据分级、读者场景、决策路径、品牌自然植入建议、真实数据核验附录,以及带固定目录菜单的 HTML 包、Word、PDF 和 Markdown 四格式报告时使用;适配 Kimi、千问、豆包、DeepSeek、元宝等国内 AI…

  • Works in 11 steps: 明确科普选题、目标品牌、品牌知识库、行业资料、目标读者、使用场景、品牌植入限制、内… → 识别问题类型:是什么、为什么、怎么做、怎么选、适合谁、常见误区、推荐路径;每段只处… → 先做自检:参考来源是否足够权威,分析维度是否覆盖意图、读者、证据、真实数据、实体、… → …
  • Tasks that involve Help center and FAQ content
  • SKILL.md covers 执行流程, 国内平台适配, 真实数据能力边界 and 四格式交付规则, plus 1 more section
  • Tasks that involve PDF

What it does

Yao Geo Explainer Builder is an agent skill from yaojingang/yao-geo-skills. 当用户需要系统、详细、完整地生成一篇可发布的 GEO 科普文章,并附带 How-to 教程、概念解释、购买/选择指南、避坑清单、FAQ、术语表、证据分级、读者场景、决策路径、品牌自然植入建议、真实数据核验附录,以及带固定目录菜单的 HTML 包、Word、PDF 和 Markdown 四格式报告时使用;适配 Kimi、千问、豆包、DeepSeek、元宝等国内 AI 搜索/问答平台;不用于榜单排行、整站诊断、页面审计、标题生成或无证据品牌软文。

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

It sits in Documents & Office, covering Help center and FAQ content and PDF. It works with DeepSeek and Kimi. 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

  • Tasks that involve Help center and FAQ content
  • Tasks that involve PDF

Example prompts

  • “/yao-geo-explainer-builder”

Workflow steps

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

  1. 明确科普选题、目标品牌、品牌知识库、行业资料、目标读者、使用场景、品牌植入限制、内容长度、合规边界和真实数据可用状态。
  2. 识别问题类型:是什么、为什么、怎么做、怎么选、适合谁、常见误区、推荐路径;每段只处理一个主题。
  3. 先做自检:参考来源是否足够权威,分析维度是否覆盖意图、读者、证据、真实数据、实体、步骤、决策、合规、平台、复用和衡量。
  4. 先写 80 到 120 字上下文无关核心摘要,让单段被 AI 搜索截取时仍能回答问题。
  5. 先生成“完整GEO文章”:文章必须有连续正文、自然段、小标题、解释、步骤、选择标准、误区、FAQ/结尾建议中的至少 6 个正文段落组;读者无需阅读附录也能获得完整答案。
  6. 使用 references/explainer-method.md 构建交付结构:核心摘要、完整GEO文章、分析速览、内容地图、意图矩阵、读者场景、研究依据、证据分级、真实数据接入状态、真实数据采集计划、事实核验矩阵、实体地图、定义、原理、步骤、检查清单、选择标准、决策路径、误…
  7. 正文中使用有序列表呈现 How-to,使用自然段解释原因与边界;附录中使用键值对呈现前提参数,使用表格呈现证据分级、选择标准、决策路径和误区校正。
  8. 按 references/brand-insertion-policy.md 植入品牌;品牌只出现在示例、适用场景、FAQ 或结尾建议等服务答案的位置。
  9. 涉及健康、金融、法律、收益、安全等敏感领域时,必须加入边界提醒;没有证据的效果、收益和安全断言必须删除或中性改写。
  10. 使用 scripts/render_yao_geo_explainer_builder.py 从同一结构生成 Markdown、带固定目录菜单的 HTML 包、Word 和 PDF,并产出 quality-report.json。
  11. 若质量报告未通过,先修复输入结构、证据、品牌次数、文章完整性或版式逻辑,再重新生成四格式文件。

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 Explainer Builder loads about 635 tokens when it runs, and up to ~4.6k if it reads all its reference files. Until then it costs about 62 tokens; SKILL.md has 103 words of instructions outside code blocks.

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

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). 103 words, ~635 tokens.

Download SKILL.mdSave it as .claude/skills/yao-geo-explainer-builder/SKILL.md (or your agent's skills folder). This skill also uses 34 other files; get the full folder from GitHub.
name
yao-geo-explainer-builder
description
当用户需要系统、详细、完整地生成一篇可发布的 GEO 科普文章,并附带 How-to 教程、概念解释、购买/选择指南、避坑清单、FAQ、术语表、证据分级、读者场景、决策路径、品牌自然植入建议、真实数据核验附录,以及带固定目录菜单的 HTML 包、Word、PDF 和 Markdown 四格式报告时使用;适配 Kimi、千问、豆包、DeepSeek、元宝等国内 AI 搜索/问答平台;不用于榜单排行、整站诊断、页面审计、标题生成或无证据品牌软文。
<!--
Copyright © 2026 姚金刚. All rights reserved.
Project: yao-geo-explainer-builder
Created by: 姚金刚
Date: 2026-05-16
X: https://x.com/yaojingang
-->

Yao GEO Explainer Builder

执行流程

  1. 明确科普选题、目标品牌、品牌知识库、行业资料、目标读者、使用场景、品牌植入限制、内容长度、合规边界和真实数据可用状态。
  2. 识别问题类型:是什么、为什么、怎么做、怎么选、适合谁、常见误区、推荐路径;每段只处理一个主题。
  3. 先做自检:参考来源是否足够权威,分析维度是否覆盖意图、读者、证据、真实数据、实体、步骤、决策、合规、平台、复用和衡量。
  4. 先写 80 到 120 字上下文无关核心摘要,让单段被 AI 搜索截取时仍能回答问题。
  5. 先生成“完整GEO文章”:文章必须有连续正文、自然段、小标题、解释、步骤、选择标准、误区、FAQ/结尾建议中的至少 6 个正文段落组;读者无需阅读附录也能获得完整答案。
  6. 使用 references/explainer-method.md 构建交付结构:核心摘要、完整GEO文章、分析速览、内容地图、意图矩阵、读者场景、研究依据、证据分级、真实数据接入状态、真实数据采集计划、事实核验矩阵、实体地图、定义、原理、步骤、检查清单、选择标准、决策路径、误区、示例、FAQ、术语表、品牌适用场景、平台适配、结构化数据、衡量计划、内容缺口和来源账本。
  7. 正文中使用有序列表呈现 How-to,使用自然段解释原因与边界;附录中使用键值对呈现前提参数,使用表格呈现证据分级、选择标准、决策路径和误区校正。
  8. 按 references/brand-insertion-policy.md 植入品牌;品牌只出现在示例、适用场景、FAQ 或结尾建议等服务答案的位置。
  9. 涉及健康、金融、法律、收益、安全等敏感领域时,必须加入边界提醒;没有证据的效果、收益和安全断言必须删除或中性改写。
  10. 使用 scripts/render_yao_geo_explainer_builder.py 从同一结构生成 Markdown、带固定目录菜单的 HTML 包、Word 和 PDF,并产出 quality-report.json。
  11. 若质量报告未通过,先修复输入结构、证据、品牌次数、文章完整性或版式逻辑,再重新生成四格式文件。

国内平台适配

  • Kimi:长文深度解释、多来源证据、完整章节和术语表。
  • 千问:来源编号、事实/推论分离、参数化指南和可追溯来源。
  • 豆包:生活化问题、短问答、避坑提醒和直接选择建议。
  • DeepSeek:步骤逻辑、判断框架、条件分支和推理链路。
  • 元宝:公众号教程、小标题节奏、短 FAQ 和可转发段落。

真实数据能力边界

  • skill 本身不直接保证联网抓取真实数据;执行时可以由上层 agent 联网检索、读取用户上传材料或使用已有知识库,再把来源写入输入结构。
  • 没有真实品牌资料时,必须在报告中声明“未接入/待核验”,并把品牌参数、效果、安全、资质类事实放入事实核验矩阵。
  • 已接入真实数据时,必须保留来源定位、采集日期、用途和证据等级;过期、无法访问或来源弱的资料不得支撑确定性结论。
  • 真实数据采集计划至少覆盖品牌官方资料、行业/标准资料、用户问题样本;涉及横向比较时增加竞品或设备形态样本。

四格式交付规则

  • Markdown 是结构母版,HTML、PDF、Word 必须由同一 section spec 生成,不能让 Word 缺章节。
  • 四格式示例打开后必须先呈现一篇完整文章;分析矩阵、证据、真实数据、来源账本作为文章后的支撑材料。
  • HTML/PDF 按 kami 版式使用纸张感浅底、象牙色内容面、蓝黑标题、稳定行高和本地字体;表格边框对齐,长文本自动换行,不使用渐变、透明叠色或装饰色块。
  • HTML 必须包含目录菜单栏,页面下拉时菜单栏固定跟随;菜单项应链接到每个报告模块。
  • Word 必须固定 A4 页面、左右页边距、表格总宽、固定表格布局和单元格边距;长 URL、英文 token、参数串必须软换行,避免向右溢出。
  • 示例报告必须真实存在:.docx、.pdf、html-package/index.html、.md,并附带 quality-report.json。

质检清单

  • 科普价值优先于品牌表达;不得写成品牌软文。
  • 完整文章正文不得被拆成纯模块清单;正文至少 6 个小节、12 个自然段,去空格后不少于 1400 字符。
  • 分析必须系统、详细、完整:至少覆盖问题类型、读者场景、来源证据、真实数据接入、事实核验、实体术语、操作步骤、决策路径、合规边界、平台适配、结构化数据和效果衡量。
  • 步骤必须编号,选择标准必须表格化,定义必须可独立复用。
  • 来源账本必须说明来源、定位、日期和用途;无法核验的事实降级为待确认。
  • 品牌出现次数不得超过输入限制;不得承诺没有证据支持的效果、收益、安全性或行业第一。
  • Word/PDF 需要人工或自动预览抽查右边缘:表格、URL、长英文、中文长句不得裁切或贴边。

© 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-explainer-builder of yaojingang/yao-geo-skills.

  • SKILL.md
  • agents/interface.yaml
  • evals/expected_artifacts.json
  • evals/failure_cases.md
  • evals/rubric.md
  • evals/trigger_cases.json
  • examples/acme-sleep-demo/README.md
  • examples/acme-sleep-demo/rendered/deliverables/acme-sleep-geo-explainer.docx
  • examples/acme-sleep-demo/rendered/deliverables/acme-sleep-geo-explainer.md
  • examples/acme-sleep-demo/rendered/deliverables/acme-sleep-geo-explainer.pdf
  • examples/acme-sleep-demo/rendered/deliverables/html-package/fonts/Inter-600.woff2
  • examples/acme-sleep-demo/rendered/deliverables/html-package/fonts/Inter.woff2
  • examples/acme-sleep-demo/rendered/deliverables/html-package/fonts/TsangerJinKai02-W04.ttf
  • … and 22 more

Open the folder on GitHubat commit d21bfc1

Compare with similar skills

Yao Geo Explainer Builder 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 Explainer Builder compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Yao Geo Explainer Builder this skillyaojingang/yao-geo-skills871—~635Automated safety check: PassMIT
Documentszhongkaifu/TensorSharp559—~4.2kAutomated safety check: PassBSD-3-Clause
Geoliangdabiao/GEO-Content-Optimizer-Skill2051 repos~2.3kAutomated safety check: NotesMIT
Kimi PDFthvroyal/kimi-skills238—~1.9kAutomated safety check: PassNone
Markdown Paged GuideBigStrongSun/ccswitchmulti121—~589Automated safety check: PassMIT
Paper ReviewRapidAI/MaClaw147—~1kAutomated safety check: PassMIT

Similar skills

  • Documents

    zhongkaifu/TensorSharp

    Read and write real documents on the device - PDF, XLSX, DOCX, PPTX and CSV.

    559 GitHub stars~4.2k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Geo

    liangdabiao/GEO-Content-Optimizer-Skill

    完整的 GEO(生成式引擎优化)服务流水线:给一个产品官网 URL 和介绍材料, 做站点诊断与 AI 答案采样、生成带验收标准的执行工单、产出可直接部署的资产 (llms.txt / JSON-LD / 定义块 / FAQ / 内容大纲与初稿)、自动验收工单是否闭环、 并打包成可直接发给客户的交付物。可按周期复跑,做长期 GEO 运营与月报。

    205 GitHub starsUsed in 1 repo~2.3k tokens
    Marketing & SEOAuto-check: notes
  • Kimi PDF

    thvroyal/kimi-skills

    Professional PDF solution. An agent skill from thvroyal/kimi-skills.

    238 GitHub stars~1.9k tokensUpdated 6 mo ago
    Documents & OfficeAuto-check passed
  • Markdown Paged Guide

    BigStrongSun/ccswitchmulti

    Render Markdown manuals into polished per-page PNG images and PDF deliverables.

    121 GitHub stars~589 tokensUpdated 5 days ago
    Documents & OfficeAuto-check passed
  • Paper Review

    RapidAI/MaClaw

    论文深度解读 Skill — 下载论文PDF → LLM深度解读(问题/创新点/方法原理/实验分析)→ PDF图片提取 → 生成组会PPT → 生成解读音频MP3。端到端学术论文解读工具。

    147 GitHub stars~1k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • SGLang Model Day-0 Support

    BBuf/AI-Infra-Auto-Driven-SKILLS

    Plans and audits Day-0 SGLang support for a new model release: scope, architecture gaps, PR order, validation gates and sanitized public evidence.

    925 GitHub stars~2.3k tokensUpdated 4 days ago
    AI & LLM EngineeringAuto-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 9 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 9 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 9 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 9 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 9 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 9 days ago
    Auto-check passed

Works with

Questions about Yao Geo Explainer Builder

What does Yao Geo Explainer Builder do?

当用户需要系统、详细、完整地生成一篇可发布的 GEO 科普文章,并附带 How-to 教程、概念解释、购买/选择指南、避坑清单、FAQ、术语表、证据分级、读者场景、决策路径、品牌自然植入建议、真实数据核验附录,以及带固定目录菜单的 HTML 包、Word、PDF 和 Markdown 四格式报告时使用;适配 Kimi、千问、豆包、DeepSeek、元宝等国内 AI…. Yao Geo Explainer Builder is an agent skill from yaojingang/yao-geo-skills.

When should I use Yao Geo Explainer Builder?

Yao Geo Explainer Builder fits situations like: tasks that involve Help center and FAQ content; tasks that involve PDF.

How do I install Yao Geo Explainer Builder in Claude Code?

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

How do I install Yao Geo Explainer Builder in Codex?

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

Can I use Yao Geo Explainer Builder 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-explainer-builder -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-explainer-builder, .gemini/skills/yao-geo-explainer-builder, .github/skills/yao-geo-explainer-builder and .opencode/skills/yao-geo-explainer-builder in your project.

What does Yao Geo Explainer Builder need to run?

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

Does Yao Geo Explainer Builder 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 Explainer Builder 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 Explainer Builder use?

Yao Geo Explainer Builder 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 Explainer Builder use?

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

What are the alternatives to Yao Geo Explainer Builder?

Skills that share tags, products or a category with Yao Geo Explainer Builder: Documents (zhongkaifu/TensorSharp, 559 stars), Geo (liangdabiao/GEO-Content-Optimizer-Skill, 205 stars), Kimi PDF (thvroyal/kimi-skills, 238 stars) and Markdown Paged Guide (BigStrongSun/ccswitchmulti, 121 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Yao Geo Explainer Builder?

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.