# seoagent

Runs SEO work inside your repo: audits, keyword clusters, briefs and article drafts land in .seoagent/, so each session picks up where the last one stopped.

- skill · `type=skill` · Claude Code · 69 installs
- Author: davila7
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/business-marketing/seoagent
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/skills/seoagent

## What it does

The skill works in five phases. It starts with a technical audit: key pages get checked for indexability, `title` tags, meta descriptions, heading structure, internal links, JSON-LD and Core Web Vitals readiness. Findings go to `.seoagent/audit/latest.md` as `[ ]` checkboxes tagged `critical`, `high`, `medium` or `low`; flip one to `[x]` once it is fixed.

Then comes a hub-and-spoke plan. A broad PILLAR page sits at the top, SUB_PILLAR pages cover focused subtopics, LONG_TAIL pages answer narrow queries, and internal links push authority upward. Briefs follow the page type — a landing page gets one protocol, a long-tail page another — and each brief carries a URL pattern, an H2/H3 outline, a link plan, a JSON-LD plan and a word-count target. Drafts are written from the brief with full SEO frontmatter and `Article`, `FAQPage` or `HowTo` markup.

Everything persists under `.seoagent/` in the repo: `project.md`, `context.md`, `strategy/clusters/`, `briefs/`, `content/`, `roadmap.md`, `changelog.md`. The skill reads what is already there before acting. Your data stays local. There is also an AEO/GEO angle: content is shaped so answer engines can cite it — a direct answer up front, question-style headings, comparison tables, FAQ markup.

The `@seoagent-official/seoagent` CLI and the optional cloud loop are a separate product, not part of this skill. They scaffold an expanded protocol library and add keyword data, Search Console and CMS publishing.

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --skill business-marketing/seoagent
```

2. **Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill seoagent -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/seoagent/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/seoagent/

### Codex

**Manually: put the files in place**
- File: `.agents/skills/seoagent/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

**Manually: put the files in place**
- File: `.cursor/skills/seoagent/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install davila7/claude-code-templates seoagent
```

2. **Manually: put the files in place**
- File: `.github/skills/seoagent/SKILL.md`

### Gemini CLI

**Platform CLI**
```bash
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/business-marketing/seoagent
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/seoagent/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/business-marketing/seoagent

## When to use it
- check indexability and canonical tags on key pages
- split a niche into hubs, subtopics and long-tail queries
- write a brief for a specific page type
- draft an article with JSON-LD and metadata
- resume SEO work and read back earlier findings

## Example prompts
- Run a technical SEO audit of the site and save the findings to `.seoagent/audit/latest.md`
- Build keyword clusters for our blog and write them to `.seoagent/strategy/clusters/`
- Write a brief for the pricing page, then draft the article with `FAQPage` markup

## Similar
- [seo-content-marketing-command-suite](https://affpapa.org/en/nevibecode/skills/seo-content-marketing-command-suite.md) — skill · 899 installs
- [seo-competitor-pages](https://affpapa.org/en/nevibecode/skills/seo-competitor-pages.md) — skill · 7600 installs
- [blog-cannibalization](https://affpapa.org/en/nevibecode/skills/blog-cannibalization.md) — skill · 2500 installs
- [keyword-research](https://affpapa.org/en/nevibecode/skills/aaron-he-zhu-keyword-research.md) — skill · 1900 installs
- [claude-code-seo-content-marketing-suite](https://affpapa.org/en/nevibecode/skills/claude-code-seo-content-marketing-suite.md) — skill · 950 installs
- [serp-markup-builder](https://affpapa.org/en/nevibecode/skills/serp-markup-builder.md) — skill · 1400 installs

From the same set: [davila7/claude-code-templates](https://affpapa.org/en/nevibecode/by/davila7/claude-code-templates.md) — 495 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md