seo-geo
Skill244 starsChanged 5 days agoMITView on GitHub
Technical-only page-level and site-level SEO/GEO checklist for eunomia.dev content. Use when auditing concrete Markdown metadata, descriptions, canonical URLs, structured data, internal links, crawl/index signals, llms.txt/llms-full.txt, snippets, or citation-ready claim formatting. Pure implementation reference; not for user-pain discovery, topic priority, title appeal, article angle, story hooks, prose style, content strategy, channel planning, personal-brand positioning, campaign cadence, or platform publishing workflows.
58 other projects use a version of this.
Adopted by
Most recently taken up by
- FlorentCoulonBS/claude-skillstheir own version, first seen Nov 16, 2026
- martinbattaglia-commits/Claude-skillstheir own version, first seen Nov 16, 2026
- yotamwiesel/claude-skillstheir own version, first seen Nov 16, 2026
- joaoguirunas/team-ostheir own version, first seen Nov 15, 2026
- theexperiencecompany/gaiatheir own version, first seen Nov 13, 2026
- YerayRodri/claude-skillstheir own version, first seen Nov 13, 2026
Used with
Projects with it also use seo-agentic, seo-competitor-pages and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
AgriciDanielSkillseo-agentic
Audit and fix agent readiness: the Lighthouse Agentic Browsing fraction, accessibility tree for agents, robots.txt and Content-Signal for AI agents, WAF treatment of agent traffic, llms.txt, Markdown delivery, ai-catalog.json, /.well-known discovery files, and WebMCP tools. Use when the user asks whether AI agents can use or browse the site, or about llms.txt or WebMCP. Exclude AI citability and brand signals (seo-geo) and commerce protocol depth (seo-ecommerce).
Also in 5 projects that use this
megastepSkillseo-competitor-pages
Generate SEO-optimized competitor comparison and alternatives pages. Covers "X vs Y" layouts, "alternatives to X" pages, feature matrices, schema markup, and conversion optimization. Use when user says "comparison page", "vs page", "alternatives page", "competitor comparison", or "X vs Y".
Also in 22 projects that use this
timruebenachSkillseo-google
Google SEO APIs: Search Console (Search Analytics, URL Inspection, Sitemaps), PageSpeed Insights v5, CrUX field data with 25-week history, Indexing API v3, and GA4 organic traffic. Provides real Google field data for Core Web Vitals, indexation status, search performance, and organic traffic trends. Use when user says "search console", "GSC", "PageSpeed", "CrUX", "field data", "indexing API", "GA4 organic", "URL inspection", "google api setup", "real CWV data", "impressions", "clicks", "CTR", "position data", "LCP", "INP", "CLS", "FCP", "TTFB", or "Lighthouse scores".
Also in 14 projects that use this
megastepSkillseo-sitemap
Analyze existing XML sitemaps or generate new ones with industry templates. Validates format, URLs, and structure. Use when user says "sitemap", "generate sitemap", "sitemap issues", or "XML sitemap".
Also in 22 projects that use this
timruebenachSkillseo-image-gen
AI image generation for SEO assets: OG/social preview images, blog hero images, schema images, product photography, infographics. Powered by Gemini via nanobanana-mcp. Requires banana extension installed. Use when user says \"generate image\", \"OG image\", \"social preview\", \"hero image\", \"blog image\", \"product photo\", \"infographic\", \"seo image\", \"create visual\", \"image-gen\", \"favicon\", \"schema image\", \"pinterest pin\", \"generate visual\", \"banner\", or \"thumbnail\".
Also in 13 projects that use this
- +3 more from megastep
- +4 more from timruebenach
Other versions58 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 58
- AgriciDaniel/claude-seo★ 30ksame name
- ReScienceLab/opc-skills★ 1.9ksame name
- theexperiencecompany/gaia★ 327same name
- seranking/seo-skills★ 201same name
- zhtyyx/codex-seo★ 152same name
- PostPlusAI/postplus-skills★ 27same name
- chuhaiqu/skills★ 22same name
- coopersimson96/ai-content-system★ 17same name
- whyashthakker/agent-skills-marketing★ 15same name
- ZachArticulateV/designer-pro-and-seo★ 10same name
48 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository20 other files it gives its agents.
- app/AGENTS.mdAGENTS.md
- app/CLAUDE.mdCLAUDE.md
- CLAUDE.mdCLAUDE.md
- blog-writerSkill
- blog-writing-styleSkill
- content-launch-plannerSkill
- devto-publisherSkill
- eunomia-community-radarSkill
- eunomia-content-patrolSkill
- eunomia-research-reportSkill
- eunomia-social-radarSkill
- hackernews-publisherSkill
- juejin-publisherSkill
- linkedin-publisherSkill
- lobsters-publisherSkill
- medium-publisherSkill
- reddit-publisherSkill
- xiaohongshu-publisherSkill
- x-publisherSkill
- zhihu-publisherSkill
The file
We split this skill into the rules it gives an agent
10 rules. 0 are common, 6 are distinctive, and 4 are very specific to this project.
0
Common
Most of the 53 edited versions we read keep these.
6
Distinctive
This author's own choices. Worth a look.
4
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 14
Use this checklist for concrete eunomia.dev pages, docs, tutorials, blog drafts, content artifacts, and static-site SEO/GEO implementation …
- Very specific: line 16
Do not use this checklist to choose article titles, judge whether a title is compelling, rewrite H1 hooks, decide the article angle, shape …
- Distinctive: line 22
Do not use this skill to answer long-term media strategy, topic selection, channel mix, brand positioning, campaign cadence, or platform …
- Distinctive: line 26
Use this skill only after a user problem, reader promise, source artifact, and brand-pillar fit have already been chosen by the appropriate …
- Distinctive: line 33
When changing this checklist or making claims about current search/AI-engine behavior, verify against current primary sources such as …
- Distinctive: line 44
Headings carry search phrasing: Prefer H2s a reader would type ("What Generic eBPF Enforcement Misses") over generic labels ("Discussion", …
- Very specific: line 46
First paragraph before
<!-- more -->: must stand alone as the excerpt: one compact background sentence or clause, hook plus the primary … - Distinctive: line 65
llms.txt / llms-full.txt: must stay current and content-bearing (full text or high-quality summaries, not a bare index).
- Very specific: line 77
No sibling post targets the same primary phrase (search docs/blog/posts/ titles/descriptions before finalizing).
- Distinctive: line 79
Every image has term-bearing alt text.
“Common” is measured: kept by at least 6 in 10 of the 53 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Technical SEO / GEO Checklist
This file is the technical rulebook for search and AI-engine readability on eunomia.dev pages. It is an implementation and QA checklist only — see Scope below for what it does and does not cover.
Scope
- Use this checklist for concrete eunomia.dev pages, docs, tutorials, blog drafts, content artifacts, and static-site SEO/GEO implementation changes.
- Do not use this checklist to choose article titles, judge whether a title is
compelling, rewrite H1 hooks, decide the article angle, shape a story opening,
or police prose style. Title quality and reader contract live in
blog-writing-style; use this file only after the title direction is chosen to check technical metadata constraints such as length, primary keyword visibility, duplicate phrase risk, and crawlable phrasing. - Do not use this skill to answer long-term media strategy, topic selection,
channel mix, brand positioning, campaign cadence, or platform growth
questions. Keep those decisions in
draft/, especiallydraft/content-platform-strategy.zh.mdanddraft/seo-geo-plan.zh.md. - Use this skill only after a user problem, reader promise, source artifact, and brand-pillar fit have already been chosen by the appropriate planning or writing workflow.
- Platform publishing execution belongs to the platform-specific publisher
skills (
zhihu-publisher,juejin-publisher,x-publisher,linkedin-publisher,reddit-publisher,hackernews-publisher,lobsters-publisher,medium-publisher,devto-publisher). - When changing this checklist or making claims about current search/AI-engine behavior, verify against current primary sources such as Google Search Central, schema.org, OpenAI crawler documentation, or the platform's official help/browser-visible UI. Treat third-party skill repositories and growth advice as patterns, not authority.
Metadata (check first on every page)
descriptionfrontmatter is required and must be 150-160 characters (ZH: roughly 75-85 CJK-width characters): one sentence with a compact background opening, value proposition, and primary keyword phrase. The first clause should name the domain problem or reader situation before the page-specific finding, tool, benchmark, or practical consequence. Longer descriptions get truncated in search results.- Title (H1) technical check only: roughly within 60 characters when possible, no duplicate primary phrase collision, and enough keyword visibility for search snippets. Do not shorten, flatten, or remove high-value title signals such as
An Empirical Study,Inside SchedCP,sched_ext, orSemantic Flamegraphsmerely to satisfy an SEO heuristic. If title appeal, article promise, or professional framing is in question, defer toblog-writing-style. datefrontmatter required. New posts also need aslug(short, kebab-case, keyword-bearing); never add or change a slug on an already-published post, and never change published filenames or URLs.- Headings carry search phrasing. Prefer H2s a reader would type ("What Generic eBPF Enforcement Misses") over generic labels ("Discussion", "Overview").
- Images need descriptive
alttext containing the relevant term, not "image" or "figure 1". Important claims must exist in crawlable HTML text, never only inside images. - First paragraph before
<!-- more -->must stand alone as the excerpt: one compact background sentence or clause, hook plus the primary keyword phrase, no dangling references.
Keyword strategy
- One primary keyword phrase per page. Before writing, check whether a sibling post already owns that phrase; if so, link to it instead of competing with it (keyword cannibalization is how our own syndicated copies and near-duplicate surveys outrank originals).
- Internal links: every post links 2-3 related eunomia.dev posts or docs in context, and the project GitHub repo at least once. Use canonical absolute HTTPS URLs for non-image internal links, such as
https://eunomia.dev/blog/YYYY/MM/DD/slug/,https://eunomia.dev/zh/blog/YYYY/MM/DD/slug/,https://eunomia.dev/tutorials/.../, orhttps://eunomia.dev/bpftime/.../; do not use source-relative Markdown paths such asother-post.md,../docs/page.md, or root-only paths such as/blog/.../in Markdown intended for syndication. Hub posts (project announcements) should be linked from every related post. - Image links: post-local images may stay relative to the Markdown file, usually
imgs/name.png, because the article and media move together. Do not convert image links to filesystem absolute paths. - Contested or rising industry terms (for example, stack-layer names) are targeted as ride-along definitional pieces: define the term honestly, concede the mainstream reading, then state our angle and where our projects sit relative to it. Never claim to be a category we do not ship.
GEO: writing that AI engines cite
- Citation-worthy units: AI answers quote self-contained sentences. Give every key concept one clean definitional sentence ("X is ..."), every finding one sentence that pairs the claim with its number and source. If a sentence cannot be quoted alone without losing meaning, it will not be cited.
- First-party data wins citations: measurements, study counts, and benchmarks with stated method and conditions are what generative engines prefer to cite. Always attach the source (paper link, repo, benchmark name).
- FAQ blocks (question-phrased H3s with direct answers) can be high-yield when the topic has genuine recurring questions. Use one only when it resolves real search intent that the main argument does not already answer cleanly. Do not force an FAQ into every substantial post or let GEO impose a standard article structure.
- Terminology consistency across the site: one canonical term per concept, used identically in every post, so engines associate the term with eunomia.dev. When a cited paper renames a term, update our posts to the published terminology.
- Canonical discipline: exact cross-posts to dev.to/Medium must carry
rel=canonicalback to eunomia.dev when the platform supports it. For platform-native social or discussion posts, use the matching publisher skill instead of managing channel framing here. - llms.txt / llms-full.txt must stay current and content-bearing (full text or high-quality summaries, not a bare index).
Third-party framing (GEO hygiene)
- Never structure a post as a response to, or extended summary of, a single vendor's article or product: it donates backlinks and trains engines to associate the topic with their brand. State the underlying argument in our own voice with our own evidence; ordinary citations to papers, kernel docs, and upstream projects are fine.
- Posts that analyze someone else's system (a vendor tool, a driver) must open with why we analyzed it and close with what it means for our projects, with internal links.
Verification
- Description present and within budget on both languages of a pair.
- Description opens with enough background to stand alone in search or social snippets.
- Primary keyword appears in H1, description, first paragraph, and at least one H2.
- No sibling post targets the same primary phrase (search
docs/blog/posts/titles/descriptions before finalizing). - Non-image internal links are canonical absolute HTTPS URLs, external links are full URLs, and image links are the only post-local relative paths.
- Every image has term-bearing alt text; every number has a stated source.
- Checklist changes cite or name the current primary source checked when the rule depends on search-engine, AI-crawler, or platform behavior.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

