Skip to main content
skill CX Codex

seo-writing — Claude Code skill: what it does, how to install

seo-writing is a Claude Code skill that plans and drafts search-optimized articles connecting keyword intent with product positioning. It supports writer briefs and blog audits.

Apache-2.0 ★ 450 updated 2026-04-03

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add gtmagents/gtm-agents --skill seo-writing -a claude-code
Open on GitHub

What seo-writing does

The skill organizes search content production across six stages. It categorizes user intent, breaks down top 10 search results, builds article outlines, defines on-page metadata, and suggests CTA blocks every ~500 words.

It includes ready-to-use brief templates, a competitor gap worksheet, and a pre-publish QA checklist. Guardrails require inserting the main keyword into H1 and the first 100 words, including at least three internal and three external references, and keeping the readability score below grade 9.

Without manual SERP data and current product offers, the agent cannot identify competitor blind spots on its own: you still need to supply the SERP context.

What it helps with

  • create writer briefs with mapped intent and internal link targets
  • audit existing blog posts against search competitors
  • generate outlines with conversion hooks every 500 words
  • optimize title tags, meta descriptions, and schema markup

Example prompts for the agent

  • Create an SEO content brief for the keyword vector database pricing with intent mapping
  • Audit this draft article against the seo-writing checklist and generate an FAQ section
  • Structure a pillar post outline with conversion hooks every 500 words and 3 internal links

How to install seo-writing

1Skills CLI (Vercel)

npx skills add gtmagents/gtm-agents --skill seo-writing -a claude-code

2Manually: put the files in place

~/.claude/skills/seo-writing/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/seo-writing/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about seo-writing

How do I install seo-writing in Claude Code?

Run npx skills add gtmagents/gtm-agents --skill seo-writing -a claude-code. Alternatively, save the file directly to ~/.claude/skills/seo-writing/SKILL.md.

What does the seo-writing skill do?

It provides a step-by-step framework to plan, draft, and audit search articles. It aligns search intent with product messaging, on-page optimization, and conversion hooks.

What checks are included in the quality checklist?

The checklist verifies the primary keyword in H1 and the opening 100 words, requires at least 3 internal and 3 external links, enforces a readability score under grade 9, and ensures an FAQ section for snippets.

Source text

SKILL.md · Apache-2.0
---
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.

---

© gtmagents · Apache-2.0 · gtmagents/gtm-agents

Similar skills

All skills for SEO and GEO →

From the same set224

The whole set →
build-co-sell-playbook build-co-sell-playbook is a Claude Code command that builds a partner co-sell playbook with engagement cadences, enablement materials, and deal attribution rules. CX Codex +1 ★ 450repo stars run-brand-governance-council run-brand-governance-council — a slash command that runs a brand governance council session: consolidates intake, holds reviews, queues asset audits and produces executive reporting. CX Codex +1 ★ 450repo stars launch-quantitative-survey The launch-quantitative-survey command for Claude Code plans quantitative surveys, supports fieldwork, and analyzes results through segmentation or scenario modeling. CX Codex +1 ★ 450repo stars launch-experiment launch-experiment turns an approved hypothesis into an instrumented experiment with guardrails and a rollout schedule. Use it when the design is signed off and the test needs to go live. CX Codex +1 ★ 450repo stars social-selling social-selling is a Claude Code skill for starting warm prospect conversations through LinkedIn and online communities. It guides social outreach that can turn interest in posts or webinars into meetings. CX Codex +1 ★ 450repo stars analyze-call analyze-call breaks down a call recording or transcript into metrics, key moments, risks and action items for sales teams. CX Codex +1 ★ 450repo stars build-battlecard-suite build-battlecard-suite generates battlecards, objection-handling scripts, and enablement packs against competitors for sales or product teams. Formats output into decks, docs, Notion, or PDF. CX Codex +1 ★ 450repo stars update-api-reference The update-api-reference command for Claude Code compares API schemas with earlier versions and drafts docs, guides, and changelog updates as endpoints or parameters change. CX Codex +1 ★ 450repo stars

Project sponsors

Companies that keep this analytics open