Brief
Generate an editor-ready SEO content brief—with SERP gaps, outline, and E-E-A-T notes—for one target keyword before anyone writes the draft.
Overview
Brief is an agent skill most often used in Launch (also Validate and Grow) that produces an editor-ready SEO content brief from SERP analysis, gaps, outline, and E-E-A-T targets for one keyword.
Install
npx skills add https://github.com/calm-north/seojuice-skills --skill briefWhat is this skill?
- SERP review of top 5–10 results with intent and format notes
- Competitive gap table: what ranks vs what nobody covers well
- Full outline plus E-E-A-T and on-page SEO target checklist
- Pairs with find-keywords for topic selection and audit for site-wide health
- Asks for keyword, business context, content type, and audience up front
- Reviews top 5–10 SERP results in Step 1
- SeoJuice brief skill version 1.0.0
Adoption & trust: 6.3k installs on skills.sh; 10 GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You know which keyword you want to rank for but lack a SERP-backed outline and SEO requirements your writer or agent can follow.
Who is it for?
Indie bloggers and SaaS marketers commissioning one high-intent post or guide with clear conversion goals.
Skip if: Choosing which keywords to pursue site-wide (use find-keywords) or diagnosing technical crawl failures (use diagnose-seo or audit).
When should I use this skill?
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.
What do I get? / Deliverables
You receive a structured brief with competitive gaps, heading plan, and SEO targets ready to hand off to drafting—then run find-keywords or writing workflows as needed.
- SERP analysis table and intent classification
- Editor-ready outline with E-E-A-T and SEO targets
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Keyword-led briefs are the standard Launch artifact that connects search intent to shippable articles and landing copy. SEO subphase covers intent mapping, SERP review, and on-page targets—not site-wide technical crawls (see audit).
Where it fits
Brief a comparison post for a commercial keyword before publishing on the marketing site.
Decide if a problem-aware keyword deserves a dedicated landing page versus a blog post.
Refresh an aging top post with an updated SERP gap section and new H2 plan.
How it compares
Single-topic SERP brief skill—not a full five-layer site SEO audit.
Common Questions / FAQ
Who is brief for?
Solo builders and content leads who need a repeatable SEO brief before drafting blog posts, guides, comparisons, or landing pages for a specific query.
When should I use brief?
At Launch when planning rank-focused content, during Validate to test whether a keyword merits a landing page, and in Grow when updating editorial plans; skip if you only need keyword ideation (find-keywords) or a full-site audit (audit).
Is brief safe to install?
It relies on web search for SERP analysis—check the Security Audits panel on this page and avoid sending confidential strategy into untrusted environments.
SKILL.md
READMESKILL.md - Brief
# Content Brief Produce a complete, editor-ready content brief covering intent analysis, competitive SERP review, content outline, E-E-A-T requirements, and SEO targets. ## Before You Start Gather this context (ask if not provided): 1. **Target keyword or topic.** The primary keyword this content should rank for. 2. **Business context.** What does the company do? What should readers do after reading (sign up, buy, contact)? 3. **Content type preference.** Blog post, landing page, guide, comparison, tutorial? 4. **Audience.** Who is reading this? Beginners, practitioners, decision-makers? ## Step 1: SERP Analysis Analyze what currently ranks for the target keyword: 1. **Search the keyword** (use web search) and review the top 5-10 results. 2. **Identify the dominant intent.** Are results informational guides, product pages, listicles, tools? 3. **Note the content format.** Average word count, heading structure, use of images/tables/videos. 4. **Find the gaps.** What do all top results cover? What do none of them cover well? Record: | Rank | Title | URL | Format | Approx. Length | Unique Angle | |------|-------|-----|--------|---------------|--------------| | 1 | ... | ... | guide / listicle / tutorial | ... | ... | ## Step 2: Intent Mapping Determine the exact user intent and map it to content structure: - **"How to" intent** → Step-by-step tutorial with numbered sections - **"What is" intent** → Definition + context + examples + next steps - **"Best X" intent** → Curated list with comparison criteria and recommendations - **"X vs Y" intent** → Side-by-side comparison table + verdict - **"Review" intent** → Hands-on evaluation with pros/cons/alternatives The content structure must match what the searcher expects to find. ## Step 3: Content Outline Build a detailed outline with: ### Title Options (2-3 variants) 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:** - Include the primary keyword - Keep under 60 characters (55 for mobile safety) - Use odd numbers in listicles (they outperform even) - Rewrite if CTR is below 2% at positions 1-3 or below 5% at positions 4-10 ### Meta Description 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] [adje