JasonColapietro/suede-creator-skills / skills/suede-seo-audit
suede-seo-audit
VerifiedAudit technical access, intent, metadata, links, schema, generative search, copy, E-E-A-T, and topic architecture with A-F lanes and exact fixes. Use when asked to "audit this site for SEO", investigate traffic or indexation problems, or produce a scored report. Includes offline source-review tools. NOT FOR: a quick promotion grade (use suede-visibility-grader), AI crawler and citation measurement (use suede-ai-seo), or conversion-path changes (use suede-site-alchemy).
| File | Kind | Size |
|---|---|---|
| CARD.md | markdown | 4.4 KB |
| SKILL.md | skill md | 17.6 KB |
| agents/openai.yaml | config | 723 B |
| references/google-search-guidance.md | markdown | 6.4 KB |
| references/keyword-research.md | markdown | 4.7 KB |
| references/lane-checklists.md | markdown | 24.0 KB |
| references/offline-tools.md | markdown | 4.6 KB |
| references/schema-templates.md | markdown | 10.5 KB |
| references/worked-handoff.md | markdown | 1.7 KB |
| scripts/fixtures/pages.json | config | 1003 B |
| scripts/fixtures/serp.json | config | 828 B |
| scripts/lib/audit.mjs | script | 963 B |
| scripts/lib/merchant-schema.mjs | script | 15.1 KB |
| scripts/lib/metadata-drift.mjs | script | 9.8 KB |
| scripts/lib/offline-reports.mjs | script | 2.5 KB |
| scripts/lib/page-technical.mjs | script | 16.1 KB |
| scripts/lib/serp-overlap.mjs | script | 6.9 KB |
| scripts/seo-review.mjs | script | 4.5 KB |
| scripts/tests/cli.test.mjs | script | 3.4 KB |
| scripts/tests/merchant-schema.test.mjs | script | 12.5 KB |
| scripts/tests/metadata-drift.test.mjs | script | 7.9 KB |
| scripts/tests/offline-reports.test.mjs | script | 2.6 KB |
| scripts/tests/page-technical.test.mjs | script | 9.0 KB |
| scripts/tests/serp-overlap.test.mjs | script | 5.4 KB |
references/google-search-guidance.md
View on GitHub# Current Search Guidance
Primary-source baseline verified on 2026-10-23. Re-check the linked page when
a rule affects a ship decision; Google and Microsoft change these often.
## Generative AI features (AI Overviews, AI Mode)
- Rooted in core Search ranking and quality systems. "There are no additional
requirements to appear in AI Overviews or AI Mode, nor other special
optimizations necessary."
- Eligibility: indexed and eligible to show with a snippet. No other technical
requirement. Serving is not guaranteed.
- Both may use query fan-out (multiple related searches across subtopics), so
topic coverage across a site matters more than one page per phrasing.
- No special schema, AI text files, markup, or Markdown copies are needed.
Google Search does not use `llms.txt`.
- No need to break content into tiny chunks or write in a special style.
- Mass-producing pages to manipulate rankings or AI responses violates the
scaled content abuse policy.
- Controls: `nosnippet`, `data-nosnippet`, `max-snippet`, and `noindex` limit
what AI features show. `Google-Extended` affects Gemini training and
grounding outside Search; Google says it does not affect Search inclusion or
ranking.
- Reporting: AI feature clicks and impressions count in the Performance report
under the Web search type. Google introduced a Search Generative AI
performance report in June 2026 (impressions by page, country, device, date;
no clicks or queries; shown only above an impressions threshold).
Sources:
- https://developers.google.com/search/docs/appearance/ai-features
- https://developers.google.com/search/docs/fundamentals/ai-optimization-guide (last updated 2026-07-10)
- https://developers.google.com/search/blog/2026/06/gen-ai-performance-reports
- https://developers.google.com/crawling/docs/crawlers-fetchers/google-common-crawlers
## Helpful content and spam policies
- Helpfulness is assessed by core ranking systems; there is no separate
helpful content update to recover from. Use Google's self-assessment
questions: original information, first-hand expertise, a satisfying answer,
content made for people rather than for search engines.
- Spam policies that matter most for audits: scaled content abuse, doorway
abuse, site reputation abuse, expired domain abuse, keyword stuffing, hidden
text, and misleading structured data.
- There is no keyword-density target and no ideal word count.
Sources:
- https://developers.google.com/search/docs/fundamentals/creating-helpful-content
- https://developers.google.com/search/docs/essentials/spam-policies
- https://developers.google.com/search/docs/fundamentals/seo-starter-guide
## Titles and snippets
- No fixed character limit for titles or meta descriptions; results truncate
by device and query.
- Google may generate title links and snippets from page content.
- Character counts are preview diagnostics only.
Sources:
- https://developers.google.com/search/docs/appearance/title-link
- https://developers.google.com/search/docs/appearance/snippet
## Structured data: what earns a result in 2026
- Markup must describe visible content, use a supported type for the targeted
feature, and include that feature's required properties. Valid markup
creates eligibility, not a guarantee.
- **FAQ rich results ended on May 7, 2026** for all sites. The Search Console
FAQ report and Rich Results Test support were scheduled for removal in June
2026 and API support in August 2026. FAQPage remains valid schema.org
vocabulary and Google may still read it to understand pages; it no longer
produces a Google rich result.
- **HowTo rich results** were removed in 2023 (mobile first, then desktop). Do
not recommend HowTo markup for a Google feature.
- **Retired in June 2025** (simplifying search results): Course Info, Claim
Review, Estimated Salary, Learning Video, Special Announcement, Vehicle
Listing. Book Actions was announced for retirement and later kept because
some features still use it. Practice Problems was announced for deprecation
with Search Console support for several retired types ending January 2026.
Check the search gallery for the current list before naming any feature.
- Still useful and supported (verify in the gallery): Organization, Article,
Breadcrumb, Product and merchant listings, Review snippet, Video, Event,
Local Business, Recipe, Software App, Dataset (Dataset Search only), Job
Posting, Profile Page, Discussion Forum, Q&A.
- Validate with the Rich Results Test for Google features and the Schema.org
Validator for vocabulary. Record which was used.
Sources:
- https://developers.google.com/search/docs/appearance/structured-data/search-gallery
- https://developers.google.com/search/docs/appearance/structured-data/sd-policies
- https://developers.google.com/search/docs/appearance/structured-data/faqpage
(direct fetch was blocked during this check; dates confirmed through
https://www.techwyse.com/news/ai-search/google-faq-rich-results-deprecated-2026)
- https://developers.google.com/search/blog/2025/06/simplifying-search-results
- https://developers.google.com/search/blog/2023/08/howto-faq-changes
## Core Web Vitals
| Metric | Good | Needs improvement | Poor |
|---|---|---|---|
| LCP | 2.5 s or less | up to 4 s | over 4 s |
| INP | 200 ms or less | up to 500 ms | over 500 ms |
| CLS | 0.1 or less | up to 0.25 | over 0.25 |
Assessed at the 75th percentile of field data (CrUX), split by mobile and
desktop. INP replaced FID in March 2024. CWV is part of page experience, not a
standalone ranking guarantee.
Sources:
- https://web.dev/articles/vitals
- https://developers.google.com/search/docs/appearance/core-web-vitals
(Both fetches were blocked during this check; thresholds unchanged per
multiple 2026 secondary sources.)
## Bing and IndexNow
- Copilot grounds on the Bing index. Verify the site in Bing Webmaster Tools,
submit sitemaps, and allow `Bingbot`.
- Bing Webmaster Tools AI Performance report (public preview February 2026):
Copilot citations, cited pages, grounding queries.
- IndexNow pings participating engines when URLs change. Google does not
participate; keep sitemaps accurate for Google.
Sources:
- https://www.bing.com/webmasters
- https://www.indexnow.org/
## Evidence boundary
Search Console, Bing Webmaster Tools, analytics, third-party SEO tools, and
live results measure different things. Name the source, market, scope, and
date. Unobserved results are `unknown`. Never turn a heuristic into a traffic,
ranking, citation, or conversion promise.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |