Agent skill

holistic-seo

Comprehensive SEO audit and optimization framework based on Koray Tuğberk GÜBÜR's Holistic SEO methodology. Use when performing SEO audits, creating content strategies, building topical authority, implementing semantic SEO, optimizing for E-E-A-T, or improving technical SEO. Covers topical maps, entity optimization, internal linking, structured data, Core Web Vitals, and content optimization for any website type including e-commerce, SaaS, blogs, and local businesses.

Stars 0
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/ogabasseyy/Baci/tree/main/apps/web/.claude

SKILL.md

Holistic SEO Audit & Growth Framework

Based on Koray Tuğberk GÜBÜR's methodology (122+ case studies, results including 0→128,000 traffic in 123 days). Core principle: "Cost of Ranking can't be higher than Cost of Not Ranking."

Core Principles

  1. Cost of Retrieval = (crawl + understand + evaluate + index + rank + serve cost) / value. Lower = higher rankings.
  2. Topical Authority = Topical Coverage × Historical Data
  3. Rank Topics, Not Keywords — Content is "a data point in a semantic network"
  4. Source Context — Why your brand should exist in SERPs
  5. Quality Threshold — "Good enough to be indexed ≠ good enough to be served"

Critical Numbers (Memorize These)

Metric Koray's Specification
Internal links per page Maximum 10 (5 sidebar, 3 contextual, 1 footer, 1 header)
Content similarity between pages <6% (above = ranking signal dilution)
HTML page size <450KB
Featured snippet length <340 characters, max 40 words
Extractive answer under H2 ~40 words
Source update to trigger re-ranking 30%+ of content
Server response time target <100ms

Expected Timeframes

Milestone Timeframe
First ranking signals 28-30 days
Initial ranking phase 20-45 days
Re-ranking phase 30-65 days
First featured snippets 60-90 days
Significant traffic growth 115-123 days
Full topical authority 5-6 months

Diagnostic Framework

Step 1: Determine Ranking State

CRITICAL FIRST STEP. Never optimize in negative state.

Negative State Indicators:

  • New content doesn't rank despite quality
  • Impressions exist but clicks minimal
  • "Crawled - currently not indexed" growing
  • Traffic declines after publishing

Recovery Framework (3 Steps):

  1. Neutralize: Stop harmful signals
  2. Prune: Remove low-quality/diluting content
  3. Create: New document networks for fresh attention

Timing: Make major changes 15-20 days before expected core updates — Google doesn't heavily weight final 15-20 days.

Step 2: Assess 5 Fundamentals

  1. Source Context — Brand's reason to exist in SERPs
  2. Central Entity — Main entity appearing site-wide
  3. Central Search Intent — Primary intent served
  4. Core Section — Primary monetizable topics (60-70%)
  5. Outer Section — Supporting topics (30-40%)

Step 3: Evaluate Quality Nodes

Quality Nodes propagate signals to entire semantic network.

  • Has comprehensive anchor documents?
  • Linked directly from homepage?
  • "Best on internet" quality for topic?

Step 4: Check Link Architecture

Link Node Types (prioritize I-nodes):

  • I-nodes: Individual contextual links — HIGHEST value
  • C-nodes: Content block link groups
  • S-nodes: Site-wide navigation — lowest value

Step 5: Audit Entity Signals

  • No conflicting EAV statements
  • Entity homes for primary entities
  • Cross-platform consistency
  • Surround Sound strategy active (see references/advanced-strategies.md)

Publishing Velocity Pattern

Follow this acceleration pattern:

  1. Days 1-20: 1 article every 3 days
  2. Days 21-30: 1 article every 2 days
  3. Days 31-50: 1 article daily
  4. Days 51+: Up to 3 articles/day

Starting too fast triggers spam detection. Gradual acceleration signals investment.

The 27-Article Pattern

Koray outranked WebMD, Healthline with just 27 articles. Keys:

  • Perfect topical coverage for query cluster
  • Strong internal linking (contextual bridges)
  • Consistent EAV structure
  • Quality Nodes anchoring network
  • Quality × Coverage beats Volume

Update Score Formula

Update Score = Update Frequency × Update Amount

Updates propagate through connected content. Strategic Quality Node updates improve entire network.

Reference Files

  • references/topical-maps.md — Complete topical map methodology
  • references/content-creation.md — Algorithmic Authorship guidelines
  • references/technical-checklist.md — Technical audit checklist
  • references/diagnostic-questions.md — Issue diagnosis framework
  • references/advanced-strategies.md — Surround Sound, mentions, AI-era SEO
  • references/ecommerce.md — E-commerce specifics

Expand your agent's capabilities with these related and highly-rated skills.

ogabasseyy/Baci

holistic-seo

Comprehensive SEO audit and optimization framework based on Koray Tuğberk GÜBÜR's Holistic SEO methodology. Use when performing SEO audits, creating content strategies, building topical authority, implementing semantic SEO, optimizing for E-E-A-T, or improving technical SEO. Covers topical maps, entity optimization, internal linking, structured data, Core Web Vitals, and content optimization for any website type including e-commerce, SaaS, blogs, and local businesses.

0 0
Explore
mattpocock/skills

edit-article

Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.

111,310 9,758
Explore
mattpocock/skills

git-guardrails-claude-code

Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.

111,310 9,758
Explore
mattpocock/skills

handoff

Compact the current conversation into a handoff document for another agent to pick up.

111,310 9,758
Explore
mattpocock/skills

obsidian-vault

Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.

111,310 9,758
Explore
mattpocock/skills

scaffold-exercises

Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section.

111,310 9,758
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results