seo-content-brief

Generate competitive SEO content briefs with per-section word counts, competitor scoring, keyword density guidance, and page-type templates. Supports both new page briefs and improve-existing-page briefs. Use when user says "content brief", "write a brief", "content outline", "blog brief", "service page brief", "brief for", "writing brief", "content plan", or "outline for".

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

86%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A strong, highly actionable skill body with a clear sequenced workflow, robust error-recovery paths, and excellent use of one-level-deep bundle references. Its main weakness is redundancy: the keyword-density section repeats much of what already lives in its reference file.

Suggestions

Trim the 'Keyword Density and Placement' section to a short pointer (5-6 lines) since `references/keyword-density.md` already contains the full rules, and remove the duplicated 'First 1-2 mentions... diminishing returns' point from the Distribution bullet.

Add a final validation checkpoint to the workflow: before outputting, verify the brief satisfies its own hard rules (title 50-60 chars, meta description 130-150 chars, primary keyword in title/H1/slug/first 100 words/alt text, 3-5 internal links).

Clarify in the Improve-mode section how 'keep/strengthen' vs 'add new' sections should be labeled in the fixed Output Format template, since the template does not currently show a slot for that distinction.

Dimension	Reasoning	Score
Conciseness	The body is mostly tight, prescriptive rules, but the ~35-line 'Keyword Density and Placement' section substantially duplicates `references/keyword-density.md` inline despite pointing there for the full rules, and points like 'First 1-2 mentions help establish topic context. Diminishing returns after' are restated in the Distribution bullet — more than minor trim opportunities.	3 / 5
Actionability	Guidance is fully executable for an instruction-only skill: concrete competitor scoring dimensions (Depth/Formatting/SEO/UX 1-10), the gap-priority formula 'Impact x Competitive Advantage / Effort', exact meta-tag character ranges, named DataForSEO/Ahrefs MCP tools, and a complete copy-ready output-format template with table skeletons and a worked per-section keyword example.	5 / 5
Workflow Clarity	The five numbered process steps are clearly sequenced with mode determination up front, and the Error Handling table provides genuine fallback feedback loops (unreachable URL, no competitors, missing sitemap). It falls short of a 5 only because no checkpoint validates the finished brief against its own rules (e.g., confirming title is 50-60 chars or meta description 130-150).	4 / 5
Progressive Disclosure	Three real, one-level-deep reference files (`references/excluded-domains.md`, `references/page-type-templates.md`, `references/keyword-density.md`) are clearly signaled in the body, which keeps a summary inline and correctly pushes the full lists, rules, and templates to the bundle files.	5 / 5
	Total	17 / 20 Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

Excellent description: specific capabilities, explicit both-mode coverage, comprehensive natural trigger phrases, and a clearly delineated SEO-brief niche, all in concise third-person voice.

Dimension	Reasoning	Score
Specificity	The description lists multiple concrete deliverables — 'per-section word counts, competitor scoring, keyword density guidance, and page-type templates' — plus both brief modes ('new page briefs and improve-existing-page briefs'), giving comprehensive concrete coverage in third-person voice with no filler.	5 / 5
Completeness	It explicitly answers what the skill does and when to use it via a 'Use when user says...' clause with concrete trigger phrases, matching the anchor-5 example pattern exactly.	5 / 5
Trigger Term Quality	It includes nine natural user phrases ('content brief', 'write a brief', 'content outline', 'blog brief', 'service page brief', 'brief for', 'writing brief', 'content plan', 'outline for') covering synonyms and common variations a user would naturally say.	5 / 5
Distinctiveness Conflict Risk	It carves out a clear SEO content-brief niche with distinct trigger phrases; only mildly generic terms like 'content plan' carry any overlap risk, which is insufficient to drop it below the clear-niche anchor.	5 / 5
	Total	20 / 20 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: AgriciDaniel/claude-seo
Path: skills/seo-content-brief/SKILL.md
Commit: 4b99de2

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.