home / skills / gtmagents / gtm-agents / on-page

on-page skill

safe

/plugins/seo/skills/on-page

This skill helps craft or refresh on-page content by aligning copy, UX, and conversion goals with keyword strategy.

npx playbooks add skill gtmagents/gtm-agents --skill on-page

Review the files below or copy the command above to add this skill to your agents.

Files (1)

SKILL.md

1.3 KB

---
name: on-page
description: Use when crafting or refreshing pages to align copy, UX, and conversion
  goals with target keywords.
---

# On-Page Optimization Checklist

## When to Use
- Writing a new page or blog post targeting a specific keyword cluster.
- Refreshing an existing asset to regain rankings.
- QA before publishing to ensure metadata/structure compliance.

## Framework
1. **Search Intent Match** – confirm headline + intro address intent quickly.
2. **Metadata** – title <60 chars with primary keyword, compelling meta description, og tags.
3. **Structure** – H1 exact match, H2/H3 covering supporting terms, TOC for long form.
4. **Copy Enhancements** – add stats, quotes, proof points, multimedia blocks.
5. **Internal/External Links** – link to pillar + related clusters; cite credible sources.
6. **Conversion Hooks** – contextual CTAs, sticky bars, lead magnets.
7. **Accessibility** – descriptive alt text, ARIA labels, high contrast.
8. **Structured Data** – FAQ, HowTo, Article schema as relevant.

## Templates
- Optimization diff table (Element, Current, Recommended, Rationale).
- CTA matrix aligning funnel stage with offers.
- Internal link planner.

## Tips
- Keep paragraph length 2–3 sentences for readability.
- Embed video/audio transcripts for multimedia.
- Track refresh date + metrics to measure impact.

---

Overview

This skill helps craft and refresh on-page content to align copy, UX, and conversion goals with target keywords. It provides a practical checklist and templates to validate metadata, structure, accessibility, and conversion hooks. Use it to ensure pages match search intent and are optimized for ranking and user engagement.

How this skill works

The skill inspects headline and intro for intent alignment, evaluates metadata (title, meta description, OG tags), and checks content structure (H1, H2/H3, TOC). It flags copy improvements like proof points and multimedia blocks, validates internal/external linking, checks accessibility elements, and recommends structured data types. It produces actionable recommendations, an optimization diff table, and a CTA matrix to close gaps.

When to use it

Creating a new page or blog post targeting a specific keyword cluster
Refreshing an existing asset to regain or improve rankings
Performing QA before publishing to ensure metadata and structure compliance
Aligning on-page copy with conversion goals and funnel offers
Preparing content for accessibility and schema markup

Best practices

Match headline and opening paragraph to primary search intent immediately
Keep title under 60 characters and include the primary keyword
Use H1 for the exact topic term and H2/H3 to cover supporting search terms
Add proof points (stats, quotes, case links) and multimedia with transcripts
Plan internal links to pillar pages and related clusters; cite credible external sources
Include contextual CTAs and map them to funnel stages using a CTA matrix

Example use cases

Optimize a product landing page to improve organic conversions and reduce bounce
Refresh a dated blog post with updated stats, structured data, and new CTAs
Run a pre-launch QA to ensure metadata, TOC, and accessibility standards are met
Create an internal link plan that channels topical authority to pillar pages
Build an optimization diff table to hand off prioritized fixes to content and dev teams

FAQ

Does the skill recommend specific schema types?

Yes. It suggests relevant structured data like Article, FAQ, and HowTo based on page content.

How does it handle multimedia?

It recommends embedding multimedia with transcripts, descriptive alt text, and placement that supports intent and dwell time.