Agent skill

Qiaomu SEO

by joeseesun in joeseesun/qiaomu-seo

Audit, diagnose, research, plan, implement, experiment on, and verify website SEO across Google, Bing, and AI-search surfaces.

MITAuto-check passedMarketing & SEO

Install Qiaomu SEO

skills CLI
$ npx skills add joeseesun/qiaomu-seo --skill qiaomu-seo -a claude-code

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

GitHub CLI
$ gh skill install joeseesun/qiaomu-seo qiaomu-seo --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
qiaomu-seo
GitHub stars
441
Token cost
~2.6k tokens
SKILL.md length
1,105 words
Files
45 (incl. scripts, references, assets)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Audit, diagnose, research, plan, implement, experiment on, and verify website SEO across Google, Bing, and AI-search surfaces.

  • Works in 10 steps: Define outcome, conversion, audience,… → Choose work mode and evidence modes:… → Establish the target inventory and… → …
  • Rendering and indexing
  • SKILL.md covers Router Rules, Action Boundary, Work Modes and Compact Workflow, plus 5 more sections
  • Calls python3

What it does

Qiaomu SEO is an agent skill from joeseesun/qiaomu-seo. Audit, diagnose, research, plan, implement, experiment on, and verify website SEO across Google, Bing, and AI-search surfaces. Use for technical SEO, crawling, rendering and indexing, JavaScript SEO, robots.txt, sitemaps, canonicals, redirects, status codes, metadata, internal linking, structured data, Core Web Vitals, keyword and intent research, content quality or pruning, SEO experiment design, traffic drops, migrations, international SEO and hreflang, ecommerce and product SEO, image or video search…

Its SKILL.md is about 2.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 51 other files, including scripts, reference files and assets (for example `README.md`, `agents/interface.yaml` and `data/seo-source-registry.json`).

It sits in Marketing & SEO, covering Technical SEO and AI search optimization. It works with OpenAI, Perplexity, JavaScript and Google Search Console. The repository describes itself as: Audit, diagnose, research, plan, implement, experiment on, and verify website SEO across Google, Bing, and AI-search surfaces. Use for technical SEO,. The licence is MIT.

When your agent uses it

  • Rendering and indexing
  • Internal linking
  • Structured data
  • Core Web Vitals

Example prompts

  • “/qiaomu-seo”

Requirements

  • Python 3

Workflow steps

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

  1. Define outcome, conversion, audience, market/language, search surface, engine/provider, target pages, time window, and authorized action.
  2. Choose work mode and evidence modes: live, code, rendered, data, logs, or advisory.
  3. Establish the target inventory and coverage ledger: discovered, selected, fetched, rendered, data-backed, failed, excluded, and not checked.
  4. Classify required knowledge before using it
  5. For current platform rules, consult data/seo-source-registry.json. Re-open volatile or overdue official sources; record conflicting…
  6. Evaluate in dependency order: access → discovery → fetch/render → index eligibility → canonical/alternate signals → technical delivery →…
  7. Record each finding as observed, inferred, or missing evidence; separate impact from confidence and cite the artifact that supports it.
  8. Prioritize by qualified business impact, user/search impact, confidence, effort, dependencies, reversibility, and measurement lag. Avoid…
  9. If implementation is authorized, capture a before snapshot, make the smallest safe change, run repository and runtime checks, and preserve…
  10. Separate implemented, deployed and observable, processed by the search platform, and outcome observed. Preserve rerun inputs and a dated…

What it can do on your machine

Read from SKILL.md and the folder at commit b892b70. 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.

    Shell commands in SKILL.md call:

    • python3

    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
    • github.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

Qiaomu SEO loads about 2.6k tokens when it runs, and up to ~14k if it reads all its reference files. Until then it costs about 246 tokens; SKILL.md has 1,105 words of instructions outside code blocks.

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

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 joeseesun/qiaomu-seo at commit b892b70, republished under its MIT licence (© joeseesun). 1,105 words, ~2,619 tokens.

