Agent skill

Yao Geo Ranking Article Builder

by yaojingang in yaojingang/yao-geo-skills

当用户需要基于品牌 Brief、选题配置、关键词、竞品库和可信来源生成 GEO 榜单评测文章、best/top/alternatives/vs/persona/use-case 意图内容、评选方法、核心对比表、榜单正文、适合人群、FAQ、来源表和 Word/PDF/HTML/Markdown 四格式文章包时使用;适配…

MITAuto-check passedDocuments & Office

Install Yao Geo Ranking Article Builder

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

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

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

At a glance

当用户需要基于品牌 Brief、选题配置、关键词、竞品库和可信来源生成 GEO 榜单评测文章、best/top/alternatives/vs/persona/use-case 意图内容、评选方法、核心对比表、榜单正文、适合人群、FAQ、来源表和 Word/PDF/HTML/Markdown 四格式文章包时使用;适配…

  • Works in 12 steps: 输入核验:核验品牌、官网、产品、类目、区域、语言、合规说明、竞品范围和核验日期;缺… → 数据可用性分层:把来源分为公开可采集、用户提供、需登录/付费、不可访问四类;不可访… → 来源可达审计:可使用 scripts/audit_sources.py 检查… → …
  • Tasks that involve Help center and FAQ content
  • SKILL.md covers 使用边界, 执行流程, 方法依据 and 国内平台适配, plus 1 more section
  • Tasks that involve AI search optimization

What it does

Yao Geo Ranking Article Builder is an agent skill from yaojingang/yao-geo-skills. 当用户需要基于品牌 Brief、选题配置、关键词、竞品库和可信来源生成 GEO 榜单评测文章、best/top/alternatives/vs/persona/use-case 意图内容、评选方法、核心对比表、榜单正文、适合人群、FAQ、来源表和 Word/PDF/HTML/Markdown 四格式文章包时使用;适配 DeepSeek、豆包、千问、Kimi、元宝;不用于全景诊断、后台归因、单页审计、纯标题生成或无证据软文排行。

