seo-site-audit-content-writer-competitor-analysis-x-6

原始内容

---
name: seo
slug: seo
version: 1.0.6
description: "Improves Google rankings with search engine optimization (SEO): audits, keyword research, content optimization, technical fixes, schema, and links. Not for paid search ads (PPC/SEM) or app store optimization. Use when organic traffic or rankings drop, pages are not indexed or get deindexed, crawl errors appear in Search Console, or a migration, redesign, or domain change is planned. Also for writing or refreshing content to rank, picking target keywords, fixing titles, canonicals, sitemaps, robots.txt, redirects, hreflang, duplicate content, or Core Web Vitals, and adding schema markup. And for chasing featured snippets or AI Overview citations, recovering from a Google penalty, core update, or manual action, optimizing local, ecommerce, SaaS, or publisher sites, or setting up Bing Webmaster Tools and IndexNow."
homepage: https://clawic.com/skills/seo
changelog: "Full coverage pass: deeper guides, situation-named files, and per-user configuration"
metadata:
  clawdbot:
    emoji: 🔍
    os:
    - linux
    - darwin
    - win32
    displayName: SEO (Site Audit + Content Writer + Competitor Analysis)
    configPaths:
    - ~/Clawic/data/seo/
---

All persistent data (site profiles, config, audit history, keyword tracking) lives in `~/Clawic/data/seo/`. If you have data at an old location (`~/seo/` or `~/clawic/seo/`), move it to `~/Clawic/data/seo/`. Read `setup.md` on first use; `memory-template.md` holds the file format.

## When To Use

- Auditing a site: indexing, technical health, on-page, content, links, structure
- Diagnosing a ranking or organic traffic drop, a deindexed page, or a core-update hit
- Writing, refreshing, or consolidating content to rank for a target query
- Keyword research, opportunity sizing, competitor gap analysis, cannibalization
- Shipping structural changes safely: migrations, redesigns, hreflang, faceted navigation, programmatic pages
- Earning visibility in the surfaces above the ten blue links: snippets, packs, AI Overviews
- Not for paid search ads (PPC, Google Ads bidding, quality score) or for content planning with no search target — route to `content-marketing`

## Quick Reference

| Situation | Read |
|-----------|------|
| Ranking or organic traffic dropped | Triage below first, then `recovery.md` |
| Core update hit, manual action, hacked or spammy pages, reconsideration request | `recovery.md` |
| First pass on a new site, scoping an audit, writing the deliverable | `audits.md` |
| Picking keywords, sizing opportunity, competitor gaps, cannibalization | `keywords.md` |
| Deciding what to write, intent, E-E-A-T, thin content, AI-written drafts | `content.md` |
| Bottom-funnel pages: alternatives, "vs", best-X, pricing, integrations, glossary | `commercial-pages.md` |
| Titles, meta descriptions, headings, URLs, image alt text | `on-page.md` |
| Site structure, click depth, topic clusters, subdomain vs subfolder, index bloat, new site from zero | `architecture.md` |
| Pages not indexed, robots.txt, canonicals, sitemaps, status codes, duplicates, log files | `technical.md` |
| Slow pages, LCP / INP / CLS failing, PageSpeed vs field data | `performance.md` |
| React/Vue/Angular site, content missing from view-source, SPA routing, soft 404s | `javascript.md` |
| JSON-LD, rich results, review stars, breadcrumbs, product feeds | `schema.md` |
| Internal links, backlinks, anchor text, outreach, disavow | `links.md` |
| Physical location or service area, Google Business Profile, reviews, map pack | `local.md` |
| Product and category pages, faceted navigation, variants, out-of-stock, pagination | `ecommerce.md` |
| Multiple languages or countries, hreflang, geotargeting, translated duplicates | `international.md` |
| Domain change, replatform, redesign, URL restructure, HTTP to HTTPS | `migrations.md` |
| Featured snippets, People Also Ask, sitelinks, image and video results, pixel position | `serp-features.md` |
| AI Overviews, AI Mode, ChatGPT and Perplexity citations, AI crawlers, llms.txt | `ai-search.md` |
| Search Console data, exports, regex filters, proving a change worked, forecasting, reporting | `search-console.md` |
| Bing, IndexNow, Applebot, Yandex, Naver, Baidu, privacy engines | `other-engines.md` |
| Publisher work: Top Stories, Google News, Discover traffic, paywalls | `news-discover.md` |
| Generating hundreds or thousands of templated pages | `programmatic.md` |
| WordPress, Shopify, Webflow, Wix, Next.js platform quirks | `cms-platforms.md` |
| Anything else SEO | Run the audit checklist below, then route from the area that fails |

