home / skills / gtmagents / gtm-agents / seo-writing

seo-writing skill

/plugins/content-marketing/skills/seo-writing

This skill helps plan and draft SEO-optimized content that aligns keyword intent with GTM messaging to boost rankings and conversions.

npx playbooks add skill gtmagents/gtm-agents --skill seo-writing

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

Files (1)

SKILL.md

1.7 KB

---
name: seo-writing
description: Use when planning or drafting search-optimized content that balances keyword intent with GTM messaging.
---

# SEO Writing Skill

## When to Use
- Need pillar/blog content that ranks for a target keyword cluster.
- Building briefs for writers or agencies.
- Auditing existing posts for optimization opportunities.

## Framework
1. **Intent Mapping** – classify keyword as informational, navigational, transactional; align CTA accordingly.
2. **SERP Analysis** – review top 10 results, note content format, length, missing gaps.
3. **Outline Structure** – mirror winning patterns while adding unique POV/data.
4. **On-Page Elements** – optimize title tag (<60 chars), meta description, H1/H2, schema, image alt text.
5. **Internal/External Links** – add minimum 3 internal + 3 authoritative external links.
6. **Conversion Hooks** – insert CTA blocks, lead magnets, or inline product mentions every ~500 words.

## Templates
- Keyword brief template with intent, primary/secondary keywords, CTA, internal targets.
- SERP gap analysis worksheet capturing competitor format, word count, differentiators.
- SEO QA workflow checklist (draft → optimization → publish → refresh schedule).

## Tips
- Refresh top posts quarterly—update stats, add new internal links, re-fetch schema.
- Use heatmaps/scroll data to validate placement of conversion hooks.
- Coordinate with demand gen to align CTAs with current offers.
- Keep keyword cannibalization tracker so multiple teams don’t target same phrase.

## Checklist
- Include primary keyword in H1 + first 100 words.
- Use semantic variants (LSI terms) per section.
- Ensure readability score < grade 9.
- Add FAQ or snippet-ready section.

---

Overview

This skill helps plan and draft search-optimized content that balances keyword intent with go-to-market messaging. It provides a repeatable framework for mapping intent, analyzing the SERP, and structuring outlines that convert. Use it to produce briefs, optimize drafts, and set a regular refresh cadence for high-value pages.

How this skill works

The skill classifies target keywords by intent (informational, navigational, transactional) and aligns CTAs accordingly. It performs SERP analysis to identify top formats, word counts, and content gaps, then generates an outline that mirrors winning patterns while adding unique data or POV. It also prescribes on-page elements, linking strategy, and conversion hooks to maximize rankings and lead capture.

When to use it

Creating pillar content or blog posts aimed at ranking a target keyword cluster
Building detailed briefs for writers or external agencies
Auditing existing posts to identify optimization and conversion opportunities
Planning quarterly refreshes for top-performing pages
Aligning content with demand-gen campaigns and current offers

Best practices

Map keyword intent first and match the CTA to that intent
Perform top-10 SERP analysis to capture format, length, and gaps before outlining
Include primary keyword in H1 and within the first 100 words
Add at least 3 internal and 3 authoritative external links per long-form piece
Insert conversion hooks (CTA, lead magnet, product mention) roughly every 500 words
Schedule quarterly refreshes for high-traffic posts and update stats and links

Example use cases

Create a keyword brief for a new pillar targeting an informational cluster with mid-funnel CTAs
Draft an optimized blog outline after a SERP gap analysis for a transactional keyword
Run an SEO QA workflow on a published post to improve snippet potential and readability
Build a content calendar with refresh dates and internal linking targets to reduce cannibalization
Coordinate content CTAs with demand-gen offers to boost conversion rates from organic traffic

FAQ

How many internal and external links should I include?

Aim for a minimum of three internal links and three authoritative external links for long-form pieces; adjust based on page length and topic relevance.

How often should I refresh top posts?

Quarterly is a good baseline: update stats, add new internal links, revalidate schema, and fill any content gaps found in recent SERPs.

What readability target should I use?

Keep readability around or below grade 9 to maximize clarity and accessibility for broad audiences.