Its SKILL.md is about 680 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/quality_cases.json`).

It sits in Documents & Office, covering Help center and FAQ content, AI search optimization 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 AI search optimization
  • Tasks that involve PDF

Example prompts

  • “/yao-geo-ranking-article-builder”

Workflow steps

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

  1. 输入核验:核验品牌、官网、产品、类目、区域、语言、合规说明、竞品范围和核验日期;缺少关键事实时停止。
  2. 数据可用性分层:把来源分为公开可采集、用户提供、需登录/付费、不可访问四类;不可访问数据不写成确定事实。
  3. 来源可达审计:可使用 scripts/audit_sources.py 检查 Markdown 中的 URL 是否可访问,生成来源可用性 JSON 供自检使用。
  4. 参考自检:先检查是否需要补充更权威或更完整的参考,优先官方页面、监管/标准文件、学术论文、行业研究和第三方评价,再使用品牌自述。
  5. 分析完整性地图:生成主题边界、用户意图、选择标准、证据类型、限制条件、国内 AI 平台适配和结构化数据机会,作为生产依据,默认放入文末附录或交付包,不抢占文章开头。
  6. 关键词地图:覆盖 best、top、alternatives、vs、人群、场景、痛点、价格、集成、迁移和风险类意图。
  7. 真实竞品筛选:选择真实同类竞品,优先 5 个资料充分的竞品;证据不足的竞品不硬选、不改名、不凑数。
  8. 评选方法设计:使用 4 到 6 个行业通用维度,补充 1 到 2 个有证据支撑的差异化维度;明确权重、评分依据和不确定性。
  9. 文章优先生成:先生成一篇完整可发布的 GEO 榜单文章,文章主体必须包含导语、直接结论、为什么现在看、评选方法、核心榜单、对比表、榜单正文、场景选择、采购风险、FAQ 和…
  10. 证据链审查:价格、功能、集成、融资、客户、案例、奖项、认证、评分和资质必须可追溯;无法核验则降级为“公开信息未确认”或移除。
  11. 榜单梯度控制:目标品牌只能通过证据、细节和适用场景体现优势;TOP1 必须有多源证据支持,不能靠品牌资料自述。
  12. 四格式渲染与复核:使用 scripts/render_ranking_article_pack.py 生成 Markdown、HTML、PDF、Word,并检查文件存在、白底排版、HTML 固定菜单、PDF A4、Word 表格不向右溢出。

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 Ranking Article Builder loads about 681 tokens when it runs, and up to ~4.9k if it reads all its reference files. Until then it costs about 62 tokens; SKILL.md has 122 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
~681
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.9k

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). 122 words, ~681 tokens.

Download SKILL.mdSave it as .claude/skills/yao-geo-ranking-article-builder/SKILL.md (or your agent's skills folder). This skill also uses 35 other files; get the full folder from GitHub.
name
yao-geo-ranking-article-builder
description
当用户需要基于品牌 Brief、选题配置、关键词、竞品库和可信来源生成 GEO 榜单评测文章、best/top/alternatives/vs/persona/use-case 意图内容、评选方法、核心对比表、榜单正文、适合人群、FAQ、来源表和 Word/PDF/HTML/Markdown 四格式文章包时使用;适配 DeepSeek、豆包、千问、Kimi、元宝;不用于全景诊断、后台归因、单页审计、纯标题生成或无证据软文排行。
<!--
Copyright © 2026 姚金刚. All rights reserved.
Project: yao-geo-ranking-article-builder
Created by: 姚金刚
Date: 2026-05-16
X: https://x.com/yaojingang
-->

Yao GEO Ranking Article Builder

使用边界

用于把品牌 Brief、选题配置、关键词、竞品库、行业资料和可信来源转成可追溯的 GEO 榜单评测文章,并输出 Markdown、HTML、PDF、Word 四格式文章包。适合 CRM、SaaS、消费品、教育、医疗健康、B2B 服务等需要“best/top/alternatives/vs/persona/use-case”内容的生产场景。

支持真实公开数据采集与可用性审计:可使用官网、产品页、定价页、帮助中心、公开 PDF、行业报告、第三方评价页和用户提供资料;不能绕过登录、付费墙、反爬限制或私有系统权限。

不要用于全景 GEO 诊断、单页技术审计、纯标题生成、无来源软文、没有明确品牌和类目的排行。无法确认品牌、官网、类目、区域或关键证据时,先停止正文输出并列出阻塞点。

执行流程

  1. 输入核验:核验品牌、官网、产品、类目、区域、语言、合规说明、竞品范围和核验日期;缺少关键事实时停止。
  2. 数据可用性分层:把来源分为公开可采集、用户提供、需登录/付费、不可访问四类;不可访问数据不写成确定事实。
  3. 来源可达审计:可使用 scripts/audit_sources.py 检查 Markdown 中的 URL 是否可访问,生成来源可用性 JSON 供自检使用。
  4. 参考自检:先检查是否需要补充更权威或更完整的参考,优先官方页面、监管/标准文件、学术论文、行业研究和第三方评价,再使用品牌自述。
  5. 分析完整性地图:生成主题边界、用户意图、选择标准、证据类型、限制条件、国内 AI 平台适配和结构化数据机会,作为生产依据,默认放入文末附录或交付包,不抢占文章开头。
  6. 关键词地图:覆盖 best、top、alternatives、vs、人群、场景、痛点、价格、集成、迁移和风险类意图。
  7. 真实竞品筛选:选择真实同类竞品,优先 5 个资料充分的竞品;证据不足的竞品不硬选、不改名、不凑数。
  8. 评选方法设计:使用 4 到 6 个行业通用维度,补充 1 到 2 个有证据支撑的差异化维度;明确权重、评分依据和不确定性。
  9. 文章优先生成:先生成一篇完整可发布的 GEO 榜单文章,文章主体必须包含导语、直接结论、为什么现在看、评选方法、核心榜单、对比表、榜单正文、场景选择、采购风险、FAQ 和 Sources;核验摘要、真实数据获取与可用性、分析完整性地图、关键词地图、平台适配、结构化数据建议和自检记录默认放到文末附录或文章包辅助文件。
  10. 证据链审查:价格、功能、集成、融资、客户、案例、奖项、认证、评分和资质必须可追溯;无法核验则降级为“公开信息未确认”或移除。
  11. 榜单梯度控制:目标品牌只能通过证据、细节和适用场景体现优势;TOP1 必须有多源证据支持,不能靠品牌资料自述。
  12. 四格式渲染与复核:使用 scripts/render_ranking_article_pack.py 生成 Markdown、HTML、PDF、Word,并检查文件存在、白底排版、HTML 固定菜单、PDF A4、Word 表格不向右溢出。

方法依据

采用 GEO-RANK-SC 方法:Generative Engine Optimization、Retrieval-Augmented evidence、Ordered comparison、Ranking gradient、Knowledge-source traceability、Systematic completeness、Cross-platform readability。

关键依据放在 references/research-foundation.md,执行时要把这些依据转成可执行约束:可回答、可引用、可追溯、可比较、可解释、可复核,而不是堆砌概念。

国内平台适配

  • DeepSeek:评选逻辑、维度定义、权重、因果链和边界条件。
  • 豆包:先给直接答案,再给场景选择建议和易懂解释。
  • 千问:来源编号、事实与推论分离、核验日期和价格口径。
  • Kimi:长文结构、多源证据、完整章节和限制说明。
  • 元宝:公众号可读性、段落节奏、中文场景化表达和腾讯生态信源优先级。

输出门禁

  • 四格式报告必须真实存在、非空,并来自同一 Markdown 母版。
  • HTML 必须白底、可阅读、表格不溢出,并包含下拉时固定跟随的目录菜单:.report-nav { position: sticky; top: 0; };视觉系统参考 kami 的油墨蓝、暖灰、serif 标题和紧凑编辑节奏。
  • PDF 必须由同一 HTML 生成,A4 页面、稳定行高、表格边框合并,右边缘无文字或表格裁切。
  • Word 必须有标题层级、显式表格边框、A4 页边距、固定表格布局和动态列宽;长 URL、英文产品名、域名和参数不允许向右溢出。
  • 正文不能暴露后台词或实现细节,例如内部资料、Prompt、字段、执行链路、脚本、私有配置。
  • 不虚构竞品,不修改竞品名称,不把目标品牌硬排第一,不使用无来源数据、奖项、客户或价格。
  • 示例报告必须首先像一篇完整文章,而不是模块清单;生产过程模块只能作为附录、证据表或交付包说明。

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

  • SKILL.md
  • agents/interface.yaml
  • evals/expected_artifacts.json
  • evals/quality_cases.json
  • evals/trigger_cases.json
  • examples/hubspot-demo/hubspot-crm-ranking-article.docx
  • examples/hubspot-demo/hubspot-crm-ranking-article.html
  • examples/hubspot-demo/hubspot-crm-ranking-article.md
  • examples/hubspot-demo/hubspot-crm-ranking-article.pdf
  • examples/hubspot-demo/index.html
  • examples/hubspot-demo/report_input.json
  • examples/hubspot-demo/review-notes.md
  • examples/hubspot-demo/source-article.md
  • examples/hubspot-demo/source-audit.json
  • examples/synthetic-demo/demo-geo-ranking-article.docx
  • examples/synthetic-demo/demo-geo-ranking-article.html
  • … and 20 more

Open the folder on GitHubat commit d21bfc1

Compare with similar skills

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

Similar skills

  • 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
  • Documents

    zhongkaifu/TensorSharp

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

    568 GitHub stars~4.2k tokensUpdated today
    Documents & OfficeAuto-check passed
  • 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 6 days ago
    Documents & OfficeAuto-check passed
  • Paper Review

    RapidAI/MaClaw

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

    148 GitHub stars~1k tokensUpdated today
    Documents & OfficeAuto-check passed
  • GEO-Claw AI Visibility Agent

    LeoYeAI/openclaw-master-skills

    Runs a brand's AI-search visibility work end to end: diagnosing how AI platforms represent it, repositioning it, producing AI-optimized content and monitoring ongoing mentions.

    2.2k GitHub stars~4.7k tokensUpdated 2 mo ago
    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

Works with

Questions about Yao Geo Ranking Article Builder

What does Yao Geo Ranking Article Builder do?

当用户需要基于品牌 Brief、选题配置、关键词、竞品库和可信来源生成 GEO 榜单评测文章、best/top/alternatives/vs/persona/use-case 意图内容、评选方法、核心对比表、榜单正文、适合人群、FAQ、来源表和 Word/PDF/HTML/Markdown 四格式文章包时使用;适配…. Yao Geo Ranking Article Builder is an agent skill from yaojingang/yao-geo-skills.

When should I use Yao Geo Ranking Article Builder?

Yao Geo Ranking Article Builder fits situations like: tasks that involve Help center and FAQ content; tasks that involve AI search optimization; tasks that involve PDF.

How do I install Yao Geo Ranking Article Builder in Claude Code?

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

How do I install Yao Geo Ranking Article Builder in Codex?

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

Can I use Yao Geo Ranking Article 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-ranking-article-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-ranking-article-builder, .gemini/skills/yao-geo-ranking-article-builder, .github/skills/yao-geo-ranking-article-builder and .opencode/skills/yao-geo-ranking-article-builder in your project.

What does Yao Geo Ranking Article Builder need to run?

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

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

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

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

What are the alternatives to Yao Geo Ranking Article Builder?

Skills that share tags, products or a category with Yao Geo Ranking Article Builder: Geo (liangdabiao/GEO-Content-Optimizer-Skill, 205 stars), Documents (zhongkaifu/TensorSharp, 568 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 Ranking Article 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.