seo-on-page
Skill9 starsChanged 8 months agoMITView on GitHub
On-page SEO optimization for titles, meta descriptions, headings, content structure, and internal linking. Use when optimizing pages for search.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- ronaldships/foundvia-discoverytheir own version, first seen Oct 6, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- ronaldships/foundvia-discovery★ 29same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository73 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- ab-testingSkill
- analytics-attributionSkill
- analytics-dashboardsSkill
- cohort-analysisSkill
- marketing-reportingSkill
- brand-architectureSkill
- brand-guidelinesSkill
- brand-positioningSkill
- brand-voiceSkill
- competitive-positioningSkill
- visual-identitySkill
- community-strategySkill
- blog-seo-writingSkill
- content-auditSkill
- content-pillarsSkill
- content-repurposingSkill
- editorial-calendarSkill
- storytelling-frameworksSkill
- thought-leadershipSkill
- ugc-strategySkill
- ad-copySkill
- copywriting-frameworksSkill
- cta-optimizationSkill
- headline-formulasSkill
- landing-page-copySkill
- microcopy-uxSkill
- sales-page-copySkill
- campaign-conceptsSkill
- cro-frameworksSkill
- funnel-designSkill
- landing-page-optimizationSkill
- email-automationSkill
- email-copywritingSkill
- email-deliverabilitySkill
- email-segmentationSkill
- email-sequencesSkill
- growth-loopsSkill
- plg-strategiesSkill
- referral-programsSkill
- viral-mechanicsSkill
- influencer-outreachSkill
- influencer-roiSkill
- martech-stackSkill
- utm-trackingSkill
- ad-creative-testingSkill
- budget-allocationSkill
- google-adsSkill
- linkedin-adsSkill
- meta-adsSkill
- retargetingSkill
- crisis-communicationSkill
- media-pitchingSkill
- competitive-analysisSkill
- go-to-marketSkill
- launch-playbookSkill
- product-positioningSkill
- press-releasesSkill
- customer-interviewsSkill
- The first 60 shown.
The file
Show its rules and text
We split this skill into the rules it gives an agent
15 rules. About 0 are common, 10 are distinctive, and 5 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈10
Distinctive · estimate
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 11
Use this skill when optimizing individual pages for search engine visibility: writing or improving title tags, meta descriptions, headings, …
- Distinctive: line 31
Unique: Every page must have a unique title tag
- Distinctive: line 73
Unique: Every page needs a unique meta description
- Distinctive: line 95
Ensure the description accurately summarizes the page content
- Distinctive: line 96
Don't use the same description template across many pages
- Distinctive: line 158
Cover related entities: If writing about "email marketing," also cover segments, automation, deliverability, open rates, CTR, A/B testing, …
- Distinctive: line 159
Answer related questions: Use "People Also Ask" as a content outline
- Distinctive: line 175
Don't start with "Image of" or "Photo of" (screen readers already announce it as an image)
- Very specific: line 184
Use descriptive, hyphenated names: email-marketing-strategy-framework.webp
- Very specific: line 189
Use responsive images with srcset
- Very specific: line 239
Use hyphens, not underscores: /email-marketing/ not /email_marketing/
- Very specific: line 242
No stop words unless needed for readability: /how-to-write-cold-emails/ is fine, /a-guide-to-the-best-of-email/ is not
- Distinctive: line 243
No dates in URLs (makes content appear dated when you refresh it)
- Very specific: line 244
Use logical hierarchy: /blog/email-marketing/ or /products/crm/
- Distinctive: line 245
Never change URLs without implementing 301 redirects
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
On-Page SEO
When to Activate
Use this skill when optimizing individual pages for search engine visibility: writing or improving title tags, meta descriptions, headings, content structure, internal links, image optimization, or URL structure. Applies to blog posts, product pages, landing pages, category pages, and any page targeting organic search traffic.
First Questions
- What is the target keyword (and its search intent)?
- What currently ranks in the top 10 for this keyword? (analyze the SERP)
- Is this a new page or an optimization of an existing one?
- What page type is it? (blog post, product page, category page, landing page)
- What is the content's primary goal beyond ranking? (conversions, education, link building)
Title Tag Optimization
The title tag is the single most important on-page ranking factor and the primary driver of click-through rate from SERPs.
Rules
- Length: 50-60 characters (Google truncates at ~580px, roughly 60 chars)
- Keyword placement: Primary keyword as close to the beginning as possible
- Unique: Every page must have a unique title tag
- Compelling: The title must earn the click, not just contain the keyword
- Brand: Include brand name at the end for branded searches (optional for long-tail)
Title Tag Formulas
[Primary Keyword]: [Benefit or Hook] | [Brand]
[Primary Keyword] — [Modifier: Guide/Tips/Examples] ([Year])
How to [Primary Keyword] in [Timeframe] ([Year])
[Number] [Primary Keyword] [Tips/Examples/Strategies] for [Year]
[Primary Keyword]: What It Is + How to [Action] ([Year])Examples
| Target Keyword | Title Tag | Chars |
| email marketing strategy | Email Marketing Strategy: The 2026 Playbook | 46 |
| best CRM for startups | 9 Best CRMs for Startups (Tested & Ranked 2026) | 49 |
| how to write a cold email | How to Write a Cold Email That Gets Replies (2026) | 51 |
| content marketing ROI | Content Marketing ROI: How to Measure It + Benchmarks | 55 |
Common Mistakes
- Keyword stuffing: "CRM Software | Best CRM | Top CRM Tool | CRM Reviews"
- Too long: getting truncated in SERPs
- Too short: missing the opportunity for CTR-boosting modifiers
- Duplicate titles across multiple pages
- Missing the search intent (informational title for a transactional query)
Meta Description Optimization
Meta descriptions don't directly affect rankings but significantly impact CTR, which indirectly affects rankings.
Rules
- Length: 120-155 characters (Google truncates at ~920px on desktop)
- Include target keyword: Google bolds matching terms in the SERP
- Include a CTA: Tell searchers what they'll get or do
- Match search intent: The description must deliver on what the searcher wants
- Unique: Every page needs a unique meta description
- Active voice: "Learn how to..." beats "This article discusses..."
Meta Description Template
[Hook or benefit statement]. [Supporting detail with keyword]. [CTA — Learn/Discover/Get/See].Examples
| Keyword | Meta Description | Chars |
| email open rates | Your email open rates are declining. Here are 11 proven tactics to boost opens by 30%+ in 2026. See what actually works. | 119 |
| landing page best practices | Learn the 12 landing page best practices that top-converting pages share. Includes templates, examples, and a free checklist. | 123 |
| B2B content strategy | Build a B2B content strategy that drives pipeline, not just pageviews. Step-by-step guide with templates and real examples. | 120 |
When Google Rewrites Your Meta Description
Google rewrites meta descriptions ~70% of the time. To reduce rewrites:
- Make the description highly relevant to the target query
- Include the exact keyword phrase naturally
- Ensure the description accurately summarizes the page content
- Don't use the same description template across many pages
Heading Hierarchy (H1-H6)
Headings structure your content for both readers and search engines.
Rules
- One H1 per page — Contains the primary keyword, closely mirrors the title tag
- H2s for major sections — 4-8 H2s for a standard blog post
- H3s for subsections — Under each H2 as needed
- Never skip levels — Don't go from H2 to H4 without an H3
- Include keywords naturally — Primary keyword in H1, secondary keywords in H2s and H3s
- Use headings for structure, not styling — Don't use H3 just because you want smaller bold text
Example Heading Structure
H1: How to Build a B2B Content Strategy That Drives Revenue
H2: What Is a B2B Content Strategy?
H2: Why Most B2B Content Strategies Fail
H3: Mistake 1: Creating Content Without a Funnel Map
H3: Mistake 2: Ignoring Search Intent
H3: Mistake 3: No Distribution Strategy
H2: The 6-Step B2B Content Strategy Framework
H3: Step 1: Define Your ICP and Buying Journey
H3: Step 2: Conduct Keyword Research by Funnel Stage
H3: Step 3: Create a Topic Cluster Map
H3: Step 4: Build Your Editorial Calendar
H3: Step 5: Write and Optimize Content
H3: Step 6: Distribute and Promote
H2: B2B Content Strategy Template (Free Download)
H2: Measuring Content Strategy ROI
H3: Leading Indicators
H3: Lagging Indicators
H2: Frequently Asked QuestionsKeyword Placement (Natural and Semantic)
Where to Place Keywords
| Location | Primary Keyword | Secondary Keywords | Notes |
| Title tag | Yes, front-loaded | One if space allows | Most important placement |
| Meta description | Yes | Yes | Bolded in SERP |
| H1 | Yes | No | Should match title closely |
| URL slug | Yes (simplified) | No | Short and clean |
| First 100 words | Yes, naturally | No | Signals topic to Google |
| H2 headings | Some, naturally | Yes | Cover subtopics |
| Body content | 3-5x naturally | Throughout | Never force it |
| Image alt text | Once if relevant | Yes | Describe the image first |
| Image file name | Yes if relevant | No | Use hyphens: content-strategy-template.webp |
Semantic SEO (Entity Optimization)
Google understands topics, not just keywords. Optimize for topical depth:
- Cover related entities: If writing about "email marketing," also cover segments, automation, deliverability, open rates, CTR, A/B testing, DKIM, SPF
- Answer related questions: Use "People Also Ask" as a content outline
- Use natural language variations: "email marketing strategy," "strategy for email marketing," "marketing via email," "email campaigns"
- Include definitions and context: Help Google understand the semantic relationships between concepts
Image Optimization for SEO
Alt Text
Alt text serves two purposes: accessibility (screen readers) and SEO (image search ranking).
Rules:
- Describe what the image shows, accurately and concisely
- Include the keyword naturally if the image is relevant to the topic
- 80-125 characters
- Don't start with "Image of" or "Photo of" (screen readers already announce it as an image)
Examples:
- Bad:
alt="image" - Bad:
alt="email marketing strategy email marketing tips best email marketing" - Good:
alt="Bar chart showing email open rates by industry for 2026" - Good:
alt="Content strategy template with editorial calendar and topic clusters"
File Names
- Use descriptive, hyphenated names:
email-marketing-strategy-framework.webp - Not:
IMG_3847.jpgorscreenshot-2026-03-01.png
Image Sizing and Format
- Serve images in WebP or AVIF format
- Use responsive images with
srcset - Compress to 80-85% quality
- Lazy load images below the fold
Internal Linking Strategy
Internal links distribute PageRank, establish content hierarchy, and help Google discover pages.
Rules
- Every page should link to and from at least 2-3 other relevant pages
- Use descriptive anchor text — Not "click here" but "email marketing strategy guide"
- Link to high-priority pages more often — Your most important pages should have the most internal links
- Link contextually — Links should appear naturally within the content where they add value
- Link deep — Link to specific blog posts and pages, not just the homepage and category pages
- Fix orphan pages — Every important page must be reachable through internal links
Internal Linking Patterns
Hub and Spoke (Topic Clusters):
- Pillar page (hub) links to all related cluster pages (spokes)
- Each spoke links back to the hub
- Spokes link to each other where relevant
Contextual Links:
- Mention a concept? Link to the page where you cover it in depth
- "As we discussed in our [guide to email deliverability]..."
Navigation Links:
- Breadcrumbs, sidebar, footer, related posts sections
- These provide structural context but carry less weight than in-body contextual links
Anchor Text Best Practices
| Type | Example | When to Use |
| Exact match | "email marketing strategy" | Sparingly — once or twice per cluster |
| Partial match | "our guide to email marketing" | Primary approach — natural and effective |
| Branded | "learn more on the HubSpot blog" | When referencing your brand contextually |
| Generic | "click here," "read more" | Avoid — wastes anchor text opportunity |
| Natural phrase | "improving your email open rates" | Best for user experience and SEO |
URL Structure
Rules
- Short and descriptive:
/email-marketing-strategy/not/blog/2026/03/14/the-complete-guide-to-email-marketing-strategy-for-beginners/ - Use hyphens, not underscores:
/email-marketing/not/email_marketing/ - Lowercase only
- Include the primary keyword
- No stop words unless needed for readability:
/how-to-write-cold-emails/is fine,/a-guide-to-the-best-of-email/is not - No dates in URLs (makes content appear dated when you refresh it)
- Use logical hierarchy:
/blog/email-marketing/or/products/crm/ - Never change URLs without implementing 301 redirects
Content Readability
Readability Rules for SEO Content
- Short paragraphs: 2-4 sentences maximum
- Subheadings every 200-300 words: Breaks up walls of text, adds keyword opportunities
- Bullet points and numbered lists: For scannable information
- Bold key phrases: Helps skimmers find important information
- Table of contents: For posts over 1,500 words (also helps win sitelinks in SERPs)
- Reading level: Aim for 7th-9th grade reading level (Hemingway Editor or Flesch-Kincaid)
- Active voice: "We analyzed 1,000 landing pages" not "1,000 landing pages were analyzed"
- Multimedia: Include images, charts, or videos every 300-500 words
On-Page SEO Checklist
Before Publishing
- Title tag: 50-60 chars, keyword front-loaded, compelling, unique
- Meta description: 120-155 chars, keyword included, CTA present, unique
- H1: Contains primary keyword, closely matches title tag, only one per page
- URL: Short, descriptive, keyword included, hyphens, lowercase
- First 100 words: Primary keyword appears naturally
- Headings: Logical H2/H3 hierarchy with secondary keywords
- Internal links: 3-5+ relevant internal links with descriptive anchor text
- External links: 2-3 links to authoritative, relevant sources
- Images: Alt text on all images, descriptive file names, WebP format, lazy loaded
- Content length: Matches or exceeds what's ranking in the top 10 for this keyword
- Search intent match: Content format matches what Google rewards for this query
- Schema markup: Appropriate structured data (Article, FAQ, HowTo, etc.)
After Publishing
- Submit URL to Google Search Console for indexing
- Verify no indexing issues in URL Inspection tool
- Add internal links from existing related pages to the new page
- Monitor rankings and impressions in Search Console over 4-8 weeks
Quality Gate
- Title tag and meta description are within character limits and include the target keyword
- Content fully satisfies the search intent behind the target keyword
- Heading hierarchy is logical and includes keyword variations naturally
- At least 3 internal links point to and from the page
- All images have descriptive alt text and are optimized for performance
- URL is clean, short, and keyword-inclusive
- Content readability is appropriate for the target audience
- Page is indexed and rendering correctly in Search Console
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