## Core Rules

1. **Audit before prescribing.** Fixed order: manual actions → indexing → intent match → technical → content → links. Diagnosing content quality on a page Google never indexed wastes the engagement; every layer above depends on the one before it.
2. **The SERP is the spec.** Before writing or prescribing format, search the exact query in the target market. Page 1 defines format, depth, and freshness. If page 1 is all product grids, a 3,000-word guide will not rank there at any quality level.
3. **Improve before you create.** Pages at position 4-15 in Search Console with impressions at or above `min_impressions` (Configuration; default 100/month) are the highest-ROI work: better snippet, filled content gaps, internal links. Write a new page only when no existing URL targets the intent. Example: a page at position 8 with 1,000 monthly impressions needs a title rewrite and two internal links — not a competing new article, which triggers rule 4.
4. **One intent per page.** Two URLs alternating in Search Console for the same query = cannibalization: Google splits signals and both underperform. Fix: 301 the weaker into the stronger, merge unique content. Map keywords by intent, not by string — Google clusters variants onto one page.
5. **Technical floor.** Core Web Vitals "good" thresholds (Google, field data at p75): LCP < 2.5s, INP < 200ms, CLS < 0.1. HTTPS, mobile-first, self-referencing canonicals, clean sitemap. Technical debt caps everything content can earn.
6. **E-E-A-T is signals, not a score.** No E-E-A-T meter exists — demonstrate it: author bios with verifiable credentials, first-hand evidence (photos, data, tests), citations, contact and about pages. Decisive for YMYL topics (health, finance, legal, safety).
7. **Links: earn, never buy.** Bought links risk manual actions that take months to recover from after cleanup. Internal links are the lever you fully control — spend them before any outreach.
8. **Iterate from Search Console, not assumptions.** Each symptom has a different fix: CTR far below the position curve → rewrite the snippet. Impressions but no clicks → intent or SERP-feature problem. No impressions → indexing or relevance problem. GSC tells you which; guessing does not.
9. **Size the prize before doing the work.** `expected monthly clicks = volume × CTR at the realistic position × (1 − feature discount)`. Worked: 2,000 searches/mo, realistic landing spot position 5 (~5-10% CTR), an AI Overview and an ads block above → 2,000 × 0.07 × 0.6 ≈ 84 clicks/mo. If that number does not justify the build, say so before writing.

## Ranking Drop Triage

In order — stop at the first confirmed cause:

1. GSC → Manual Actions + Security Issues. If flagged, that IS the diagnosis (`recovery.md`).
2. URL Inspection on hit pages: still indexed? Google-selected canonical changed to another URL?
3. Recent deploys: robots.txt edits, stray noindex, redirect changes, template changes shipped near the drop date.
4. Drop date vs Google's announced update dates. Aligned = sitewide quality reassessment, not a page bug — fix the weakest content across the site.
5. Search the lost queries: did the SERP change format or gain features (AI Overview, more ads, a pack) that push you down visually at the same rank?
6. Backlinks: links lost on your side, or a competitor gained them.
7. Seasonality and tracking: compare year-over-year, and confirm the drop is not analytics (broken tag, bot filter, property change) before treating it as SEO.
8. None conclusive → gap-compare the pages that replaced you (`keywords.md`).

## SEO Audit Checklist

