feat(skills): bulk-add root SKILL.md to 61 skills (native Agent Skills loadability)
Run the additive migration pass from SKILL-MIGRATION-GUIDE: generate a root SKILL.md for every skill that lacked one, copied from its desktop/SKILL.md (or code/SKILL.md), with name set to the directory name and description + body preserved verbatim. - scripts/migrate_skill_root.py: the reusable, non-destructive migrator (dry-run default). - 61 new root SKILL.md (desktop source for most; code/SKILL.md for 61/62/92). - Untouched: 16/17/95 (already had root); desktop/ and code/ packaging left intact. - All 64 root SKILL.md validate: frontmatter <=1024, kebab name, description present. Still MANUAL (no SKILL.md source — commands/README only), need hand-authored root SKILL.md: 81-mac-optimizer, 90-reference-curator, 91-multi-agent-guide, 94-dintel-bootstrap. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
168
custom-skills/29-seo-gateway-architect/SKILL.md
Normal file
168
custom-skills/29-seo-gateway-architect/SKILL.md
Normal file
@@ -0,0 +1,168 @@
|
||||
---
|
||||
name: 29-seo-gateway-architect
|
||||
description: |
|
||||
Gateway page strategy planner for keyword research, content architecture, and SEO KPIs.
|
||||
Triggers: SEO strategy, gateway pages, keyword research, content architecture.
|
||||
---
|
||||
|
||||
# SEO Gateway Page Strategist
|
||||
|
||||
This skill helps you create comprehensive SEO-focused gateway page strategies for Korean medical/service websites, optimized for both Naver and Google.
|
||||
|
||||
## Core Competencies
|
||||
|
||||
1. **Keyword Research & Analysis**: Identifies primary and LSI keywords with search intent mapping
|
||||
2. **Content Architecture**: Creates hierarchical page structure optimized for SEO
|
||||
3. **Technical SEO Planning**: Defines specific technical requirements and meta optimizations
|
||||
4. **Performance Targeting**: Sets measurable KPIs and tracking methodologies
|
||||
5. **Competitor Analysis**: Analyzes top-ranking competitors for gap identification
|
||||
|
||||
## When to Use This Skill
|
||||
|
||||
Use this skill when:
|
||||
- Planning a new gateway page for any service/procedure category
|
||||
- Restructuring existing pages for better SEO performance
|
||||
- Conducting keyword research for content planning
|
||||
- Setting SEO performance targets and KPIs
|
||||
- Analyzing competitor strategies
|
||||
|
||||
## Instructions
|
||||
|
||||
When using this skill, provide:
|
||||
1. **Service/Procedure Name**: The main topic for the gateway page (e.g., "눈 성형", "이마 성형")
|
||||
2. **Target Market**: Location and demographic information
|
||||
3. **Current Performance** (optional): Existing rankings, traffic data if available
|
||||
4. **Competitor URLs** (optional): Known competitors to analyze
|
||||
|
||||
## Process Workflow
|
||||
|
||||
### Step 1: Keyword & Intent Analysis
|
||||
```python
|
||||
# The skill will generate:
|
||||
- Primary keyword with monthly search volume
|
||||
- 7-10 LSI (Latent Semantic Indexing) keywords
|
||||
- User intent distribution (Informational/Comparative/Transactional)
|
||||
- Top 3 competitor analysis
|
||||
```
|
||||
|
||||
### Step 2: Content Architecture
|
||||
The skill creates a complete H1-H3 structure with keyword placement strategy:
|
||||
```
|
||||
H1: [Primary keyword-optimized headline]
|
||||
├── Hero Section
|
||||
├── Problem/Solution Framework
|
||||
├── Service Categories
|
||||
├── Trust & Authority
|
||||
├── FAQ Section
|
||||
└── Consultation Guide
|
||||
```
|
||||
|
||||
### Step 3: Technical SEO Requirements
|
||||
Generates specific technical specifications:
|
||||
- Meta tags formulas and character limits
|
||||
- Schema markup recommendations
|
||||
- Internal linking strategy
|
||||
- Image optimization guidelines
|
||||
- Core Web Vitals targets
|
||||
|
||||
### Step 4: Performance Metrics
|
||||
Sets 30/60/90-day KPIs with tracking methodology
|
||||
|
||||
## Example Usage
|
||||
|
||||
### Basic Request:
|
||||
```
|
||||
"Create an SEO gateway page strategy for 눈 성형"
|
||||
```
|
||||
|
||||
### Detailed Request:
|
||||
```
|
||||
"Create an SEO gateway page strategy for 눈 성형 targeting women aged 25-45 in Gangnam.
|
||||
Current ranking: page 2 for main keyword.
|
||||
Competitor: www.example-clinic.com/eye-surgery"
|
||||
```
|
||||
|
||||
## Output Format
|
||||
|
||||
The skill delivers a structured report containing:
|
||||
|
||||
1. **Keyword Strategy Table**
|
||||
- Primary and LSI keywords with search volumes
|
||||
- User intent percentages
|
||||
- Competitor gap analysis
|
||||
|
||||
2. **Content Architecture Document**
|
||||
- Complete page hierarchy (H1-H3)
|
||||
- Word count targets per section
|
||||
- Keyword placement map
|
||||
|
||||
3. **Technical SEO Checklist**
|
||||
- Meta tag templates
|
||||
- Schema markup code
|
||||
- Performance requirements
|
||||
|
||||
4. **Performance Dashboard**
|
||||
- Current baseline metrics
|
||||
- Target KPIs with timeline
|
||||
- Tracking methodology
|
||||
|
||||
## Templates Included
|
||||
|
||||
- `keyword-research-template.md`: Keyword analysis worksheet
|
||||
- `content-architecture-template.md`: Page structure template
|
||||
- `seo-checklist-template.md`: Technical SEO requirements
|
||||
- `performance-tracking-template.md`: KPI tracking sheet
|
||||
|
||||
## Scripts Included
|
||||
|
||||
- `keyword_analyzer.py`: Automates keyword research and intent analysis
|
||||
- `competitor_analyzer.py`: Scrapes and analyzes competitor pages
|
||||
- `seo_scorer.py`: Calculates SEO optimization score
|
||||
|
||||
## Best Practices
|
||||
|
||||
1. **Mobile-First Approach**: Always optimize for mobile (70%+ traffic in Korea)
|
||||
2. **Naver vs Google**: Consider platform-specific optimization differences
|
||||
3. **Local SEO**: Include location modifiers for local intent
|
||||
4. **Medical Compliance**: Ensure content meets Korean medical advertising regulations
|
||||
5. **User Intent Matching**: Align content with search intent distribution
|
||||
|
||||
## Common Patterns
|
||||
|
||||
### For Medical Services:
|
||||
```
|
||||
Primary: [시술명]
|
||||
LSI: [시술명 비용], [시술명 부작용], [시술명 회복기간], [시술명 전후]
|
||||
Intent: 60% Informational, 30% Comparative, 10% Transactional
|
||||
```
|
||||
|
||||
### For Local Services:
|
||||
```
|
||||
Primary: [지역] [서비스명]
|
||||
LSI: [지역] [서비스명] 추천, [지역] [서비스명] 잘하는곳, [지역] [서비스명] 가격
|
||||
Intent: 40% Informational, 40% Comparative, 20% Transactional
|
||||
```
|
||||
|
||||
## Integration Points
|
||||
|
||||
This skill integrates with:
|
||||
- Google Search Console for current performance data
|
||||
- Naver Webmaster Tools for Naver-specific metrics
|
||||
- Analytics platforms for user behavior data
|
||||
- Keyword research tools APIs
|
||||
|
||||
## Notes
|
||||
|
||||
- Always validate keyword search volumes with actual tools
|
||||
- Consider seasonal trends in search behavior
|
||||
- Update strategy based on algorithm changes
|
||||
- Monitor competitor movements regularly
|
||||
|
||||
## Notion Output (Required)
|
||||
|
||||
All audit reports MUST be saved to OurDigital SEO Audit Log:
|
||||
- **Database ID**: `2c8581e5-8a1e-8035-880b-e38cefc2f3ef`
|
||||
- **Properties**: Issue (title), Site (url), Category, Priority, Found Date, Audit ID
|
||||
- **Language**: Korean with English technical terms
|
||||
- **Audit ID Format**: [TYPE]-YYYYMMDD-NNN
|
||||
|
||||
Reference in New Issue
Block a user