Download SKILL.mdSave it as .claude/skills/qiaomu-seo/SKILL.md (or your agent's skills folder). This skill also uses 44 other files; get the full folder from GitHub.
name
qiaomu-seo
description
Audit, diagnose, research, plan, implement, experiment on, and verify website SEO across Google, Bing, and AI-search surfaces. Use for technical SEO, crawling, rendering and indexing, JavaScript SEO, robots.txt, sitemaps, canonicals, redirects, status codes, metadata, internal linking, structured data, Core Web Vitals, keyword and intent research, content quality or pruning, SEO experiment design, traffic drops, migrations, international SEO and hreflang, ecommerce and product SEO, image or video search, large-site and programmatic SEO, IndexNow, Search Console or Webmaster Tools analysis, and AI Overviews, AI Mode, ChatGPT Search, Copilot, or Perplexity visibility. Use with URLs, website code, rendered pages, server logs, crawl files, first-party exports, and keyword datasets. Exclude paid-search campaign management, app-store optimization, generic LLM prompt optimization, ranking or citation guarantees, link spam, and unsupported metrics or causal claims.

Qiaomu SEO

Improve discoverability and qualified organic outcomes with current sources, explicit coverage, and reproducible evidence.

Router Rules

  • Use for organic website search work: audit, strategy, research, implementation, migration, monitoring, and experimentation.
  • Route paid media and bidding to advertising workflows; route app-store listings to ASO; route pure conversion optimization elsewhere unless organic acquisition is also in scope.
  • Treat Google, Bing, AI search, image, video, shopping, local, and news as distinct surfaces. Never generalize a feature, crawler, report, or policy across providers.
  • Read only the task-relevant modules:

Action Boundary

  • audit / diagnose / compare / advise: inspect and report; do not edit code, content, webmaster settings, feeds, DNS, or production.
  • optimize / fix / implement: change only files or systems the user placed in scope; capture before evidence and verify afterward.
  • Never submit URLs, change index controls, publish, delete pages, disavow links, alter Merchant Center or Business Profile, buy data, or contact third parties without explicit authorization.

Work Modes

  • advisory: no target evidence; give a plan without site-specific claims.
  • page: inspect one or a small named URL set deeply.
  • template sample: inspect representative templates and disclose selection; never call it a full-site audit.
  • site inventory: use crawl, sitemap, route, log, or first-party inventories to measure breadth.
  • incident: diagnose a traffic/indexing loss using segmented timelines and competing hypotheses.
  • migration: protect URL mappings, redirects, canonicals, hreflang, sitemaps, feeds, monitoring, and rollback.
  • experiment: define hypothesis, treatment unit, comparison, guardrails, observation window, and decision rule.
  • specialty: evaluate international, ecommerce, image, video, local, news, or AI-search requirements only when relevant.

Compact Workflow

  1. Define outcome, conversion, audience, market/language, search surface, engine/provider, target pages, time window, and authorized action.
  2. Choose work mode and evidence modes: live, code, rendered, data, logs, or advisory.
  3. Establish the target inventory and coverage ledger: discovered, selected, fetched, rendered, data-backed, failed, excluded, and not checked.
  4. Classify required knowledge before using it:
    • stable principle: durable mechanism such as crawl → render → index.
    • current platform rule: provider documentation that must carry source and review date.
    • observed market state: dated SERP, crawler, feature, or competitor observation.
    • hypothesis: testable explanation, not a finding.
  5. For current platform rules, consult data/seo-source-registry.json. Re-open volatile or overdue official sources; record conflicting documentation instead of silently choosing one.
  6. Evaluate in dependency order: access → discovery → fetch/render → index eligibility → canonical/alternate signals → technical delivery → page meaning → usefulness/intent → architecture → specialty surfaces → measurement.
  7. Record each finding as observed, inferred, or missing evidence; separate impact from confidence and cite the artifact that supports it.
  8. Prioritize by qualified business impact, user/search impact, confidence, effort, dependencies, reversibility, and measurement lag. Avoid universal SEO scores.
  9. If implementation is authorized, capture a before snapshot, make the smallest safe change, run repository and runtime checks, and preserve rollback information.
  10. Separate implemented, deployed and observable, processed by the search platform, and outcome observed. Preserve rerun inputs and a dated monitoring plan.

Non-Negotiable Evidence Rules

  • Never invent search volume, difficulty, traffic, rankings, backlinks, conversion, competitor, crawl, or index metrics. Use unknown when evidence is absent.
  • Never guarantee crawling, indexing, ranking, rich results, AI citations, traffic, or revenue.
  • Do not turn title length, description length, H1 count, word count, keyword density, reading level, link count, or keyword position into universal ranking pass/fail rules.
  • Keep controls distinct: robots.txt governs crawler access; robots meta/X-Robots-Tag governs supported index/presentation behavior; canonical is a preference signal; sitemap and IndexNow are discovery/change notifications. None guarantees indexing.
  • Keep validators distinct: valid Schema.org syntax does not prove eligibility for a Google search feature; feature eligibility does not guarantee appearance.
  • Keep performance evidence distinct: lab tools diagnose a controlled run; field Core Web Vitals describe real-user distributions. Do not substitute one for the other.
  • Keep data scope visible: Search Console tables/APIs may omit anonymized queries or lower-volume rows; aggregates, filtered tables, page/query dimensions, and search types are not interchangeable.
  • Static HTML and rendered DOM are separate artifacts. A crawler that renders JavaScript does not prove every engine, AI bot, or user-triggered agent does so identically.
  • Do not attribute a traffic change to an algorithm update, migration, content change, or technical issue from timing alone.
  • Reject cloaking, doorway pages, scaled low-value content, expired-domain abuse, fake reviews/mentions, link spam, hidden content, and destructive bulk pruning without page-level evidence.
Show full SKILL.md (338 more words)Show less

Current AI-Search Boundary

  • For Google generative Search, foundational SEO remains the base; Google documents no special AI schema, required AI text file, ideal AI chunk size, or need to rewrite content for AI.
  • As of 2026-08-03, Google's newer generative-AI guide documents a dedicated Search Console Generative AI performance report while AI-feature activity also contributes to Search performance. Verify property availability and current documentation before describing reporting.
  • For OpenAI, distinguish OAI-SearchBot (Search), GPTBot (potential model training), and user-triggered ChatGPT-User; their controls are not interchangeable.
  • Observe Perplexity, Microsoft, and other providers independently. One prompt, citation, crawler log, or referral is a sample—not a stable ranking report.

Gate Ladder

  • Advisory: scope, official sources, unknowns, and prioritized plan; no site-specific diagnosis.
  • Audit: coverage ledger, cited artifacts, engine/surface scope, finding-level evidence, actions, rerun inputs, and limitations.
  • Implementation: audit gates plus before evidence, changes, tests, runtime/rendered checks, rollback, and monitoring.
  • Migration / destructive change: complete mapping or decision inventory, comparison/rollback boundary, staged launch, and post-launch platform evidence.
  • Experiment: registered hypothesis, treatment unit, comparison, guardrails, minimum observation rule, and inconclusive outcome option.

Output Contract

Unless the user requests another format, provide:

  1. executive summary with the top three priorities
  2. outcome, scope, search surface, engine/provider, work mode, and evidence mode
  3. coverage ledger and source-freshness note
  4. findings: category, issue, status, evidence level/reference, impact, confidence, fix, effort, dependency, and verification
  5. quick wins, strategic work, experiments, and destructive actions separated
  6. keyword/page map, content brief, URL mapping, or specialty checklist only when relevant
  7. implementation record and four-stage outcome status when changes were made
  8. rerun inputs, monitoring window, decision rule, and rollback boundary
  9. missing evidence, conflicting sources, limitations, and next measurement step

For machine-readable audits, follow Audit Contract and validate with:

bash
python3 scripts/validate_audit.py path/to/audit.json

Before relying on mutable SEO knowledge or publishing an upgrade, validate the source registry:

bash
python3 scripts/validate_knowledge.py .

Qiaomu Defaults

  • Write concise Chinese unless the user requests another language.
  • Explain user and business consequences before specialist terminology.
  • Preserve URLs, dates, markets, devices, tools, versions, and evidence gaps for mutable claims.
  • Copyright (c) 向阳乔木
  • X: https://x.com/vista8
  • GitHub: https://github.com/joeseesun/

© joeseesun, 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 44 other files (scripts, references, assets) in the repository root of joeseesun/qiaomu-seo.

  • SKILL.md
  • .gitignore
  • LICENSE
  • README.md
  • agents/interface.yaml
  • assets/qiaomu-profile/qiaomu_avatar.jpeg
  • assets/qiaomu-profile/qiaomu_reward_qr.png
  • assets/qiaomu-profile/qiaomu_wechat_public_account_qr.jpg
  • data/seo-source-registry.json
  • evals/fixtures/audit-valid.json
  • evals/output_cases.json
  • evals/trigger_cases.json
  • manifest.json
  • references/ai-search.md
  • … and 31 more

Open the folder on GitHubat commit b892b70

Compare with similar skills

Qiaomu SEO 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.

Qiaomu SEO compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Qiaomu SEO this skilljoeseesun/qiaomu-seo441—~2.6kAutomated safety check: PassMIT
SEONexus-JPF/note-companion870—~2.2kAutomated safety check: PassMIT
GEO-First SEO Audit Toolzubair-trabzada/geo-seo-claude11k—~2.8kAutomated safety check: NotesMIT
SEOAgriciDaniel/seo-os1372 repos~3.5kAutomated safety check: PassMIT
Global SEO Growthminhnv0807/ai-business-skills609—~5kAutomated safety check: PassMIT
SEOAgriciDaniel/codex-seo799—~3.7kAutomated safety check: PassMIT

Similar skills

  • SEO

    Nexus-JPF/note-companion

    Use and read this skill immediately if the user request is in any way related to SEO or a site's organic search or AI search presence.

    870 GitHub stars~2.2k tokensUpdated 4 days ago
    Marketing & SEOAuto-check passed
  • GEO-First SEO Audit Tool

    zubair-trabzada/geo-seo-claude

    Audits a website for AI search visibility across ChatGPT, Claude, Perplexity and Google AI Overviews while checking traditional SEO, schema and E-E-A-T content quality.

    11k GitHub stars~2.8k tokensUpdated yesterday
    Marketing & SEOAuto-check: notes
  • SEO

    AgriciDaniel/seo-os

    Comprehensive SEO analysis for any website or business type.

    137 GitHub starsUsed in 2 repos~3.5k tokens
    Marketing & SEOAuto-check passed
  • Global SEO Growth

    minhnv0807/ai-business-skills

    Covers six SEO layers for a website: crawl and index audit, local SEO, search-intent content, AI search visibility, schema markup and backlink or directory distribution.

    609 GitHub stars~5k tokensUpdated 29 days ago
    Marketing & SEOAuto-check passed
  • SEO

    AgriciDaniel/codex-seo

    Comprehensive SEO analysis for any website, page, business, or topic.

    799 GitHub stars~3.7k tokensUpdated 29 days ago
    Marketing & SEOAuto-check passed
  • SEO And Aeo Strategy

    manojbajaj95/claude-gtm-plugin

    SEO, AEO (Answer Engine Optimization), and GEO strategy for search engines and AI visibility.

    105 GitHub stars~4k tokensUpdated 23 days ago
    Marketing & SEOAuto-check passed

Categories

Questions about Qiaomu SEO

What does Qiaomu SEO do?

Audit, diagnose, research, plan, implement, experiment on, and verify website SEO across Google, Bing, and AI-search surfaces. Qiaomu SEO is an agent skill from joeseesun/qiaomu-seo. Audit, diagnose, research, plan, implement, experiment on, and verify website SEO across Google, Bing, and AI-search surfaces.

When should I use Qiaomu SEO?

Qiaomu SEO fits situations like: rendering and indexing; internal linking; structured data; core Web Vitals.

How do I install Qiaomu SEO in Claude Code?

Run `npx skills add joeseesun/qiaomu-seo --skill qiaomu-seo -a claude-code`. Or copy the skill folder (the joeseesun/qiaomu-seo repository) into .claude/skills/qiaomu-seo in your project. Claude Code loads it when a task matches its description.

How do I install Qiaomu SEO in Codex?

Run `npx skills add joeseesun/qiaomu-seo --skill qiaomu-seo -a codex`. Or copy the skill folder (the joeseesun/qiaomu-seo repository) into .agents/skills/qiaomu-seo in your project. Codex loads it when a task matches its description.

Can I use Qiaomu SEO 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 joeseesun/qiaomu-seo --skill qiaomu-seo -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/qiaomu-seo, .gemini/skills/qiaomu-seo, .github/skills/qiaomu-seo and .opencode/skills/qiaomu-seo in your project.

What does Qiaomu SEO need to run?

Going by SKILL.md and its folder, Qiaomu SEO needs the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Qiaomu SEO access the network?

SKILL.md names 2 domains. As links in the text: x.com and github.com. This is read from the text; nothing was executed.

Is Qiaomu SEO 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 Qiaomu SEO use?

Qiaomu SEO is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Qiaomu SEO use?

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

What are the alternatives to Qiaomu SEO?

Skills that share tags, products or a category with Qiaomu SEO: SEO (Nexus-JPF/note-companion, 870 stars), GEO-First SEO Audit Tool (zubair-trabzada/geo-seo-claude, 11k stars), SEO (AgriciDaniel/seo-os, 137 stars) and Global SEO Growth (minhnv0807/ai-business-skills, 609 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Qiaomu SEO?

joeseesun (a GitHub user) maintains it in joeseesun/qiaomu-seo, which has 441 GitHub stars. The repository was last updated on August 3, 2026.

Source: joeseesun/qiaomu-seo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.