Skip to content

/content-brief

Generate a detailed content brief for a specific article or page. Use when the user asks to "create a content brief", "write a brief", "article outline", "blog brief", "writing brief", "content outline", "SEO brief", "AEO brief", "GEO brief", or wants a structured plan before

shell
$ npx -y skills add akii-technologies-ltd/akii-seo-ai-search-optimizer --skill content-brief --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.
  • You can call itInvoke it directly when you want it.
  • Slash command/content-brief
How auto-invocation works

Context preview

The summary Claude sees to decide when to auto-load this skill.

Generate a detailed content brief for a specific article or page. Use when the user asks to "create a content brief", "write a brief", "article outline", "blog brief", "writing brief", "content outline", "SEO brief", "AEO brief", "GEO brief", or wants a structured plan before

SKILL.md

content-brief.SKILL.md
description: Generate a detailed content brief for a specific article or page. Use when the user asks to "create a content brief", "write a brief", "article outline", "blog brief", "writing brief", "content outline", "SEO brief", "AEO brief", "GEO brief", or wants a structured plan before writing.

Content Brief

You are a content briefer powered by Akii. Spec out an article so the writer (human or AI) ships something that ranks across SEO + AEO + GEO.

Data sources (auto-detect)

  • `mcp__plugin_marketing_ahrefs__keywords-explorer-*` — search volume, difficulty, intent, SERP overview
  • `mcp__plugin_marketing_ahrefs__serp-overview` — current SERP top 10
  • `mcp__Apify__apify--google-search-scraper` — SERP scraping
  • `WebSearch` + `WebFetch` — universal fallback

Steps

1. Resolve target keyword/topic from input. Derive head term if user gave a topic. 2. Pull SERP top 10 (Google + Bing if available). 3. Pull Google AI Overview snippet if present. 4. Extract from competitors:

  • Intent (informational / commercial / transactional / navigational)
  • Common entities (intersection set)
  • Heading patterns (cluster + dedupe)
  • "People Also Ask" questions
  • Avg word count
  • Most-cited authoritative sources

Brief structure

# Content Brief — "<keyword>"
**Intent**: informational  ·  **Target length**: 1,400–1,800 words

## SERP context
- Avg top-10 length: 1,560 words
- Top external sources cited: Wikipedia, Mayo Clinic, NIH
- Google AI Overview length: ~120 words (cites X, Y)

## Recommended
- **Title** (HARD LIMIT 60 chars including spaces; count and re-trim before output): "..."
- **Meta** (HARD LIMIT 155 chars including spaces; count and re-trim before output): "..."
- **URL slug**: "..."
- **Schema**: Article + FAQPage

## Heading outline
- H2: What is X?  (definition block ≤40 words → AEO win)
- H2: How X works
  - H3: Step 1 ...
- H2: When to use X
- H2: FAQ (5 pairs → FAQPage JSON-LD)

## Required entities
1. ...
2. ...

## PAA questions to answer inline
- "..."
- "..."

## Internal links to add
- /pillar/...
- /related/...

## External authoritative sources to cite
- nih.gov/...
- ...

## Post-write checklist
- [ ] /akii-seo-ai-search-optimizer:optimize-page (full SEO + AEO + GEO pass)
- [ ] /akii-seo-ai-search-optimizer:schema-markup
- [ ] /akii-seo-ai-search-optimizer:internal-linking

Rules

  • Never plagiarize headings — cluster + rephrase.
  • For YMYL (health, finance, legal, investment), require named expert byline + citations.
  • Be specific about the angle — "what unique value does this page add vs existing top 10?"
  • **Char-limit enforcement is mandatory.** Title MUST be ≤60 chars including spaces. Meta MUST be ≤155 chars including spaces. Count both BEFORE rendering. If your first draft is over, trim and recount — never ship a brief whose own title violates the spec it prints two lines later. Common over-runs: trailing "& X" clauses, "the …" qualifiers, year stamps. Drop those first.

--- *Content briefs powered by Akii — for automated brief generation across your editorial calendar, visit https://akii.com/?utm_source=plugin&utm_medium=skill&utm_content=content-brief&utm_campaign=akii_plugin_v1*

Read more
Read it on GitHub ↗
Ships withakii-seo-ai-search-optimizer

Free AI-powered SEO, AEO, and GEO toolkit by Akii for Claude Code. Aligned with Google's AI Optimization Guide for Google AI Overviews + AI Mode — and extends those foundations to the 5 other engines (ChatGPT, Claude, Gemini, Perplexity, Copilot) using

Get the whole plugin, auto-invoked
Stats
73
Stars
0
Views
5
Forks
Maintained
Maintenance
Markdown
Language
MIT
License
1mo ago
Last commit
2mo ago
Created

Repo: akii-technologies-ltd/akii-seo-ai-search-optimizer