brief-de-contenido

Generates SERP-driven SEO content briefs for blog, landing, e-commerce, and optimization workflows.

Updated Jun 3, 2026
One-click install
npx skills add https://github.com/Arianna-Lupi/SEO-Skills --skill brief-de-contenido-arianna-lupi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: brief-de-contenido
Source: https://github.com/Arianna-Lupi/SEO-Skills/tree/main/skills/brief-de-contenido
Command: npx skills add https://github.com/Arianna-Lupi/SEO-Skills --skill brief-de-contenido-arianna-lupi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, beautifulsoup4, and includes scripts (resource) and references (resource) components.

What problem does it solve? Writing or optimizing content without a structured brief leads to misaligned writers, wrong formats, and pages that fail to rank. This Skill creates the content brief (the writer's instruction manual) dictated by what actually ranks in the SERP, following the "De Cero a SEO" method (Weeks 8 and 10), so no keyword goes to drafting without a validated structure. ## Core Features & Use Cases - SERP-first analysis: Analyzes the top 3 organic results (manually or via SerpApi) to decide search intent and format before writing anything, including People Also Ask extraction. - Four brief types: Generates Blog, Landing/Services, and E-commerce briefs, plus an Optimization Brief (W10) for refreshing existing content with documented before/after changes. - Strict on-page rules: Enforces meta titles of 50-60 characters with the keyword first, meta descriptions of 120-155 characters with a CTA, and a single-H1 heading hierarchy with no skipped levels. - Deterministic script: Includes a Python script that extracts H1/H2/H3 outlines from SERP competitors and merges them into a suggested outline as JSON. - Use Case: You have the prioritized keyword "best running shoes" from your content cluster. The Skill pulls the top SERP results, confirms the ranking format is a comparison guide, and outputs a complete brief with metas, H1-H3 skeleton, PAA-based sections, benchmark gaps, and internal links with anchor text for your writer. ## Quick Start Ask the AI to create a content brief for your target keyword, specifying the page type (blog, landing, or e-commerce) and the cluster it belongs to.

Frequently Asked Questions about brief-de-contenido

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an SEO content brief before writing an article?▼

Provide your target keyword, page type, and cluster, and the Skill analyzes the top 3 SERP results to decide intent and format. It then outputs a brief with meta title, meta description, H1-H3 heading skeleton, competitor benchmark, and internal links with anchor text.

How do I optimize existing content that lost rankings?▼

Use the Optimization Brief (W10) variant, which documents all changes before touching the page in an actual-versus-suggested format. It preserves what already ranks, keeps URLs with traffic unchanged, and updates metas, headings, and internal links surgically.

Does this SEO brief skill work without SerpApi or Ahrefs?▼

Yes, it works fully in manual mode by reviewing the top 3 results in an incognito browser and extracting competitor headings with a headings-map tool. SerpApi and Ahrefs MCP connections are optional accelerators, not requirements.

What are the rules for meta titles and descriptions in the brief?▼

Meta titles must be 50-60 characters with the keyword at the beginning, and meta descriptions must be 120-155 characters, persuasive, and include a call to action. The Skill counts characters and flags anything out of range.

Why does the skill refuse to write a brief without SERP analysis?▼

The core rule is that the SERP dictates the brief, not personal opinion. Without analyzing the top 3 results, the chosen format may not match what Google ranks, so the Skill asks for SERP data first or marks the format as unvalidated.

What Python dependencies does the SERP outline script need?▼

The script requires Python 3.9+ with the requests and beautifulsoup4 packages, runnable via uv without manual installation. A SERPAPI_API_KEY is needed for automatic SERP fetching, or you can pass competitor URLs directly with the --urls flag.