/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
$ npx -y skills add akii-technologies-ltd/akii-seo-ai-search-optimizer --skill content-brief --agent claude-codeHow 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
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.mddescription: 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
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*
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
Repo: akii-technologies-ltd/akii-seo-ai-search-optimizer
Other skills on akii-seo-ai-search-optimizer.
- /ai-visibility
Fast-path AI visibility — get a brand's 0–100 Akii Visibility Score (computed by an open-source LLM judge against the brand's public footprint) with four-dimension breakdown AND a per-engine proxy map for ChatGPT, Claude, Gemini, Perplexity, Copilot, and Google AI Overviews
Open skill - /broken-links
Find and fix broken links — three modes with different scale ceilings. `local` audits any local repo (HTML/MD/MDX, no size limit) via Glob/Grep + per-link verification. `page` checks one live URL deeply (~30-100 outbound links per run). `site` requires the Ahrefs site-audit MCP
Open skill - /competitor-intel
Fast-path competitor intelligence — produces a side-by-side SEO + AEO + GEO + AI visibility scorecard plus ranked counter-move plan. Three modes the skill ASKS the user to pick (no default): **Quick** (~10s, surfaces 5 likely competitors from SERPs), **Comprehensive** (~30-60s,
Open skill - /content-strategy
Fast-path content strategy — produce a pillar + cluster topology, 90-day publishing queue, and quick-win refresh list in a single turn. This is the default for any content-planning question. Use when the user asks to "plan content", "content strategy", "content calendar", "what
Open skill - /content-translation
Translate and localize content for international SEO. Use when the user asks to "translate content", "localize my site", "multilingual SEO", "translate to <language>", "international SEO", "hreflang", "multi-language website", "global content strategy", or wants to expand to new
Open skill - /internal-linking
Analyze and improve internal linking strategy. Use when the user asks about "internal links", "link structure", "site architecture", "link strategy", "orphan pages", "link equity", "page authority distribution", "anchor text", "topical clusters", "siloing", or wants to improve
Open skill