**Indexing:**
- [ ] Important pages indexed — verify with URL Inspection and the Page indexing report, not the `site:` operator
- [ ] No important pages blocked in robots.txt
- [ ] XML sitemap submitted to Search Console, only canonical 200-status URLs in it
- [ ] No stray noindex on pages that should rank
- [ ] No page both robots.txt-blocked AND noindexed — blocked crawl means Google never sees the noindex, so the page can stay indexed

**Technical:**
- [ ] Core Web Vitals passing (thresholds in rule 5)
- [ ] Mobile-friendly, HTTPS with no mixed content
- [ ] No crawl errors, no soft 404s, no server errors in Search Console
- [ ] Redirect chains ≤3 hops
- [ ] Rendered HTML contains the main content (JavaScript sites)

**On-Page:**
- [ ] Unique title tags (50-60 chars), meta descriptions (150-160 chars)
- [ ] One H1 per page with the target term; proper heading hierarchy
- [ ] Images with alt text; internal links to and from the page

**Content:**
- [ ] Search intent matched (rule 2)
- [ ] No cannibalization (rule 4)
- [ ] No thin or duplicate content; dead pages improved, consolidated, or removed

**Off-Page and Entity:**
- [ ] Google Business Profile complete (local businesses)
- [ ] Backlink profile checked for toxic patterns
- [ ] Brand queries return the right result, sitelinks, and knowledge panel where applicable

## Content Writing Process

1. **Keyword research** — target keyword, volume, SERP reality check (`keywords.md`)
2. **Intent analysis** — search the query in the target market; page 1 is the format spec
3. **Gap + gain** — cover what ranking pages cover, then add what none of them have
4. **Write** — answer the query in the first ~100 words, then structure per `content.md`
5. **Optimize** — title, meta, headers, internal links from strong pages, schema
6. **Publish** — request indexing once, log in `~/Clawic/data/seo/memory.md`, review GSC after a few weeks

## What Takes How Long

Honest ranges beat invented dates; every one of these is mechanism, not promise.

| Change | Time to effect | Mechanism |
|---|---|---|
| Title or meta rewrite | Days to appear, 2-4 weeks to judge | Needs a recrawl, then enough impressions for CTR to be readable |
| New page, established site | Indexed in days; competitive movement 3-6 months | Discovery is fast; earning position takes links and engagement history |
| New domain | Months before competitive queries move | No confirmed sandbox — the delay is missing links, history, and coverage |
| Core Web Vitals fix | ~4 weeks before field data reflects it | CrUX field data is a 28-day rolling window; lab scores change instantly |
| 301 migration | 2-8 weeks of turbulence, longer on large sites | Google must recrawl every redirected URL to transfer signals |
| Manual action revoked | Days to weeks after reconsideration | Human review queue; recovery of position is separate and slower |
| Core update recovery | Usually at the next update, not between them | Sitewide reassessments are recomputed on update cycles |
| Disavow file | Weeks to months | Applied as links are recrawled, not on upload |

## Output Gates

Before delivering recommendations or content:

- Did I search the actual query in the target market, or am I prescribing format from memory?
- Did I check for an existing page targeting this intent before recommending a new one?
- Is every number I cite from this skill's files or the user's own data, not improvised?
- Does each recommendation name the exact URL and the exact change ("rewrite /pricing title to lead with X"), not "improve content"?
- Did I size the prize (rule 9) so the user can refuse the work?
- Am I promising a date? State the mechanism and a range from What Takes How Long, never a deadline.

## Configuration

User-dependent variables. Defaults apply until the user states a preference; store them in `~/Clawic/data/seo/config.yaml`.

