agentsclimarketplace

Seo content brief

Skill gaguero/seo-agent-skills/seo-content-brief

Curated SEO Agent Skills pack for AI agents (Agent Skills open standard): technical audit, content briefs, JSON-LD schema, GEO/AEO, and anti-spam quality gates.

Install
npx -y skills add gaguero/seo-agent-skills --skill seo-content-brief

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Turns a keyword, topic or existing page into a complete, intent-first SEO content brief and on-page optimization plan. Maps search intent (informational, commercial, transactional, navigational, local) into topic clusters, then specifies the angle, H1/H2 structure, entities and questions to cover, internal links, CTA, and the E-E-A-T / people-first evidence the content must demonstrate. Also reviews and optimizes existing on-page elements: title, meta description, headings, slug, internal linking. Use when someone asks for a content brief, keyword/topic research, content strategy, on-page optimization, or how to make a page rank and satisfy searchers.

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

4.7 KB, 929 tokens by cl100k_base, as published. Nobody here has run it

SEO Content Brief & On-Page

Great SEO content starts from intent, not keywords. First answer "what is the person actually trying to do?", then build the page that satisfies that better than the current results. Write for the human; structure for the crawler.

Step 1 — Classify intent

For the target query/topic, decide the dominant intent (a query can be mixed):

IntentThe searcher wantsPage type that wins
Informationalto learn / understandguide, explainer, how-to, FAQ
Commercial investigationto compare before buyingcomparison, "best X", reviews, alternatives
Transactionalto act / buy / book nowproduct, service, pricing, booking page
Navigationala specific site/brandbrand/home/login page
Localsomething near themlocation/service-area page, map, hours

Verify intent against what currently ranks: if the SERP is all comparisons, a single product page won't win. Match the format the SERP rewards.

Step 2 — Build the cluster

Group the topic into a pillar + supporting pages:

  • One pillar page targeting the head term and broad intent.
  • Supporting pages for sub-intents, long-tail, and conversational questions.
  • Define internal links: supporting → pillar (and back) with descriptive anchors.
  • Flag cannibalization risk: two pages targeting the same intent compete with each other — consolidate or differentiate. (Hand borderline cases to seo-quality-gates.)

Step 3 — Write the brief

Deliver a brief a writer or content agent can execute without guessing:

## Brief: <target page>
- Target query / topic + dominant intent
- Audience & what success looks like for them
- Differentiating angle (why this beats the current top results)
- Working title options (see on-page rules below)
- Outline: H1, then H2/H3 covering the must-answer questions
- Entities & subtopics to include (people/places/things/concepts)
- Questions to answer (from People-Also-Ask, real customer questions)
- E-E-A-T evidence required (see below)
- Internal links in / out (with anchor text)
- Primary CTA + secondary CTA
- Schema to add (route to seo-schema-builder)
- Media needed (original images/diagrams/data)

Step 4 — E-E-A-T / people-first requirements

The brief must specify how the page will demonstrate, not just claim:

  • Experience — first-hand proof: original photos, tests, data, specifics only someone who did it would know.
  • Expertise — a real, named author with relevant credentials/bio.
  • Authoritativeness — citations to primary sources; earned mentions/links.
  • Trust — accuracy, transparency (Who/How/Why), disclosure of AI assistance or reviews, contact/about info, no fabricated claims.

Reject "search-engine-first" patterns: bulk thin pages, content that just restates the obvious, keyword-driven topics nobody asked for, fabricated detail.

Step 5 — On-page optimization (for existing pages)

ElementRule
Title tagUnique, intent-matching, primary topic near the front, ~50–60 chars, no stuffing. Compelling for clicks.
Meta descriptionUnique, ~150–160 chars, summarizes value + soft CTA. Not a ranking factor but drives CTR.
H1One per page, matches the page's core promise.
HeadingsLogical H2/H3 hierarchy that mirrors the questions; scannable.
URL slugShort, lowercase, hyphenated, descriptive, stable.
BodyAnswers the dominant intent early (don't bury the answer), then depth.
Internal linksDescriptive anchors to related pillar/supporting pages.
MediaDescriptive alt, real images, dimensions set (helps CLS).

Output

A finished brief (or an annotated on-page diff for existing pages). Send schema to seo-schema-builder, answer-engine framing to ai-search-optimization, and run the result through seo-quality-gates before publishing.

See references/intent-and-clusters.md.

What ships with it: 2 files

4.1 KB alongside SKILL.md

references/

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.