Skip to main content
skill CX Codex

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

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
~/.claude/skills/content-brief/SKILL.md
Open on GitHub

What 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.md

Copy the whole skill folder; for one project use .claude/skills/content-brief/

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.

content-brief inhouseseo The content-brief skill reviews Google results for a target keyword and turns the findings into a structured article brief. Use it when a writer needs a search-informed outline. CX Codex +1 ★ 416repo stars content-brief-authoring rampstackco The content-brief-authoring skill helps shape a brief for one piece of content, from search intent and audience to outline and success criteria. Use it to guide a writer or review an existing brief. CX Codex +1 292installs seo-content-brief OpenClaudia seo-content-brief turns a target keyword into a full SEO brief: search intent, SERP breakdown, heading outline and a writer checklist. Useful when content goes to an outside author. CX Codex +1 468installs content-brief-generator jamesrochabrun The content-brief-generator skill builds structured briefs for articles, docs, landing pages, and other formats. Use it when a writer needs a clear audience, goal, outline, and SEO direction. CX Codex +1 207installs blog-brief AgriciDaniel blog-brief builds a detailed content brief for a single blog post using live SERP data, intent analysis, template mapping, and competitor gap research. CX Codex +1 2,700installs brief calm-north Generates editor-ready SEO content briefs with SERP analysis, outline templates, and E-E-A-T requirements. CX Codex +1 6,400installs linkedin-posts kostja94 linkedin-posts is a Claude Code skill that drafts and revises LinkedIn content. It activates for requests about posts, articles, newsletters, and other LinkedIn formats. CX Codex +1 3,700installs

From the same set13

The whole set →
keyword-clustering The keyword-clustering Claude Code skill sorts keywords into topic groups and maps them to search intent. It activates on a keyword list or a request to plan site content. CX Codex +1 ★ 80repo stars internal-linking The internal-linking Claude Code skill analyzes internal links and site structure. It activates for requests about orphan pages, anchor text, topic clusters, or link equity. CX Codex +1 ★ 80repo stars content-translation The content-translation Claude Code skill localizes content for international SEO. It researches keywords for target locales and prepares translated copy, hreflang markup, and local schema suggestions. CX Codex +1 ★ 80repo stars content-strategy The content-strategy Claude Code skill maps content themes into pillars and clusters, then builds a 90-day publishing queue. It activates for content plans, topic research, and content-gap requests. CX Codex +1 ★ 80repo stars competitor-intel The competitor-intel Claude Code skill compares SEO, AEO, GEO, and AI brand visibility. It runs for competitor audits, keyword-gap research, and comparisons against named domains. CX Codex +1 ★ 80repo stars broken-links broken-links — a skill for Claude Code checks links in a local project or on a live page, including redirects and mixed content. A full-site crawl needs the Ahrefs site-audit MCP. CX Codex +1 ★ 80repo stars ai-visibility The ai-visibility Claude Code skill maps a brand’s AI search visibility using public web signals. It runs for requests about brand mentions or presence in ChatGPT, Gemini, and Perplexity. CX Codex +1 ★ 80repo stars akii-seo-ai-search-optimizer The akii-seo-ai-search-optimizer plugin for Claude Code audits websites, organizes content topics, and adapts pages for generative AI search. ★ 80repo stars

Project sponsors

Companies that keep this analytics open