| Variable | Type | Default | Effect |
|---|---|---|---|
| site_type | blog \| ecommerce \| saas \| local \| news \| directory \| auto | auto | Weights the audit checklist and decides which guide the router opens first; `auto` infers from URL patterns and page templates on first look |
| target_market | text (locale, e.g. en-US) | en-US | Which SERP to check, which spelling variant to write, and whether hreflang and local guidance apply |
| tool_access | gsc-only \| paid-suite | gsc-only | `gsc-only` keeps every workflow on free data (GSC, Trends, SERPs); `paid-suite` unlocks backlink-index and difficulty-score steps |
| risk_posture | conservative \| standard \| aggressive | conservative | Gates link tactics, external anchor ratios, and how much templated page generation to recommend |
| cms | wordpress \| shopify \| webflow \| wix \| headless \| other \| auto | auto | Picks the implementation path for every fix (where redirects, robots, and metadata actually live) |
| min_impressions | number (impressions/month) | 100 | Floor for every opportunity list: striking distance (rule 3, `keywords.md`, `search-console.md`) and the traffic-at-stake cutoff for the audit Top 5. Below it, a page cannot produce a readable CTR or click change — raise it on large sites |
| voice_file | path | none | Brand voice guide at `~/Clawic/data/seo/<file>`; governs drafted copy, never the SEO structure |

Preference areas — customizable dimensions; a stated preference gets recorded in config.yaml and applied:

- **Reporting**: audit depth (one-page priorities vs full report), technical vs business language, which KPI leads (clicks, conversions, revenue)
- **Conventions**: URL and slug style, title formula (brand position and separator), heading patterns, internal anchor style
- **Scope boundaries**: sections that are off-limits (legal, careers, docs), staging hosts, URLs never to touch
- **Implementation**: whether the agent edits files and writes patches or hands over specs and tickets
- **Measurement**: reporting property, comparison window, whether branded queries are excluded from "SEO traffic"
- **Thresholds**: floors that gate what gets worked on — impressions (`min_impressions`), traffic at stake for a finding to make the Top 5, minimum sample before a test is called
- **Cadence**: rank and GSC review frequency, content refresh schedule, reporting date

## Traps

| Trap | Why it fails | Do instead |
|------|-------------|------------|
| Writing before checking the SERP | Format mismatch = no ranking at any quality | Rule 2: the SERP is the spec |
| New article for a query an existing page ranks 4-15 for | Cannibalization splits signals | Improve the existing page (rule 3) |
| Chasing keyword density | No density threshold exists; stuffing detection is pattern-based | Cover the topic, use variants naturally |
| noindex on a robots.txt-blocked page | Google never crawls it, never sees the noindex | Allow crawl until deindexed, then block |
| Changing URLs without 301s | Links and authority now point at 404s | Map every old URL to its closest new match |
| Buying links or PBNs | Payment and network footprints → manual action | Earn links via assets and digital PR |
| Reporting rank without checking the rendered SERP | #1 under an AI Overview and four ads earns a fraction of historical #1 clicks | Check pixel position, not just rank |
| Judging index coverage with `site:domain.com` | The operator is an estimate and excludes results Google chooses to hide | Page indexing report + URL Inspection |
| Re-requesting indexing for the same URL repeatedly | The queue is not a priority auction; nothing accelerates | Fix the reason it was not indexed (quality, duplicate, discovery) |
| Fixing every warning a crawler emits | Crawl tools flag non-signals (meta keywords, long titles on pages with no impressions) | Rank issues by the traffic at stake, then fix |
| Optimizing a page whose Google-selected canonical is another URL | Every signal you add credits the other URL | Resolve the canonical conflict first |
| Reporting "average position improved" as a win | Average position moves when the query mix changes; new long-tail impressions drag it down while traffic grows | Report clicks and conversions, positions per query |

## Where Experts Disagree

- **Word count.** Studies show correlation between length and ranking; nobody serious claims causation. Cover the intent fully, then stop — padding is a negative.
- **Disavow.** Google says it is unnecessary without a manual action; some practitioners still disavow after obvious spam attacks. Default: don't, unless a manual action names links.
- **Exact-match anchors.** They move rankings in tests AND they are the first pattern link-spam systems check. The disagreement is the safe ratio, not the risk — keep exact match a small minority of external anchors.
- **Subdomain vs subfolder.** Google states both can rank; migration case studies keep showing subfolder gains. Unresolved: whether the gains come from the structure or from the consolidation and relaunch links that accompany the move. Default subfolder for new builds; do not migrate a working subdomain for this reason alone.
- **Optimizing for AI Overviews.** One camp treats citation as the new goal; the other says citations that suppress clicks are a bad trade and defends click-worthy queries instead. Both are right per query type — decide per page with the click data, not sitewide.

