HOME SKILLS BLOG GITHUB
// RESEARCH BRIEF

SEO CONTENT BRIEF
EVIDENCE BEFORE OUTLINE

The content brief skill turns an existing URL or target keyword into a research-backed draft plan. It combines available site context, relevant search results, competitive coverage, content gaps, proof needs, metadata, outline, and internal-link opportunities without pretending the brief is finished copy.

Page by Daniel Agrici · Skill contributed by Puneet Singh (@puneetindersingh) · Command surface verified:

$
/seo content-brief [url-or-keyword] [page-type]

REQUIRES CLAUDE SEO INSTALLED IN CLAUDE CODE

Research sources pass through an evidence filter and assemble into a structured content brief blueprint
// RUN PREVIEW

What will happen if you start the content brief skill?

Choose improve-existing mode with a URL or create-new mode with a keyword. Confirm market, language, audience, page type, and the decision the page must support.

OUTCOME

A research-backed draft brief with intent, coverage, gaps, evidence needs, structure, and internal-link opportunities.

REQUIRED INPUT

One existing URL or target keyword. An optional page type, market, language, and audience make the brief more specific.

READINESS

Search and competitor evidence depends on reachable pages. Optional DataForSEO or Ahrefs enrichment needs credentials and approval.

LOCAL OUTPUT

A reviewable brief with recommended metadata, outline, proof requirements, quality guidance, and three to five internal links.

SIDE EFFECTS

The workflow fetches research and may write a local brief. It does not publish the page or replace editorial review.

COST + APPROVAL

Approve paid enrichment before use. An editor must verify facts, choose the final structure, and approve claims and publication.

// TWO MODES

How does the content brief skill choose its research mode?

Improve existing: provide a live URL. The skill studies the current page, its visible structure and coverage, then compares it with relevant search results before recommending additions, removals, evidence, metadata, and internal links.

Create new: provide a target keyword. The skill starts from the query, intended market, page type, and available business context, then builds a new brief around actual search intent and relevant competitors.

In both modes, competitor selection is evidence-led. The workflow filters out noncompetitors such as directories or irrelevant page types and analyzes up to five relevant competing pages. Search results remain time, locale, language, and device dependent.

Primary product references: the pinned content brief contract and the reviewed current source were byte-identical when checked on 2026-08-27.

1
CONTEXT
Load available business, site, audience, market, language, page-type, and brand constraints.
2
SERP
Review real search results, page types, intent patterns, and eligible competing pages.
3
COMPETITORS
Filter noncompetitors and analyze up to five relevant pages for recurring coverage and proof.
4
GAPS
Find unanswered questions, weak evidence, missing entities, and information-gain opportunities.
5
ARCHITECTURE
Recommend metadata, headings, questions, evidence, examples, and internal-link targets.
6
EDITORIAL GATE
Keep the brief draft-only until facts, original insight, structure, claims, and publication are approved.
// DELIVERABLE

What belongs in the finished draft brief?

The output is organized for a writer or editor to review. It should show why each proposed section exists and which claims need proof, not merely imitate competitor headings.

Brief componentDecision it supports
Search intent and page typeWhat the page must help the searcher accomplish
Competitive coverageWhich recurring expectations are genuinely relevant
Content gapsWhat useful answer, entity, example, or proof is missing
Information gainWhat original experience, data, comparison, or process can add value
Recommended metadataHow to describe the page accurately in search and social surfaces
Section outlineHow to order answers, supporting detail, and decision information
Evidence requirementsWhich claims need first-party proof, primary sources, dates, or attribution
E-E-A-T guidanceWhere authorship, experience, trust, and source clarity need strengthening
Internal linksWhich three to five relevant pages can support discovery and user navigation
// USAGE

How do you request the right content brief?

Improve an existing page

/seo content-brief https://your-site.com/service-page service

Use a reachable URL and name the page type when it is not obvious. Add the intended market, language, audience, and conversion decision if those facts are not already available.

Plan a new page

/seo content-brief "seo automation tools" blog

Use a specific query and honest page type. The skill should inspect the result landscape before drafting the outline, because the same phrase can imply different informational, commercial, local, or navigational intent.

Approve optional enrichment deliberately

DataForSEO can enrich keyword or live search evidence, and Ahrefs can enrich competitive data when configured. Both are optional. Confirm provider access, estimate the work, and approve costs before requests run.

A useful brief tells the writer what must be answered and proven. It does not replace the writer's original experience, reporting, judgment, or final prose.
// FAILURE STATES

What can weaken a content brief?

  • Ambiguous target: an unclear keyword, page type, market, or audience can produce the wrong intent model.
  • Blocked pages: paywalls, authentication, 403 responses, or client rendering can hide competitor or existing-page evidence.
  • Noncompetitor SERP results: directories, marketplaces, tools, and irrelevant page types must be filtered before comparison.
  • Missing business context: the brief cannot invent offers, proof, experience, service areas, authors, pricing, or differentiators.
  • Provider gaps: optional metrics remain unavailable when credentials or paid approval are absent.

When evidence is reduced, label the gap and keep the recommendation conditional. Do not replace missing research with fabricated volumes, traffic, links, or claims.

// FAQ

What should an editor verify before using the brief?

It produces a research-backed draft brief with search intent, competitive coverage, content gaps, recommended metadata, a section outline, evidence requirements, information-gain opportunities, E-E-A-T guidance, and three to five internal-link suggestions.
// RELATED SKILLS

BUILD THE EVIDENCE CHAIN

VIEW ALL 25 SKILLS →

RESEARCH THE PAGE.
THEN SHAPE THE BRIEF.

$
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git && bash claude-seo/install.sh
VIEW ON GITHUB ALL SKILLS >