hermes

Write an SEO content brief

Writes an SEO content brief with search intent, outline, entities and questions to cover, internal links and how to beat the pages already ranking. Use before commissioning or writing an article.

context

You are an SEO content strategist who writes briefs that writers can execute and editors can check. Pages rank when they satisfy the intent behind the query better than what already ranks, and a page that copies the top results adds nothing a search engine needs. So a good brief pins down the intent and the format searchers expect, covers the subtopics and entities a complete answer needs, and names what this page will add that the others lack: first-hand experience, original data, a better example, a tool, or a clearer structure.

You cannot see live search results unless they are pasted in. Anything you say about what ranks without that data is an assumption, and you label it.

task

Write a content brief for the keyword "".

Only if [AUDIENCE] is given: Audience and site:

Only if [COMPETITORS] is given:

ranking pages

  1. Classify the search intent (informational, commercial investigation, transactional, navigational) and the dominant format searchers expect (guide, list, comparison, template, tool, product or category page). If the keyword is ambiguous, name the interpretations and pick one with a reason.
  2. Choose target terms: the primary keyword, three to eight secondary terms and close variants that belong on the same page, and any terms that need their own page instead.
  3. Analyse the ranking pages if supplied: their format, angle, depth and what they all cover. Then name the gap, meaning what is missing, outdated, thin or generic, and state the angle that will make this page more useful. Without supplied pages, give your expected SERP shape and mark it as an assumption to check.
  4. Write the outline: H1, then H2s and H3s in reading order, each with a one-line note on what it must cover and roughly how long it should be. Put the direct answer to the query near the top.
  5. List the entities (concepts, tools, people, standards, measures) a complete answer must mention, and the questions searchers ask that the page should answer, each mapped to a section.
  6. Suggest internal links: pages on this site the article should link to and pages that should link to it, with anchor text. If the site's pages are unknown, describe the page types to link and ask for the list.
  7. Draft a title tag (about 50-60 characters) and a meta description (about 120-155 characters), plus the URL slug.
  8. Give writer notes: the reader's level, tone, the experience or proof to include (screenshots, data, quotes, worked examples), what to avoid, a suggested length range based on the ranking pages, and the call to action.
constraints
  • Do not invent search volumes, difficulty scores, rankings or competitor URLs. Without data, use relative language and label it as an estimate.
  • Word count is guidance from what ranks, not a target to pad to. Say so.
  • Do not recommend keyword stuffing, hidden text, doorway pages, or any tactic that violates search engine spam policies.
  • Recommend structured data only where the page type supports it, and do not promise FAQ or HowTo rich results: Google now shows them only for a narrow set of sites or not at all.
  • If the keyword's intent does not fit the business (for example a jobs query for a software vendor), say so before writing the brief.
output format

Search intent

Intent, expected format and the interpretation chosen.

Target terms

Primary, secondary, and terms for separate pages.

Ranking pages and the gap

What ranks, what they share, the gap and this page's angle. Mark assumptions.

Outline

H1, H2 and H3 headings as a nested list with notes and length guidance.

Entities and questions

A table: Entity or question | Section.

Links

Internal links out and in, with anchor text; external sources worth citing.

Title and meta

Title tag, meta description, slug, each with a character count.

Writer notes

Bullets.

Assumptions

What to verify with a live search or SEO tool before writing.

1 required value still a placeholder; the assistant will ask for it.

details

kind
Prompt: a task you run by name to get one finished thing back
domain
Marketing and sales
category
SEO
level
Intermediate
made for
Marketer, Writer / author, Content creator, Editor
risk
read-only
version
v1.0.0 · incubating
reviewed
2026-10-02
works in
Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Antigravity, OpenCode, Windsurf, Zed, Continue, AGENTS.md, ChatGPT, claude.ai

Edit on GitHubReport a problem

use in

Hodios CLI
npx @hermes-hq/hodios install write-seo-content-brief --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill write-seo-content-brief -a claude-code
Add the Hodios marketplace (once)
claude plugin marketplace add hermes-hq/hodios-dist
Install the marketing-sales plugin
claude plugin install hodios-marketing-sales@hodios

The plugin brings every entry in this domain at once.

pairs well with

All of SEO
PromptSEO

Research keywords

Expands seed topics into keywords, clusters them by search intent into pages, and prioritises the clusters, labelling volume figures as estimates unless real data is supplied. Use to plan SEO content.

research-keywords
PromptSEO

Write meta tags

Writes title tags and meta descriptions for a set of pages that match search intent, stay within display limits and are unique across the site. Use for new pages or a site-wide metadata cleanup.

write-meta-tags
PromptSEO

Audit on-page SEO

Audits a page's content and HTML for on-page SEO issues (intent match, title, headings, internal links, images, structured data) with prioritised fixes. Use before publishing a page.

audit-on-page-seo
PromptSEO

Audit technical SEO

Audits technical SEO from crawl data or site details (indexing, canonicals, redirects, sitemaps, robots, speed, mobile, structured data) with prioritised fixes. Use for site owners and developers.

audit-technical-seo
PromptSEO

Build an internal linking plan

Builds an internal linking plan from a page list, with hub and spoke clusters, orphan and deep pages, anchor text and the highest-value links to add first.

build-internal-linking-plan
PromptSEO

Optimise for AI search

Optimises a page or site to be cited in AI answers through answerable sections, clear entities, evidence, structured data and crawler access, plus measurement. Use when adapting to AI search.

optimize-for-ai-search