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
# 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 -
tools
Use when the user says "mk0r", "appmaker CLI", "open a VM", "run something in the sandbox", "talk to the VM agent", "spin up an E2B sandbox", or "chat with appmaker from CLI." Wraps the `mk0r` CLI to list projects, exec commands inside their E2B sandboxes, stream chat with the VM agent (same `/api/chat` the web UI uses), toggle SOAX residential IP, manage schedules, and copy files. Supports a sticky default project via `mk0r projects use`.
testing
Use when the user mentions "influencer candidates", "social media operator", "check proposals on Upwork/Fiverr", "review influencer applications", "qualify candidates", or "reach out to operators". Manages the IG/TikTok account operator hiring pipeline — review applicants, check replies, qualify, and do proactive outreach.
tools
End-to-end newsletter pipeline: investigate recent features, draft, send via API endpoint, and track delivery/open/click metrics.