page-seo

name	page-seo
description	Optimize a webpage for traditional search engines (Google, Bing). Covers keyword research, competitor page analysis, on-page SEO audit with scoring, content optimization, and schema markup recommendations. Use when users ask about SEO scores, title tags, meta descriptions, keyword optimization, heading structure, internal linking, or structured data for search engines.
metadata	{"version":"1.0.0","author":"karis-ai"}

Page SEO

Optimize a single webpage for traditional search engines. Core question: "How well does this page rank for its target keyword, and what should we fix?"

When to Use

User Says	Use This Skill
"Optimize this page for SEO"	page-seo
"What's my SEO score?"	page-seo
"Help me rank for [keyword]"	page-seo
"Audit my page's on-page SEO"	page-seo
"Fix my title tag / meta description"	page-seo
"Add schema markup to my page"	page-seo
"What keywords should I target?"	page-seo
"Why isn't my page ranking?"	page-seo
"Analyze competitor pages for [keyword]"	page-seo

Prerequisites

• Karis CLI installed (npx @karis-ai/cli) — optional but recommended
• Karis API key configured (karis setup) — optional
• Brand profile created (karis brand init) — optional, provides context

Workflow

Task Progress:
- [ ] Step 1: Keyword Research
- [ ] Step 2: Competitor Page Analysis
- [ ] Step 3: On-Page SEO Audit
- [ ] Step 4: Content Optimization

Step 1: Keyword Research

Extract the target keyword from user context. Identify related terms and search intent.

What to determine:

• Primary keyword: The main term the page should rank for
• Secondary keywords: 3-5 related terms and long-tail variations
• Search intent: Informational, navigational, commercial, or transactional
• Estimated difficulty: Low / Medium / High (based on SERP competition)

Optional CLI command:

npx @karis-ai/cli chat --skill page-seo "Research keywords for [topic]. Include:
- Primary keyword recommendation
- 5 secondary/long-tail keywords
- Search intent classification
- Difficulty assessment based on SERP competition"

Output:

Keyword	Type	Intent	Difficulty
[primary]	Primary	[intent]	[low/med/high]
[secondary 1]	Secondary	[intent]	[low/med/high]
[secondary 2]	Long-tail	[intent]	[low/med/high]

Step 2: Competitor Page Analysis

Analyze the top 5 ranking pages for the target keyword to identify gaps and opportunities.

What to analyze per competitor:

• Title tag and meta description approach
• Heading structure (H1, H2, H3 hierarchy)
• Content depth and word count
• Unique angles or topics covered
• Internal/external linking strategy
• Schema markup used
• Content freshness (publish/update dates)

Optional CLI command:

npx @karis-ai/cli chat --skill page-seo "Analyze top 5 ranking pages for '[keyword]'. For each:
- Title and meta description
- Heading structure
- Content depth and word count
- Unique angles covered
- Schema markup used
Identify content gaps and opportunities."

Output:

## Competitor Analysis — "[keyword]"

### Top 5 Pages

| # | Page | Word Count | Headings | Schema | Unique Angle |
|---|------|-----------|----------|--------|--------------|
| 1 | [url] | [count] | [count] | [type] | [angle] |
| 2 | [url] | [count] | [count] | [type] | [angle] |
| 3 | [url] | [count] | [count] | [type] | [angle] |
| 4 | [url] | [count] | [count] | [type] | [angle] |
| 5 | [url] | [count] | [count] | [type] | [angle] |

### Content Gaps
- [Topic/angle missing from most competitors]
- [Question not answered by any competitor]
- [Data point or example no one provides]

### Opportunities
- [How to differentiate]
- [Underserved subtopic]

Step 3: On-Page SEO Audit

Score the page across 10 on-page SEO factors. Generate a score from 0-100.

Scoring Rubric:

Factor	Weight	What to Check
Title Tag	15%	Contains keyword, 50-60 chars, compelling
Meta Description	15%	Contains keyword, 150-160 chars, includes CTA
H1 Tag	10%	Single H1, contains keyword, matches title intent
Heading Structure	10%	Logical H2-H3 hierarchy, keywords in subheadings
Image Optimization	10%	Alt text with keywords, compressed, descriptive filenames
Internal Links	10%	3+ relevant internal links, descriptive anchor text
External Links	5%	1-2 authoritative outbound links, opens in new tab
Social Meta	10%	Open Graph tags, Twitter Card, proper images
Content Quality	10%	Adequate length (1500+), covers topic depth, readable
Keyword Presence	5%	In first 100 words, URL, naturally distributed

Per-factor scoring:

• 9-10: Excellent — fully optimized
• 7-8: Good — minor improvements possible
• 5-6: Needs work — clear issues to fix
• 3-4: Poor — significant problems
• 0-2: Missing or critically broken

E-E-A-T Signals Checklist:

• Author byline with credentials
• Author bio page linked
• Sources cited for claims
• Publication/update dates visible
• About page accessible
• Contact information available
• First-hand experience demonstrated
• Unique data, screenshots, or examples

Optional CLI command:

npx @karis-ai/cli chat --skill page-seo "Audit this page for on-page SEO: [URL or paste content].
Score each factor out of 10:
Title Tag, Meta Description, H1, Heading Structure, Image Optimization,
Internal Links, External Links, Social Meta, Content Quality, Keyword Presence.
Calculate overall SEO Score (0-100)."

Output:

## On-Page SEO Audit — [Page Title]

### SEO Score: XX/100

| Factor | Weight | Score | Status | Issue |
|--------|--------|-------|--------|-------|
| Title Tag | 15% | X/10 | ✅/⚠️/❌ | [issue or "OK"] |
| Meta Description | 15% | X/10 | ✅/⚠️/❌ | [issue or "OK"] |
| H1 Tag | 10% | X/10 | ✅/⚠️/❌ | [issue or "OK"] |
| Heading Structure | 10% | X/10 | ✅/⚠️/❌ | [issue or "OK"] |
| Image Optimization | 10% | X/10 | ✅/⚠️/❌ | [issue or "OK"] |
| Internal Links | 10% | X/10 | ✅/⚠️/❌ | [issue or "OK"] |
| External Links | 5% | X/10 | ✅/⚠️/❌ | [issue or "OK"] |
| Social Meta | 10% | X/10 | ✅/⚠️/❌ | [issue or "OK"] |
| Content Quality | 10% | X/10 | ✅/⚠️/❌ | [issue or "OK"] |
| Keyword Presence | 5% | X/10 | ✅/⚠️/❌ | [issue or "OK"] |

### E-E-A-T Assessment
- [Present/missing signals]

### Priority Fixes
1. 🔴 [Critical fix]
2. 🟡 [Medium priority fix]
3. 🟢 [Nice to have]

Step 4: Content Optimization

Based on the audit and competitor analysis, optimize the page content.

What to optimize:

• Rewrite title tag and meta description
• Fix heading structure
• Add missing keyword placements (naturally)
• Suggest internal/external links to add
• Recommend schema markup type (see references/schema-templates.md)
• Improve E-E-A-T signals

Optional CLI command:

npx @karis-ai/cli chat --skill page-seo "Optimize this content for '[keyword]'. Based on the audit:
- Rewrite title tag and meta description
- Fix heading structure
- Add keyword placements naturally
- Suggest internal and external links
- Recommend schema markup type
- Improve E-E-A-T signals"

Output:

## Content Optimization — [Page Title]

### Rewritten Meta Tags
- **Title**: [new title, 50-60 chars]
- **Meta Description**: [new description, 150-160 chars]

### Heading Structure (Revised)
- H1: [heading]
  - H2: [heading]
    - H3: [heading]
  - H2: [heading]
  - H2: [heading]

### Keyword Placements
- First paragraph: [suggestion]
- Subheadings: [which H2s to include keyword]
- Image alt text: [suggestions]

### Links to Add
**Internal:**
- [anchor text] → [target page]
- [anchor text] → [target page]

**External:**
- [anchor text] → [authoritative source]

### Recommended Schema
- Type: [Article/Product/FAQ/HowTo/etc.]
- See template: [references/schema-templates.md](references/schema-templates.md)

### E-E-A-T Improvements
- [Specific recommendation]
- [Specific recommendation]

Output Format

Final combined report:

# Page SEO Report — [Page Title]
**Target Keyword:** [keyword]
**Date:** [date]

## SEO Score: XX/100

## Keyword Research
[Step 1 output]

## Competitor Analysis
[Step 2 output]

## On-Page Audit
[Step 3 output]

## Optimization Plan
[Step 4 output]

## Next Steps
1. [Most impactful change]
2. [Second priority]
3. [Third priority]

Scoring Reference

Score Calculation

Overall SEO Score = Sum of (factor_score / 10 * weight * 100)

Factor	Weight
Title Tag	15%
Meta Description	15%
H1 Tag	10%
Heading Structure	10%
Image Optimization	10%
Internal Links	10%
External Links	5%
Social Meta	10%
Content Quality	10%
Keyword Presence	5%

Score Interpretation

Score	Rating	Meaning
90-100	Excellent	Page is well-optimized, focus on content freshness
75-89	Good	Minor improvements needed, competitive for most keywords
60-74	Needs Work	Clear gaps affecting ranking potential
40-59	Poor	Significant on-page issues, unlikely to rank
0-39	Critical	Major SEO problems, needs complete overhaul

Best Practices

1. Start with keyword research — Don't optimize without knowing what to optimize for
2. Check competitors first — Understand what's already ranking before writing
3. Fix technical issues before content — Title tags and meta descriptions are quick wins
4. Write for users, optimize for engines — Keyword stuffing hurts rankings
5. One primary keyword per page — Avoid keyword cannibalization across pages
6. Update regularly — Search engines favor fresh, maintained content
7. Measure after changes — Track ranking position changes after optimization
8. Use schema markup — Structured data improves rich snippet eligibility

Related Skills

• aeo-geo: Optimize for AI search engines (ChatGPT, Perplexity, Claude) — complementary to traditional SEO
• brand-intel: Establish brand context before page-level optimization
• reddit-growth: Drive initial traffic and backlinks to optimized pages