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
npx skills add gtmagents/gtm-agents --skill seo-writing -a claude-codeWhat 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 pricingwith 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-code2Manually: put the files in place
~/.claude/skills/seo-writing/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/seo-writing/
1Skills CLI (Vercel)
npx skills add gtmagents/gtm-agents --skill seo-writing -a codex2Manually: put the files in place
.agents/skills/seo-writing/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add gtmagents/gtm-agents --skill seo-writing -a cursor2Manually: put the files in place
.cursor/skills/seo-writing/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install gtmagents/gtm-agents plugins/content-marketing/skills/seo-writing2Manually: put the files in place
.github/skills/seo-writing/SKILL.md1Skills CLI (Vercel)
npx skills add gtmagents/gtm-agents --skill seo-writing -a gemini-cli2Platform CLI
gemini skills install https://github.com/gtmagents/gtm-agents --path plugins/content-marketing/skills/seo-writingManually: put the files in place
.devin/skills/seo-writing/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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