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
Use when the user wants to manage Valet agents, channels, connectors, organizations, or environment variables (secrets and plain config) via the valet CLI. Handles creation, deployment, linking, teardown, and all multi-step workflows. Also use when asked to "create an agent", "deploy an agent", "design an agent", "build me an agent that...", "create a connector", "set up a webhook", or anything involving the Valet platform or any request to create and deploy AI agents. Also use when asked to "learn from this session", "capture this workflow", "save this as an agent", "make this repeatable", or when writing SOUL.md files.
tools
Publish files, folders, and artifacts to the web. Static hosting for HTML sites, images, PDFs, reports, dashboards, and any file type. Use when asked to publish, host, upload, serve, or share work at a live URL. Also use to propose a rendered page when a report, comparison, chart, design document, or status page would work better than terminal text, but do not create or update a remote site until the user asks or agrees. Account publishing gives a permanent, private-by-default URL visible to org members; --anonymous gives a temporary public URL with no account. Use the valet CLI when available and its MCP server when the CLI cannot run. For deploying an AI agent rather than static files, use the `valet` skill instead.
testing
# Faceless.so Turn a script, prompt, Reddit post, or blog into a Remotion short with TTS, captions, and B-roll, then auto-post to YouTube, TikTok, Instagram, X, Facebook, LinkedIn, and Threads. ## Prerequisites - A Faceless.so account (from $24/mo) at https://faceless.so - Source material: script, prompt, Reddit URL, or blog URL - Destination social accounts to auto-post (YouTube, TikTok, Instagram, X, Facebook, LinkedIn, Threads) ## Instructions 1. Open https://faceless.so and start a new
testing
# BIMI SVG Tiny P/S Corpus Validator Use the public makeBIMI SVG Tiny P/S Test Corpus to evaluate an SVG against its evidence-bound fixture rules and to report the result clearly. ## Inputs Accept either an SVG file, an SVG URL, or raw SVG markup. If the source cannot be retrieved or parsed as XML, stop and report that limitation. ## Authoritative corpus 1. Retrieve the current manifest from `https://makebimi.com/public/test-corpus/v1/manifest.json`. 2. Record `schema_version`, `corpus_vers