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 writing.
git clone --depth 1 https://github.com/akii-technologies-ltd/akii-seo-ai-search-optimizer /tmp/content-brief && cp -r /tmp/content-brief/skills/content-brief ~/.claude/skills/content-briefSKILL.md
# 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*
Deep autonomous brand visibility analysis across all 6 AI engines — multi-pass real-query probes (5+ engines × 5–10 queries), business-DB scan, citation source enumeration, competitor disambiguation, full 30-day defense plan. Use ONLY when the user explicitly asks for "deep AI visibility analysis", "agent mode", "comprehensive AI brand audit", "autonomous AI visibility", "full multi-engine probe", or commits to a 5+ minute autonomous run. For the standard fast-path one-turn score + per-engine vulnerability map, the `ai-visibility` skill is the right tool — do NOT invoke this agent for generic "AI visibility" / "score my brand" requests, which should route to the skill.
Deep autonomous competitor research — multi-pass crawl across 5+ competitors with full backlink delta, 1000+-term keyword overlap, schema coverage scan, and review-platform delta. Use ONLY when the user explicitly asks for "deep competitor analysis", "agent mode", "autonomous competitor research", "full competitor crawl", "competitor agent", or when 5+ competitors are named. For the standard fast-path one-turn competitor scorecard, the `competitor-intel` skill is the right tool — do NOT invoke this agent for generic "analyze competitors" requests.
Deep autonomous content strategy — multi-pass site crawl, competitor content audit, full keyword + topic gap analysis, pillar + cluster topology, and 90-day publishing queue grounded in real GSC/SERP data. Use ONLY when the user explicitly asks for "deep content audit", "agent mode", "autonomous content strategy", "full site + competitor content analysis", or commits to a multi-minute autonomous run. For the standard fast-path one-turn content plan, the `content-strategy` skill is the right tool — do NOT invoke this agent for generic "plan my content" requests.
Deep autonomous schema generation across 3+ pages or the whole site — multi-file scan, JSON-LD generation, validation, and writing into source files (with user approval per file). Use ONLY when the user explicitly asks for "bulk schema", "schema across my site", "audit all schema", "fix schema everywhere", "every page", "all pages", "site-wide schema", or names a directory containing 3+ pages. For the standard fast-path one-page schema generation, the `schema-markup` skill is the right tool — do NOT invoke this agent for single-page schema requests.
Run a full SEO + AEO + GEO audit on a website or codebase. Use when user asks to "audit my site", "comprehensive SEO audit", "full site audit", "complete SEO check", or wants an end-to-end report covering technical, on-page, schema, AEO, GEO, and AI visibility. Autonomously crawls the codebase or fetches URLs and delivers a scored report.
Quick SEO + AEO check on the current file or a specified page
Generate SEO + AEO + GEO-optimized content for a topic or keyword
Research and generate a complete topic plan with keyword mapping, audience, angle, and competitive positioning