content-brief · akii-technologies-ltd — Claude Code skill: what it does, how to install
A Claude Code skill that builds article and page briefs for SEO, AEO, and GEO. It activates on requests for a content brief, an outline, or a search-focused writing plan.
MIT ★ 80 updated 2026-10-15
~/.claude/skills/content-brief/SKILL.mdWhat content-brief does
The skill turns a topic or target keyword into a structured brief. It examines search results and checks for a Google AI Overview when one is available. From competitor pages, it extracts search intent, recurring entities and heading themes, People Also Ask questions, average length, and frequently cited sources.
The brief can include a suggested title and meta description, URL slug, schema, heading outline, required entities, questions to answer, and internal and external links. Search data sources include Ahrefs and Apify, with WebSearch and WebFetch as a general fallback. For health, finance, legal, and investment topics, the skill calls for a named expert byline and citations. Its title limit is 60 characters; the meta description limit is 155.
What it helps with
- turn a target keyword into an article outline
- identify recurring topics across competitor pages
- collect People Also Ask questions for a brief
- prepare SEO, AEO, and GEO recommendations
Example prompts for the agent
- Create an SEO brief for an article about database migration.
- Build an outline for a page on image optimization.
- Prepare a content brief for a health insurance article.
How to install content-brief
Manually: put the files in place
~/.claude/skills/content-brief/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/content-brief/
Manually: put the files in place
.agents/skills/content-brief/SKILL.mdFor all projects use ~/.agents/skills/
Manually: put the files in place
.cursor/skills/content-brief/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install akii-technologies-ltd/akii-seo-ai-search-optimizer skills/content-brief2Manually: put the files in place
.github/skills/content-brief/SKILL.mdPlatform CLI
gemini skills install https://github.com/akii-technologies-ltd/akii-seo-ai-search-optimizer --path skills/content-briefManually: put the files in place
.devin/skills/content-brief/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about content-brief
How do I install content-brief in Claude Code?
Place the skill file at ~/.claude/skills/content-brief/SKILL.md.
What does content-brief do?
It studies a topic and its search results, then produces an article or page plan with headings, metadata, questions, entities, and source suggestions.
Which data sources does content-brief use?
It can use Ahrefs and Apify for search data, with WebSearch and WebFetch as a general fallback.
Source text
SKILL.md · MIT
--- 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. Explore Akii Technologies and the products we build: https://akii.com/?utm_source=plugin&utm_medium=skill&utm_content=content-brief&utm_campaign=akii_plugin_v1*
© akii-technologies-ltd · MIT · akii-technologies-ltd/akii-seo-ai-search-optimizer
Similar skills
All skills for SEO and GEO →content-brief by other authors comes first.