Agent skill

Yao Geo Article Friendly

by yaojingang in yaojingang/yao-geo-skills

Optimize an existing article or local article file into a GEO and AI-search-friendly rewrite with source-bound evidence, structure, semantic density, scoring, and change notes.

MITAuto-check passedResearch & Science

Install Yao Geo Article Friendly

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

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

GitHub CLI
$ gh skill install yaojingang/yao-geo-skills yao-geo-article-friendly --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-article-friendly .claude/skills/yao-geo-article-friendly && 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-article-friendly
GitHub stars
871
Token cost
~719 tokens
SKILL.md length
304 words
Files
12 (incl. references)
Skills in repo
24
Repo updated
First seen
Licence
MIT

At a glance

Optimize an existing article or local article file into a GEO and AI-search-friendly rewrite with source-bound evidence, structure, semantic density, scoring, and change notes.

  • Works in 7 steps: Resolve input and preserve the original… → Inventory core claims, evidence, data,… → Score the original against the weighted… → …
  • Article rewriting and citation-readiness improvement
  • SKILL.md covers Use, Required Reading, Workflow and Evidence Discipline, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Yao Geo Article Friendly is an agent skill from yaojingang/yao-geo-skills. Optimize an existing article or local article file into a GEO and AI-search-friendly rewrite with source-bound evidence, structure, semantic density, scoring, and change notes. Use for article rewriting and citation-readiness improvement; do not use for new articles, invented citations/data, compliance audits, ranking guarantees, or generic GEO strategy.

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

It sits in Research & Science, covering Citation management. 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

  • Article rewriting and citation-readiness improvement
  • Do not use for new articles
  • Invented citations/data
  • Compliance audits

Example prompts

  • “/yao-geo-article-friendly”

Workflow steps

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

  1. Resolve input and preserve the original title, claims, facts, examples, and tone. Default to standard depth.
  2. Inventory core claims, evidence, data, quotes, cases, structure, entities, terms, and reusable passages.
  3. Score the original against the weighted GEO dimensions plus risk control; be conservative when sources, data口径, or quotes are missing.
  4. Rewrite by priority: evidence, structure, fluency, semantic density, authority signals, terminology, robustness, cross-domain links, and…
  5. Mark unsupported enhancements as [建议补充...]; state facts only when original-supported or verified.
  6. Return the optimized article, score report, change notes, supplement list, and risk notes.
  7. Verify original meaning, no fabrication, high-weight improvements, and natural readability.

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

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    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 Article Friendly loads about 719 tokens when it runs, and up to ~2.5k if it reads all its reference files. Until then it costs about 95 tokens; SKILL.md has 304 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from yaojingang/yao-geo-skills at commit d21bfc1, republished under its MIT licence (© yaojingang). 304 words, ~719 tokens.

