packages/skills/skills/brief/SKILL.md
Produce an editor-ready content brief for a target keyword or topic. Use when the user asks for a content brief, writing guidelines, article outline, SEO brief, what to include in a blog post, or how to structure content for a keyword. For choosing which topics to write about, see find-keywords. For a full site-wide SEO audit, see audit.
npx skillsauth add mediar-ai/skillhubz briefInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Produce a complete, editor-ready content brief covering intent analysis, competitive SERP review, content outline, E-E-A-T requirements, and SEO targets.
Gather this context (ask if not provided):
Analyze what currently ranks for the target keyword:
Record:
| Rank | Title | URL | Format | Approx. Length | Unique Angle | |------|-------|-----|--------|---------------|--------------| | 1 | ... | ... | guide / listicle / tutorial | ... | ... |
Determine the exact user intent and map it to content structure:
The content structure must match what the searcher expects to find.
Build a detailed outline with:
Select the formula that matches the content type:
| Content Type | Formula | Example | |-------------|---------|---------| | How-to / Tutorial | "How to [Goal] in [Timeframe]" | "How to Fix Crawl Errors in 30 Minutes" | | How-to (objection) | "How to [Goal] Without [Objection]" | "How to Build Links Without Cold Outreach" | | Listicle | "[N] [Adjective] [Topic] [Qualifier]" | "9 Proven Link Building Strategies for SaaS" | | Comparison | "[A] vs [B]: Which Is Better for [Goal]?" | "Ahrefs vs SEMrush: Which Is Better for Keyword Research?" | | Definition | "What Is [Topic]? [Short Clarifier]" | "What Is Topical Authority? How It Affects Rankings" | | Ultimate guide | "The [Complete/Definitive] Guide to [Topic]" | "The Complete Guide to Technical SEO" | | Mistakes | "[N] [Topic] Mistakes [Consequence]" | "7 Internal Linking Mistakes That Kill Rankings" |
CTR boosters — test adding these elements:
| Element | Expected CTR Impact | |---------|-------------------| | Add a number | +15-25% | | Add current year | +10-15% | | Add brackets or parentheses | +10-38% | | Add a power word (Proven, Essential, Ultimate) | +5-12% |
Rules:
Select a template and adapt:
| Content Type | Template | |-------------|---------| | Blog / Guide | "Learn [topic] with our [qualifier] guide. Covers [point 1], [point 2], and [point 3]. [CTA]." | | Question-answer | "[Question]? This [year] guide explains [what], [why], and [how]. Get actionable tips now." | | Listicle | "Discover [N] [adjective] [topic] strategies that [result]. Backed by [proof element]. Read the guide." | | Comparison | "[A] vs [B]: which is better for [use case]? We compared [criteria]. See the winner + detailed breakdown." | | Product/Service | "[Product] helps you [benefit]. [Feature 1], [Feature 2], [Feature 3]. [Price/offer]. [CTA]." |
Rules:
Map out every H2 and H3 with brief guidance for each section:
H1: [Title]
H2: [Section 1] — what to cover, target length
H3: [Subsection] — specific points
H2: [Section 2] — what to cover
...
H2: FAQ — 3-5 questions from People Also Ask
For each H2 section, specify:
First, determine if the keyword falls into "Your Money or Your Life" territory (health, finance, legal, safety). YMYL topics trigger elevated E-E-A-T requirements from Google:
Specify what credentials the author needs for this topic:
| Topic Type | Author Requirement | |-----------|-------------------| | YMYL (health, finance, legal) | Licensed professional or verifiable expert with public credentials | | Technical (code, engineering) | Demonstrated practitioner experience (portfolio, GitHub, publications) | | Business/marketing | Industry experience or named case studies | | General informational | Byline with bio is sufficient |
Set the minimum evidence bar for this piece:
| Content Type | Minimum Sources | Source Tier Requirement | |---|---|---| | Research/data-driven | 5+ citations | At least 2 primary sources (official docs, studies, .gov/.edu) | | How-to / tutorial | 2-3 citations | Official documentation for tools/methods referenced | | Opinion / thought leadership | 3+ citations | Data to support each major claim | | Comparison / "best X" | 1 per item reviewed | First-hand testing evidence for each |
Specify what the content needs:
Different content types weight E-E-A-T signals differently. Focus effort where it matters most:
| Content Type | Experience | Expertise | Authority | Trust | Top Priority | |-------------|-----------|-----------|-----------|-------|-------------| | Product review | Critical | High | Medium | High | Experience — hands-on testing evidence | | How-to guide | High | Critical | Medium | High | Expertise — demonstrate deep knowledge | | Research/data | Medium | Critical | Critical | Critical | Authority + Trust — sourced data, methodology | | Opinion piece | Critical | High | High | Medium | Experience — personal credentials and POV | | Comparison | High | High | Medium | Critical | Trust — unbiased criteria, transparent methodology | | News/reporting | Medium | Medium | Critical | Critical | Authority — recognized source, editorial standards |
For every piece, verify at minimum:
| Element | Target | |---------|--------| | Primary keyword | [keyword] | | Secondary keywords | [2-3 related terms] | | Word count range | [min-max based on SERP analysis] | | Internal links to include | [list specific pages to link to] | | External links to include | [types of sources to cite] | | Images/media | [count and types: screenshots, diagrams, tables] | | Featured snippet target | [yes/no — if yes, which format: paragraph, list, table] |
The brief must specify what makes this piece better than what already ranks:
Pick 1-2 angles. Trying to win on all dimensions produces generic content.
Overview
SERP Competitive Landscape [Table from Step 1]
Title Options
Meta Description [150-160 char description]
Content Outline [Full heading structure with guidance per section]
SEO Targets [Table from Step 5]
E-E-A-T Checklist
Differentiation [What makes this piece better than current top results]
Pro Tip: Use the free Keyword Density Analyzer and TF-IDF Tool to benchmark competitor content depth for your target keyword. SEOJuice MCP users can run
/seojuice:keyword-analysisfor search volume and difficulty, and/seojuice:content-strategyto check if the topic fits an existing cluster or fills a content gap.
tools
Design web-like user interfaces in the terminal and inside tmux with a cell-grid Canvas, CSS-like box model, flexbox/grid layout, and 15 reusable widgets such as Panel, Table, Card, ProgressBar, Meter, Tabs, Tree, Badge, Banner, and a braille line chart. Use when an agent needs a dashboard, panel, table, status page, TUI layout, tmux dashboard, screenshot-driven CLI/TUI replica, ANSI frame, truecolor render, pyte PNG screenshot smoke test, wide-character alignment, or a new terminal widget.
tools
Drive interactive terminal (TUI) programs — CLIs, REPLs, installers, menu apps, agent CLIs, and editors like vim — through a PTY, reading semantic screen snapshots. A pattern library classifies a screen (REPL, menu, pager, fzf search, confirm dialog, form, spinner, wizard) and drives it with a ready recipe. Use when a program expects a live terminal (arrow-key menus, prompts, spinners, password fields, curses UIs), or when a piped command hangs or prints nothing.
tools
Design and render terminal/CMD visual effects and ASCII art from a one-line request via the pluggable `fx` engine (18 hot-swappable, themeable effects plus scripted shows). Effects include donut, matrix rain, plasma, fire, a spinning 3D ball, Game of Life, wireframe cube, 3D text banners, rainbow/lolcat gradient text, starfield, tunnel, fireworks, image-to-ASCII, and more. Use when the request is for a terminal animation, ANSI/CLI art, or a new console effect. Pure Python stdlib; truecolor.
tools
# X Twitter Scraper Use Xquik for X/Twitter tweet search, user lookup, profile tweets, follower export, media download, monitors, webhooks, posting workflows, and MCP-backed API exploration. ## Prerequisites - A Xquik API key in `XQUIK_API_KEY`. - Internet access to `https://xquik.com/api/v1`, `https://xquik.com/mcp`, and `https://docs.xquik.com`. - A clear user request that identifies the target tweets, users, accounts, keywords, media, monitor, webhook, or write action. ## Source Truth -