CtrlK
BlogDocsLog inGet started
Tessl Logo

content-brief-authoring

How to author a content brief that actually guides a writer (human or AI) to produce a piece that ranks, converts, or both. Per-piece editorial brief: target keyword and cluster, search intent, audience and JTBD, heading structure, entity coverage for AEO/GEO, internal linking strategy, success criteria. The middle path between thin briefs (a keyword and a deadline) and thick briefs (a 4-page document nobody reads). Triggers on content brief, brief the writer, brief the article, brief authoring, content brief template, brief audit, per-piece brief, editorial brief, target keyword brief, search intent brief. Also triggers when briefing a human writer or an AI agent on a single content piece.

58

Quality

67%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/content-brief-authoring/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

100%

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

This is a strong skill description that clearly defines its scope (authoring content briefs), lists specific deliverables and components, and provides extensive trigger terms covering natural user language. The description effectively differentiates itself from adjacent skills (content writing, SEO auditing, content strategy) by focusing specifically on the per-piece editorial brief artifact. The explicit trigger list and contextual usage scenarios make it highly actionable for skill selection.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions and deliverables: target keyword and cluster, search intent, audience and JTBD, heading structure, entity coverage for AEO/GEO, internal linking strategy, success criteria. Also describes the philosophy (middle path between thin and thick briefs).

3 / 3

Completeness

Clearly answers both 'what' (author a content brief with specific components like keyword clusters, search intent, heading structure, entity coverage) and 'when' (explicit trigger list and contextual usage scenarios like briefing a human writer or AI agent on a single content piece).

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms including 'content brief', 'brief the writer', 'brief the article', 'content brief template', 'brief audit', 'editorial brief', 'target keyword brief', 'search intent brief', plus contextual triggers like briefing a human writer or AI agent.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive niche focused specifically on per-piece editorial content briefs for SEO/content marketing. The specific terminology (AEO/GEO, JTBD, entity coverage, internal linking strategy) and the explicit scope (per-piece brief, not content strategy or writing itself) make it unlikely to conflict with general writing, SEO audit, or content strategy skills.

3 / 3

Total

12

/

12

Passed

Implementation

35%

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

This is a knowledgeable, opinionated skill that clearly understands its domain, but it violates its own principle: it's a 'thick brief' that nobody will fully absorb. The content repeats itself significantly (the 12 fields appear twice, the thin/thick/effective distinction appears three times, the closing restates the intro), inlines detail that should live only in reference files, and never provides a concrete worked example of a completed brief. The guidance is solid but descriptive rather than executable.

Suggestions

Cut the content by 50%+: remove the repeated 12-field summary at the end, consolidate the thin/thick/effective discussion to one location, and move the search-intent and heading-structure detail exclusively into the referenced files rather than duplicating inline.

Add one complete worked example of a filled-in brief (all 12 fields populated for a specific keyword like 'best project management tools for startups') so the skill is demonstrative, not just descriptive.

Add a brief authoring validation checklist with explicit gates: e.g., 'STOP: verify SERP intent before writing the heading structure' and 'STOP: run entity gap analysis before finalizing required entities.'

Provide a concrete output schema (YAML or JSON) for the brief format, especially for AI-agent handoff, since the skill mentions structured formats but never shows one.

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~2,500+ words, repeating key points multiple times (e.g., 'thin vs thick' metaphor appears in the intro, its own section, the framework summary, and the closing). It explains concepts Claude already knows (what search intent types are, what internal linking is) and includes lengthy philosophical framing that doesn't change behavior. The 12-field list appears twice in full. Much of this could be cut by 60%+ without losing actionable content.

1 / 3

Actionability

The 12 fields are clearly named and described with enough specificity to act on, and the brief templates section gives useful type-specific guidance. However, there are no concrete examples of a completed brief, no template with actual filled-in fields, no executable code or structured output format (YAML/JSON schema). The guidance is descriptive rather than demonstrative—it tells you what fields to include but never shows a complete worked example.

2 / 3

Workflow Clarity

The brief-to-writer handoff section provides a reasonable sequence, and the entity discovery pattern has numbered steps. However, there are no validation checkpoints for the brief authoring process itself—no 'check the SERP before proceeding' gate, no explicit feedback loop for brief quality. The 12-consideration framework at the end is a checklist but lacks sequencing discipline and verification steps. For a process that can produce 'broken' briefs (as the skill itself acknowledges), the absence of explicit validation gates is a gap.

2 / 3

Progressive Disclosure

The skill references 8 separate reference files with clear paths and descriptions, which is good structure. However, no bundle files are provided, so the references are unverifiable. More importantly, the SKILL.md itself is monolithic—it inlines substantial detail on search intent classification, heading structure, entity coverage, and internal linking that it simultaneously says lives in reference files. The content should either be in the main file or the reference file, not both.

2 / 3

Total

7

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
rampstackco/claude-skills
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.