CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

seo-content-brief

Generate competitive SEO content briefs with per-section word counts, competitor scoring, keyword placement 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

84%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

67%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 well-structured, highly actionable instruction skill with a clear process, exact output template, and genuinely useful one-level-deep references. Its weaknesses are moderate verbosity in the keyword-placement and intent-classification sections, undefined rating scales for the scoring formulas, and one cross-bundle reference that is dangling from this skill's perspective.

Suggestions

Deduplicate the keyword-placement section: state the 'no fixed density' rule once and move the detailed placement heuristics entirely into references/keyword-density.md, trimming the inline summary to the must-appear locations list.

Define rating scales for the scoring inputs — e.g., what makes a competitor Depth 3 vs 8, and how to rate Impact / Competitive Advantage / Effort in the gap-priority formula — so scores are reproducible.

Fix or inline the ${CLAUDE_PLUGIN_ROOT}/skills/seo/references/quality-gates.md reference: either bundle the quality-gates content as a local reference file or state the 30-60/120-160 audit limits inline, since the cross-skill path is unverifiable from this bundle.

DimensionReasoningScore

Conciseness

The skill-specific rules are tight, but the keyword-placement section repeats the 'no fixed density' message three times across ~34 lines, and the search-intent taxonomy definitions are standard SEO knowledge Claude already has. More than minor instances of over-explanation, so it sits at 'mostly efficient but could be tightened' rather than 4.

3 / 5

Actionability

Highly actionable for an instruction-only skill: an exact copy-paste output template, an error-handling table, precise character targets, and named MCP tools. The gap holding it below 5 is that the gap-priority formula ('Impact x Competitive Advantage / Effort') and the 1-10 competitor scoring dimensions give no rating scales, so scores will vary run to run.

4 / 5

Workflow Clarity

A clear 5-step sequence (mode → fetch context → SERP analysis → intent → build brief) with an error-handling table that provides recovery actions for external failures. Missing a validation checkpoint on the produced brief itself, so it has most checkpoints but not the explicit validate/fix loop of the top anchor.

4 / 5

Progressive Disclosure

Three one-level-deep references (excluded-domains.md, page-type-templates.md, keyword-density.md), all clearly signaled in the body and verified to exist with substantive content. Minor gaps: the ~34-line inline keyword summary duplicates much of references/keyword-density.md, and the reference to ${CLAUDE_PLUGIN_ROOT}/skills/seo/references/quality-gates.md points outside this bundle and cannot be resolved from the skill itself.

4 / 5

Total

15

/

20

Passed

Description

96%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.

A strong description that concretely enumerates capabilities, distinguishes both operating modes, and provides abundant natural trigger phrases. The only weakness is that a couple of the broader triggers ('content plan', 'outline for') are generic enough to invite overlap with non-SEO planning skills.

DimensionReasoningScore

Specificity

Lists multiple concrete capabilities — 'per-section word counts, competitor scoring, keyword placement guidance, and page-type templates' — plus two distinct modes ('new page briefs and improve-existing-page briefs'), giving comprehensive coverage of what the skill produces.

5 / 5

Completeness

Explicitly answers both 'what' (the two capability sentences) and 'when' ('Use when user says...') with concrete trigger phrases, matching the top anchor exactly.

5 / 5

Trigger Term Quality

Nine natural trigger phrases users would actually say ('content brief', 'write a brief', 'blog brief', 'service page brief', 'brief for', 'content plan', 'outline for') covering the full range of synonyms for this task.

5 / 5

Distinctiveness Conflict Risk

The SEO-brief niche is clear and mostly distinct, but generic triggers like 'content plan' and 'outline for' could overlap with general content-planning or outlining skills, so conflict risk is minor rather than minimal.

4 / 5

Total

19

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

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

Reviewed

Table of Contents

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.