Download SKILL.mdSave it as .claude/skills/yao-geo-article-friendly/SKILL.md (or your agent's skills folder). This skill also uses 11 other files; get the full folder from GitHub.
name
yao-geo-article-friendly
description
Optimize an existing article or local article file into a GEO and AI-search-friendly rewrite with source-bound evidence, structure, semantic density, scoring, and change notes. Use for article rewriting and citation-readiness improvement; do not use for new articles, invented citations/data, compliance audits, ranking guarantees, or generic GEO strategy.
metadata.author
Yao Team
metadata.maturity
scaffold

Yao GEO Article Friendly

Use

Use when the user provides pasted article text or a local path and wants a GEO/AI 搜索友好化改造 with evidence, structure, readability, and before/after scoring.

Accepted inputs: pasted text, .md, .txt, .html, .htm, .docx, and .pdf when local extraction is available. If the article cannot be read, return a blocker and ask for pasted text.

Do not use for topic-only drafting, legal/compliance judgments, ranking promises, competitor attacks, takedown work, or unsupported statistics, sources, quotes, cases, or claims.

Required Reading

  • references/geo-article-transformation-method.md: weighted method, evidence rules, and validation.
  • references/geo-output-contract.md: final Markdown structure, scoring, and change-note templates.

Workflow

  1. Resolve input and preserve the original title, claims, facts, examples, and tone. Default to standard depth.
  2. Inventory core claims, evidence, data, quotes, cases, structure, entities, terms, and reusable passages.
  3. Score the original against the weighted GEO dimensions plus risk control; be conservative when sources, data口径, or quotes are missing.
  4. Rewrite by priority: evidence, structure, fluency, semantic density, authority signals, terminology, robustness, cross-domain links, and readability.
  5. Mark unsupported enhancements as [建议补充...]; state facts only when original-supported or verified.
  6. Return the optimized article, score report, change notes, supplement list, and risk notes.
  7. Verify original meaning, no fabrication, high-weight improvements, and natural readability.

Evidence Discipline

Use 原文支持, 外部已核验, and 建议补充 labels when provenance matters.

If current laws, platform rules, market data, rankings, product facts, or recent research are needed, verify them with current primary or authoritative sources before insertion. When verification is not possible, keep the claim as 建议补充.

Output Contract

Default artifact: one structured Markdown response containing:

  1. 改造后的完整文章
  2. GEO优化度评分
  3. 改造执行说明
  4. 需要用户补充或确认的内容
  5. 改造风险提示

If the user asks for a file, save the Markdown artifact and return the absolute path.

Reference Map

  • references/geo-article-transformation-method.md: method and scoring basis.
  • references/geo-output-contract.md: output templates.
  • reports/: prompt-quality, output-risk, artifact-design, and reference scan.

© 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 11 other files (references) in skills/yao-geo-article-friendly of yaojingang/yao-geo-skills.

  • SKILL.md
  • agents/interface.yaml
  • evals/expected_artifacts.json
  • evals/trigger_cases.json
  • manifest.json
  • references/geo-article-transformation-method.md
  • references/geo-output-contract.md
  • reports/artifact-design-profile.md
  • reports/output-risk-profile.md
  • reports/prompt-quality-profile.md
  • reports/reference-scan.md
  • templates/brief-template.md

Open the folder on GitHubat commit d21bfc1

Compare with similar skills

Yao Geo Article Friendly 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 Article Friendly compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Yao Geo Article Friendly this skillyaojingang/yao-geo-skills871—~719Automated safety check: PassMIT
Content Research Writerweapp-tailwindcss/weapp-tailwindcss1.9k25 repos~3.5kAutomated safety check: PassMIT
Systematic Review ScreenerImbad0202/academic-research-skills51k—~8.4kAutomated safety check: PassCustom licence
NetworkxzLanqing/codex-claude-academic-skills4.7k15 repos~3.2kAutomated safety check: PassBSD-3-Clause
Literature Reviewneflibata-feng/MyArxiv-Agent12620 repos~5.9kAutomated safety check: NotesMIT
Openalex Databaseneflibata-feng/MyArxiv-Agent12612 repos~3kAutomated safety check: PassCustom licence

Similar skills

  • Content Research Writer

    weapp-tailwindcss/weapp-tailwindcss

    Assists in writing high-quality content by conducting research, adding citations, improving hooks, iterating on outlines, and providing real-time feedback on each section.

    1.9k GitHub starsUsed in 25 repos~3.5k tokens
    Research & ScienceAuto-check passed
  • Systematic Review Screener

    Imbad0202/academic-research-skills

    Screens records for systematic, scoping and rapid reviews against fixed eligibility rules, using two blinded AI reviewers and a third adjudicator, with traceable PRISMA counts.

    51k GitHub stars~8.4k tokensUpdated 2 days ago
    Research & ScienceAuto-check passed
  • Networkx

    zLanqing/codex-claude-academic-skills

    Comprehensive toolkit for creating, analyzing, and visualizing complex networks and graphs in Python.

    4.7k GitHub starsUsed in 15 repos~3.2k tokens
    Research & ScienceAuto-check passed
  • Literature Review

    neflibata-feng/MyArxiv-Agent

    Conduct comprehensive, systematic literature reviews using multiple academic databases (PubMed, arXiv, bioRxiv, Semantic Scholar, etc.).

    126 GitHub starsUsed in 20 repos~5.9k tokens
    Research & ScienceAuto-check: notes
  • Openalex Database

    neflibata-feng/MyArxiv-Agent

    Query and analyze scholarly literature using the OpenAlex database.

    126 GitHub starsUsed in 12 repos~3k tokens
    Research & ScienceAuto-check passed
  • Citation Verification Guide

    Galaxy-Dawn/claude-scholar

    Reference guidance for checking every citation in academic writing against canonical sources such as DOI, arXiv, CrossRef and Semantic Scholar, to catch fake or wrong references.

    5.7k GitHub starsUsed in 2 repos~1.9k tokens
    Research & ScienceAuto-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 Article Friendly

What does Yao Geo Article Friendly do?

Optimize an existing article or local article file into a GEO and AI-search-friendly rewrite with source-bound evidence, structure, semantic density, scoring, and change notes. Yao Geo Article Friendly is an agent skill from yaojingang/yao-geo-skills. Optimize an existing article or local article file into a GEO and AI-search-friendly rewrite with source-bound evidence, structure, semantic density, scoring, and change notes.

When should I use Yao Geo Article Friendly?

Yao Geo Article Friendly fits situations like: article rewriting and citation-readiness improvement; do not use for new articles; invented citations/data; compliance audits.

How do I install Yao Geo Article Friendly in Claude Code?

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

How do I install Yao Geo Article Friendly in Codex?

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

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

What does Yao Geo Article Friendly need to run?

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

Does Yao Geo Article Friendly access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Yao Geo Article Friendly 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. Review the folder before installing.

What licence does Yao Geo Article Friendly use?

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

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

What are the alternatives to Yao Geo Article Friendly?

Skills that share tags, products or a category with Yao Geo Article Friendly: Content Research Writer (weapp-tailwindcss/weapp-tailwindcss, 1.9k stars), Systematic Review Screener (Imbad0202/academic-research-skills, 51k stars), Networkx (zLanqing/codex-claude-academic-skills, 4.7k stars) and Literature Review (neflibata-feng/MyArxiv-Agent, 126 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Yao Geo Article Friendly?

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.