seo-mastery
Search engine optimization strategies and tactics for organic growth. Use when optimizing content for search, conducting keyword research, performing SEO audits, or building link strategies.
Best use case
seo-mastery is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Search engine optimization strategies and tactics for organic growth. Use when optimizing content for search, conducting keyword research, performing SEO audits, or building link strategies.
Teams using seo-mastery should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/seo-mastery/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How seo-mastery Compares
| Feature / Agent | seo-mastery | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Search engine optimization strategies and tactics for organic growth. Use when optimizing content for search, conducting keyword research, performing SEO audits, or building link strategies.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
AI Agents for Marketing
Discover AI agents for marketing workflows, from SEO and content production to campaign research, outreach, and analytics.
Best AI Agents for Marketing
A curated list of the best AI agents and skills for marketing teams focused on SEO, content systems, outreach, and campaign execution.
SKILL.md Source
# SEO Mastery
Search engine optimization strategies and tactics for sustainable organic growth.
## Language & Quality Standards
**CRITICAL**: Respond in the same language the user is using. If Vietnamese, respond in Vietnamese. If Spanish, respond in Spanish.
**Standards**: Token efficiency, sacrifice grammar for concision, list unresolved questions at end.
---
## When to Use This Skill
Apply SEO expertise when:
- Optimizing content for search rankings
- Conducting keyword research
- Performing technical SEO audits
- Building link acquisition strategies
- Analyzing search performance
- Creating content strategies for organic growth
## Core Concepts
### Search Intent Types
| Intent | User Goal | Content Type | Examples |
|--------|-----------|--------------|----------|
| Informational | Learn something | How-to, guides, definitions | "how to write email copy" |
| Navigational | Find specific site | Brand pages | "HubSpot login" |
| Commercial | Research before buying | Comparisons, reviews | "best email marketing tools" |
| Transactional | Complete purchase | Product pages, pricing | "buy mailchimp subscription" |
### Keyword Research Framework
**Keyword Metrics to Evaluate**:
| Metric | What It Means | Good Range |
|--------|--------------|------------|
| Search Volume | Monthly searches | 100-10,000 for most |
| Keyword Difficulty | Competition level | 0-30 for new sites |
| CPC | Commercial intent | Higher = more valuable |
| SERP Features | What's on page 1 | Fewer = easier |
**Keyword Types**:
- **Head Terms**: 1-2 words, high volume, very competitive
- **Body Terms**: 2-3 words, medium volume, competitive
- **Long-tail**: 4+ words, low volume, less competitive
### On-Page SEO Elements
**Title Tag** (50-60 characters):
- Primary keyword near front
- Compelling and click-worthy
- Unique per page
- Include brand (if room)
**Meta Description** (150-160 characters):
- Include primary keyword naturally
- Call-to-action
- Unique value proposition
- Match search intent
**Header Structure**:
```
H1: Main Page Title (one per page, contains keyword)
H2: Major Section (keyword variations)
H3: Subsection (semantic terms)
H4: Supporting detail
```
**Content Optimization Checklist**:
- [ ] Keyword in first 100 words
- [ ] Natural keyword density (1-2%)
- [ ] Semantic variations throughout
- [ ] Internal links to related content (3-5 per post)
- [ ] External links to authoritative sources (1-2)
- [ ] Image alt text with keywords
- [ ] Short, descriptive URLs
### Technical SEO Essentials
**Core Web Vitals**:
| Metric | Target | What It Measures |
|--------|--------|------------------|
| LCP (Largest Contentful Paint) | <2.5s | Loading performance |
| FID (First Input Delay) | <100ms | Interactivity |
| CLS (Cumulative Layout Shift) | <0.1 | Visual stability |
**Crawlability Checklist**:
- [ ] XML sitemap submitted
- [ ] Clean robots.txt
- [ ] No broken links (4xx errors)
- [ ] Proper redirects (301 for permanent)
- [ ] Mobile-friendly design
- [ ] HTTPS enabled
**Indexability Checklist**:
- [ ] Canonical tags on duplicate pages
- [ ] No accidental noindex
- [ ] Hreflang for international
- [ ] Proper pagination handling
### Link Building Strategies
| Strategy | Effort | Impact | Best For |
|----------|--------|--------|----------|
| Guest Posting | High | Medium | New sites, authority |
| Broken Link Building | Medium | Medium | Quick wins |
| Resource Pages | Medium | Medium | Comprehensive content |
| Digital PR | High | High | Brand + links |
| Original Research | Very High | Very High | Thought leadership |
| HARO | Low | Variable | Easy opportunities |
### Content Clusters
**Pillar-Cluster Model**:
```
Pillar Page (comprehensive, 3000+ words)
├── Cluster 1 (specific subtopic, links to pillar)
├── Cluster 2 (specific subtopic, links to pillar)
├── Cluster 3 (specific subtopic, links to pillar)
└── Cluster N (specific subtopic, links to pillar)
```
**Benefits**:
- Establishes topical authority
- Improves internal linking
- Captures long-tail variations
- Better user navigation
## Best Practices
### Keyword Research Excellence
1. **Intent Match**: Align content with search intent
2. **Realistic Targets**: Start with achievable difficulty
3. **Cluster Thinking**: Group related keywords
4. **Commercial Balance**: Mix informational and transactional
### Content Excellence
1. **10x Content**: Be definitively better than page 1
2. **Comprehensive Coverage**: Answer all related questions
3. **Updated Regularly**: Refresh for freshness signals
4. **Multimedia Rich**: Images, videos, interactive elements
### Technical Excellence
1. **Speed Priority**: Fast sites rank better
2. **Mobile-First**: Google indexes mobile version
3. **Clean Architecture**: Logical URL and site structure
4. **Structured Data**: Schema markup for rich snippets
## Agent Integration
| Agent | How They Use This Skill |
|-------|------------------------|
| `attraction-specialist` | Full SEO strategy and execution |
| `copywriter` | SEO-optimized content creation |
| `researcher` | Competitor SEO analysis |
| `docs-manager` | SEO documentation and audits |
## Anti-Patterns to Avoid
| Anti-Pattern | Why It's Wrong | Do This Instead |
|--------------|----------------|-----------------|
| Keyword stuffing | Hurts rankings, UX | Natural density |
| Buying links | Penalty risk | Earn links |
| Duplicate content | Cannibalization | Canonical or consolidate |
| Ignoring search intent | Poor engagement signals | Match intent exactly |
| Chasing only volume | Ignores conversion | Balance volume + intent |
## Related Commands
- `/seo/keywords` - Keyword research
- `/seo/audit` - Comprehensive SEO audit
- `/seo/competitor` - Competitor SEO analysis
- `/seo/optimize` - Content optimization
- `/checklist/seo-weekly` - Weekly SEO maintenance
## References
- `references/keyword-research.md` - Keyword research methodology
- `references/on-page-seo.md` - On-page optimization checklist
- `references/technical-seo.md` - Technical SEO requirements
- `references/link-building.md` - Link acquisition strategies
- `references/local-seo.md` - Local search optimization
- `references/seo-audit-checklist.md` - Comprehensive audit frameworkRelated Skills
cli-mastery
Interactive training for the GitHub Copilot CLI. Guided lessons, quizzes, scenario challenges, and a full reference covering slash commands, shortcuts, modes, agents, skills, MCP, and configuration. Say "cliexpert" to start.
feedback-mastery
Navigate difficult conversations and deliver constructive feedback using structured frameworks. Covers the Preparation-Delivery-Follow-up model and Situation-Behavior-Impact (SBI) feedback technique. Use when preparing for difficult conversations, giving feedback, or managing conflicts.
javascript-mastery
Comprehensive JavaScript reference covering 33+ essential concepts every developer should know. From fundamentals like primitives and closures to advanced patterns like async/await and functional programming. Use when explaining JS concepts, debugging JavaScript issues, or teaching JavaScript fundamentals.
tailwind-css-v4-mastery
Expert guidance for leveraging Tailwind CSS V4's new Oxide engine, CSS-first configuration, and modern styling paradigms. This skill transforms Claude into a Tailwind V4 architecture specialist, capable of designing component systems, optimizing performance, and executing complex styling challenges with precision.
pytest-mastery
Python testing with pytest using uv package manager. Use when: (1) Running Python tests, (2) Writing test files or test functions, (3) Setting up fixtures, (4) Parametrizing tests, (5) Generating coverage reports, (6) Testing FastAPI applications, (7) Debugging test failures, (8) Configuring pytest options. Triggers: "run tests", "write tests", "test coverage", "pytest", "unit test", "integration test", "test FastAPI".
fastapi-mastery
Comprehensive FastAPI development skill covering REST API creation, routing, request/response handling, validation, authentication, database integration, middleware, and deployment. Use when working with FastAPI projects, building APIs, implementing CRUD operations, setting up authentication/authorization, integrating databases (SQL/NoSQL), adding middleware, handling WebSockets, or deploying FastAPI applications. Triggered by requests involving .py files with FastAPI code, API endpoint creation, Pydantic models, or FastAPI-specific features.
Cron Mastery
**Rule #1: Heartbeats drift. Cron is precise.**
Daily Logs
Record the user's daily activities, progress, decisions, and learnings in a structured, chronological format.
Socratic Method: The Dialectic Engine
This skill transforms Claude into a Socratic agent — a cognitive partner who guides
Sokratische Methode: Die Dialektik-Maschine
Dieser Skill verwandelt Claude in einen sokratischen Agenten — einen kognitiven Partner, der Nutzende durch systematisches Fragen zur Wissensentdeckung führt, anstatt direkt zu instruieren.
College Football Data (CFB)
Before writing queries, consult `references/api-reference.md` for endpoints, conference IDs, team IDs, and data shapes.
College Basketball Data (CBB)
Before writing queries, consult `references/api-reference.md` for endpoints, conference IDs, team IDs, and data shapes.