## Related Skills
More Clawic skills, get them at https://clawic.com/skills/seo (install if the user confirms):

- `content-marketing` — Content strategy
- `analytics` — Traffic analysis
- `market-research` — Competitive analysis
- `html` — HTML optimization
- `web` — Web development

## Feedback

- If useful, star it: https://clawic.com/skills/seo
- Latest version: https://clawic.com/skills/seo

Part of [Clawic](https://clawic.com), the verified skill library. Get this skill: https://clawic.com/skills/seo.

name: seo slug: seo version: 1.0.6 description: "Improves Google rankings with search engine optimization (SEO): audits, keyword research, content optimization, technical fixes, schema, and links. Not for paid search ads (PPC/SEM) or app store optimization. Use when organic traffic or rankings drop, pages are not indexed or get deindexed, crawl errors appear in Search Console, or a migration, redesign, or domain change is planned. Also for writing or refreshing content to rank, picking target keywords, fixing titles, canonicals, sitemaps, robots.txt, redirects, hreflang, duplicate content, or Core Web Vitals, and adding schema markup. And for chasing featured snippets or AI Overview citations, recovering from a Google penalty, core update, or manual action, optimizing local, ecommerce, SaaS, or publisher sites, or setting up Bing Webmaster Tools and IndexNow." homepage: https://clawic.com/skills/seo changelog: "Full coverage pass: deeper guides, situation-named files, and per-user configuration" metadata: clawdbot: emoji: 🔍 os: - linux - darwin - win32 displayName: SEO (Site Audit + Content Writer + Competitor Analysis) configPaths: - ~/Clawic/data/seo/

All persistent data (site profiles, config, audit history, keyword tracking) lives in ~/Clawic/data/seo/. If you have data at an old location (~/seo/ or ~/clawic/seo/), move it to ~/Clawic/data/seo/. Read setup.md on first use; memory-template.md holds the file format.

When To Use

Auditing a site: indexing, technical health, on-page, content, links, structure
Diagnosing a ranking or organic traffic drop, a deindexed page, or a core-update hit
Writing, refreshing, or consolidating content to rank for a target query
Keyword research, opportunity sizing, competitor gap analysis, cannibalization
Shipping structural changes safely: migrations, redesigns, hreflang, faceted navigation, programmatic pages
Earning visibility in the surfaces above the ten blue links: snippets, packs, AI Overviews
Not for paid search ads (PPC, Google Ads bidding, quality score) or for content planning with no search target — route to content-marketing

Quick Reference

Situation	Read
Ranking or organic traffic dropped	Triage below first, then `recovery.md`
Core update hit, manual action, hacked or spammy pages, reconsideration request	`recovery.md`
First pass on a new site, scoping an audit, writing the deliverable	`audits.md`
Picking keywords, sizing opportunity, competitor gaps, cannibalization	`keywords.md`
Deciding what to write, intent, E-E-A-T, thin content, AI-written drafts	`content.md`
Bottom-funnel pages: alternatives, "vs", best-X, pricing, integrations, glossary	`commercial-pages.md`
Titles, meta descriptions, headings, URLs, image alt text	`on-page.md`
Site structure, click depth, topic clusters, subdomain vs subfolder, index bloat, new site from zero	`architecture.md`
Pages not indexed, robots.txt, canonicals, sitemaps, status codes, duplicates, log files	`technical.md`
Slow pages, LCP / INP / CLS failing, PageSpeed vs field data	`performance.md`
React/Vue/Angular site, content missing from view-source, SPA routing, soft 404s	`javascript.md`
JSON-LD, rich results, review stars, breadcrumbs, product feeds	`schema.md`
Internal links, backlinks, anchor text, outreach, disavow	`links.md`
Physical location or service area, Google Business Profile, reviews, map pack	`local.md`
Product and category pages, faceted navigation, variants, out-of-stock, pagination	`ecommerce.md`
Multiple languages or countries, hreflang, geotargeting, translated duplicates	`international.md`
Domain change, replatform, redesign, URL restructure, HTTP to HTTPS	`migrations.md`
Featured snippets, People Also Ask, sitelinks, image and video results, pixel position	`serp-features.md`
AI Overviews, AI Mode, ChatGPT and Perplexity citations, AI crawlers, llms.txt	`ai-search.md`
Search Console data, exports, regex filters, proving a change worked, forecasting, reporting	`search-console.md`
Bing, IndexNow, Applebot, Yandex, Naver, Baidu, privacy engines	`other-engines.md`
Publisher work: Top Stories, Google News, Discover traffic, paywalls	`news-discover.md`
Generating hundreds or thousands of templated pages	`programmatic.md`
WordPress, Shopify, Webflow, Wix, Next.js platform quirks	`cms-platforms.md`
Anything else SEO	Run the audit checklist below, then route from the area that fails

Core Rules

Audit before prescribing. Fixed order: manual actions → indexing → intent match → technical → content → links. Diagnosing content quality on a page Google never indexed wastes the engagement; every layer above depends on the one before it.
The SERP is the spec. Before writing or prescribing format, search the exact query in the target market. Page 1 defines format, depth, and freshness. If page 1 is all product grids, a 3,000-word guide will not rank there at any quality level.
Improve before you create. Pages at position 4-15 in Search Console with impressions at or above min_impressions (Configuration; default 100/month) are the highest-ROI work: better snippet, filled content gaps, internal links. Write a new page only when no existing URL targets the intent. Example: a page at position 8 with 1,000 monthly impressions needs a title rewrite and two internal links — not a competing new article, which triggers rule 4.
One intent per page. Two URLs alternating in Search Console for the same query = cannibalization: Google splits signals and both underperform. Fix: 301 the weaker into the stronger, merge unique content. Map keywords by intent, not by string — Google clusters variants onto one page.
Technical floor. Core Web Vitals "good" thresholds (Google, field data at p75): LCP < 2.5s, INP < 200ms, CLS < 0.1. HTTPS, mobile-first, self-referencing canonicals, clean sitemap. Technical debt caps everything content can earn.
E-E-A-T is signals, not a score. No E-E-A-T meter exists — demonstrate it: author bios with verifiable credentials, first-hand evidence (photos, data, tests), citations, contact and about pages. Decisive for YMYL topics (health, finance, legal, safety).
Links: earn, never buy. Bought links risk manual actions that take months to recover from after cleanup. Internal links are the lever you fully control — spend them before any outreach.
Iterate from Search Console, not assumptions. Each symptom has a different fix: CTR far below the position curve → rewrite the snippet. Impressions but no clicks → intent or SERP-feature problem. No impressions → indexing or relevance problem. GSC tells you which; guessing does not.
Size the prize before doing the work. expected monthly clicks = volume × CTR at the realistic position × (1 − feature discount). Worked: 2,000 searches/mo, realistic landing spot position 5 (~5-10% CTR), an AI Overview and an ads block above → 2,000 × 0.07 × 0.6 ≈ 84 clicks/mo. If that number does not justify the build, say so before writing.

Ranking Drop Triage

In order — stop at the first confirmed cause:

GSC → Manual Actions + Security Issues. If flagged, that IS the diagnosis (recovery.md).
URL Inspection on hit pages: still indexed? Google-selected canonical changed to another URL?
Recent deploys: robots.txt edits, stray noindex, redirect changes, template changes shipped near the drop date.
Drop date vs Google's announced update dates. Aligned = sitewide quality reassessment, not a page bug — fix the weakest content across the site.
Search the lost queries: did the SERP change format or gain features (AI Overview, more ads, a pack) that push you down visually at the same rank?
Backlinks: links lost on your side, or a competitor gained them.
Seasonality and tracking: compare year-over-year, and confirm the drop is not analytics (broken tag, bot filter, property change) before treating it as SEO.
None conclusive → gap-compare the pages that replaced you (keywords.md).

SEO Audit Checklist

Indexing:

Important pages indexed — verify with URL Inspection and the Page indexing report, not the site: operator
No important pages blocked in robots.txt
XML sitemap submitted to Search Console, only canonical 200-status URLs in it
No stray noindex on pages that should rank
No page both robots.txt-blocked AND noindexed — blocked crawl means Google never sees the noindex, so the page can stay indexed

Technical:

Core Web Vitals passing (thresholds in rule 5)
Mobile-friendly, HTTPS with no mixed content
No crawl errors, no soft 404s, no server errors in Search Console
Redirect chains ≤3 hops
Rendered HTML contains the main content (JavaScript sites)

On-Page:

Unique title tags (50-60 chars), meta descriptions (150-160 chars)
One H1 per page with the target term; proper heading hierarchy
Images with alt text; internal links to and from the page

Content:

Search intent matched (rule 2)
No cannibalization (rule 4)
No thin or duplicate content; dead pages improved, consolidated, or removed

Off-Page and Entity:

Google Business Profile complete (local businesses)
Backlink profile checked for toxic patterns
Brand queries return the right result, sitelinks, and knowledge panel where applicable

Content Writing Process

Keyword research — target keyword, volume, SERP reality check (keywords.md)
Intent analysis — search the query in the target market; page 1 is the format spec
Gap + gain — cover what ranking pages cover, then add what none of them have
Write — answer the query in the first ~100 words, then structure per content.md
Optimize — title, meta, headers, internal links from strong pages, schema
Publish — request indexing once, log in ~/Clawic/data/seo/memory.md, review GSC after a few weeks

What Takes How Long

Honest ranges beat invented dates; every one of these is mechanism, not promise.

Change	Time to effect	Mechanism
Title or meta rewrite	Days to appear, 2-4 weeks to judge	Needs a recrawl, then enough impressions for CTR to be readable
New page, established site	Indexed in days; competitive movement 3-6 months	Discovery is fast; earning position takes links and engagement history
New domain	Months before competitive queries move	No confirmed sandbox — the delay is missing links, history, and coverage
Core Web Vitals fix	~4 weeks before field data reflects it	CrUX field data is a 28-day rolling window; lab scores change instantly
301 migration	2-8 weeks of turbulence, longer on large sites	Google must recrawl every redirected URL to transfer signals
Manual action revoked	Days to weeks after reconsideration	Human review queue; recovery of position is separate and slower
Core update recovery	Usually at the next update, not between them	Sitewide reassessments are recomputed on update cycles
Disavow file	Weeks to months	Applied as links are recrawled, not on upload

Output Gates

Before delivering recommendations or content:

Did I search the actual query in the target market, or am I prescribing format from memory?
Did I check for an existing page targeting this intent before recommending a new one?
Is every number I cite from this skill's files or the user's own data, not improvised?
Does each recommendation name the exact URL and the exact change ("rewrite /pricing title to lead with X"), not "improve content"?
Did I size the prize (rule 9) so the user can refuse the work?
Am I promising a date? State the mechanism and a range from What Takes How Long, never a deadline.

Configuration

User-dependent variables. Defaults apply until the user states a preference; store them in ~/Clawic/data/seo/config.yaml.

Variable	Type	Default	Effect
site_type	blog \| ecommerce \| saas \| local \| news \| directory \| auto	auto	Weights the audit checklist and decides which guide the router opens first; `auto` infers from URL patterns and page templates on first look
target_market	text (locale, e.g. en-US)	en-US	Which SERP to check, which spelling variant to write, and whether hreflang and local guidance apply
tool_access	gsc-only \| paid-suite	gsc-only	`gsc-only` keeps every workflow on free data (GSC, Trends, SERPs); `paid-suite` unlocks backlink-index and difficulty-score steps
risk_posture	conservative \| standard \| aggressive	conservative	Gates link tactics, external anchor ratios, and how much templated page generation to recommend
cms	wordpress \| shopify \| webflow \| wix \| headless \| other \| auto	auto	Picks the implementation path for every fix (where redirects, robots, and metadata actually live)
min_impressions	number (impressions/month)	100	Floor for every opportunity list: striking distance (rule 3, `keywords.md`, `search-console.md`) and the traffic-at-stake cutoff for the audit Top 5. Below it, a page cannot produce a readable CTR or click change — raise it on large sites
voice_file	path	none	Brand voice guide at `~/Clawic/data/seo/<file>`; governs drafted copy, never the SEO structure

Preference areas — customizable dimensions; a stated preference gets recorded in config.yaml and applied:

Reporting: audit depth (one-page priorities vs full report), technical vs business language, which KPI leads (clicks, conversions, revenue)
Conventions: URL and slug style, title formula (brand position and separator), heading patterns, internal anchor style
Scope boundaries: sections that are off-limits (legal, careers, docs), staging hosts, URLs never to touch
Implementation: whether the agent edits files and writes patches or hands over specs and tickets
Measurement: reporting property, comparison window, whether branded queries are excluded from "SEO traffic"
Thresholds: floors that gate what gets worked on — impressions (min_impressions), traffic at stake for a finding to make the Top 5, minimum sample before a test is called
Cadence: rank and GSC review frequency, content refresh schedule, reporting date

Traps

Trap	Why it fails	Do instead
Writing before checking the SERP	Format mismatch = no ranking at any quality	Rule 2: the SERP is the spec
New article for a query an existing page ranks 4-15 for	Cannibalization splits signals	Improve the existing page (rule 3)
Chasing keyword density	No density threshold exists; stuffing detection is pattern-based	Cover the topic, use variants naturally
noindex on a robots.txt-blocked page	Google never crawls it, never sees the noindex	Allow crawl until deindexed, then block
Changing URLs without 301s	Links and authority now point at 404s	Map every old URL to its closest new match
Buying links or PBNs	Payment and network footprints → manual action	Earn links via assets and digital PR
Reporting rank without checking the rendered SERP	#1 under an AI Overview and four ads earns a fraction of historical #1 clicks	Check pixel position, not just rank
Judging index coverage with `site:domain.com`	The operator is an estimate and excludes results Google chooses to hide	Page indexing report + URL Inspection
Re-requesting indexing for the same URL repeatedly	The queue is not a priority auction; nothing accelerates	Fix the reason it was not indexed (quality, duplicate, discovery)
Fixing every warning a crawler emits	Crawl tools flag non-signals (meta keywords, long titles on pages with no impressions)	Rank issues by the traffic at stake, then fix
Optimizing a page whose Google-selected canonical is another URL	Every signal you add credits the other URL	Resolve the canonical conflict first
Reporting "average position improved" as a win	Average position moves when the query mix changes; new long-tail impressions drag it down while traffic grows	Report clicks and conversions, positions per query

Where Experts Disagree

Word count. Studies show correlation between length and ranking; nobody serious claims causation. Cover the intent fully, then stop — padding is a negative.
Disavow. Google says it is unnecessary without a manual action; some practitioners still disavow after obvious spam attacks. Default: don't, unless a manual action names links.
Exact-match anchors. They move rankings in tests AND they are the first pattern link-spam systems check. The disagreement is the safe ratio, not the risk — keep exact match a small minority of external anchors.
Subdomain vs subfolder. Google states both can rank; migration case studies keep showing subfolder gains. Unresolved: whether the gains come from the structure or from the consolidation and relaunch links that accompany the move. Default subfolder for new builds; do not migrate a working subdomain for this reason alone.
Optimizing for AI Overviews. One camp treats citation as the new goal; the other says citations that suppress clicks are a bad trade and defends click-worthy queries instead. Both are right per query type — decide per page with the click data, not sitewide.

Related Skills

More Clawic skills, get them at https://clawic.com/skills/seo (install if the user confirms):

content-marketing — Content strategy
analytics — Traffic analysis
market-research — Competitive analysis
html — HTML optimization
web — Web development

Feedback

If useful, star it: https://clawic.com/skills/seo
Latest version: https://clawic.com/skills/seo

Part of Clawic, the verified skill library. Get this skill: https://clawic.com/skills/seo.