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.
Install this agent skill to your Project
npx add-skill https://github.com/ogabasseyy/Baci/tree/main/.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
- Cost of Retrieval = (crawl + understand + evaluate + index + rank + serve cost) / value. Lower = higher rankings.
- Topical Authority = Topical Coverage × Historical Data
- Rank Topics, Not Keywords — Content is "a data point in a semantic network"
- Source Context — Why your brand should exist in SERPs
- 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):
- Neutralize: Stop harmful signals
- Prune: Remove low-quality/diluting content
- 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
- Source Context — Brand's reason to exist in SERPs
- Central Entity — Main entity appearing site-wide
- Central Search Intent — Primary intent served
- Core Section — Primary monetizable topics (60-70%)
- 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:
- Days 1-20: 1 article every 3 days
- Days 21-30: 1 article every 2 days
- Days 31-50: 1 article daily
- 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 methodologyreferences/content-creation.md— Algorithmic Authorship guidelinesreferences/technical-checklist.md— Technical audit checklistreferences/diagnostic-questions.md— Issue diagnosis frameworkreferences/advanced-strategies.md— Surround Sound, mentions, AI-era SEOreferences/ecommerce.md— E-commerce specifics
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
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.
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.
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.
handoff
Compact the current conversation into a handoff document for another agent to pick up.
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.
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.
Didn't find tool you were looking for?