CtrlK
BlogDocsLog inGet started
Tessl Logo

seo-content-writer

Writes SEO-optimized content based on provided keywords and topic briefs. Creates engaging, comprehensive content following best practices. Use PROACTIVELY for content creation tasks.

56

Quality

65%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/seo-content-writer/SKILL.md

The canonical home for this skill is seo-content-writer in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is well-structured, concise, and offers concrete numeric quality parameters with a clear workflow, but its single progressive-disclosure pointer is a broken reference to a missing file and the high-level approach steps lack an explicit review loop.

Suggestions

Fix or remove the dangling reference: either create references/implementation-playbook.md (and correct the path) or drop the pointer so Claude is not sent to a missing file.

Turn the high-level 'Approach' steps into concrete, sequenced actions with an explicit draft -> self-check-against-Quality-Standards -> revise feedback loop.

Move the detailed Content Creation Framework and Output spec into a referenced file to keep SKILL.md a true overview, raising progressive-disclosure quality.

DimensionReasoningScore

Conciseness

The body is mostly lean bullet-based content with no over-explanation of what SEO is or how writing works; only minor trimmable lines ('You are an SEO content writer...', 'Focus on value-first content. Write for humans while optimizing for search engines.') keep it just below a 5, matching the 'efficient; minor instances that could be trimmed' anchor.

4 / 5

Actionability

Concrete, executable parameters are given throughout (intro 50-100 words, keyword density 0.5-1.5%, reading level grade 8-10, meta description 150-160 chars, 3-5 title variations, 2-3 sentence paragraphs), but the 'Approach' steps remain high-level ('Analyze topic and target keywords', 'Create comprehensive outline'), matching the score-4 anchor with minor gaps rather than fully copy-paste-ready 5.

4 / 5

Workflow Clarity

A clear 7-step 'Approach' sequence is present and the 'Quality Standards' and 'Output' sections function as output-validation checklists; this is not a destructive or batch operation so the cap-at-3 rule does not apply, but there is no explicit validate-and-revise feedback loop, fitting score 4 rather than 5.

4 / 5

Progressive Disclosure

Sections are well organized (Use when / Don't use / Instructions / Focus Areas / Framework / Approach / Output), but the only external reference — 'open resources/implementation-playbook.md' — points at a non-existent file in a non-standard directory (no references/scripts/assets bundles exist), so the reference is dangling rather than clearly signaled, matching the score-3 anchor where 'references present but not clearly signaled' rather than the well-split 4.

3 / 5

Total

15

/

20

Passed

Description

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

The description clearly states what the skill does and includes an explicit usage directive, but leans on generic phrasing ('best practices', 'content creation tasks') and lacks concrete trigger synonyms, leaving it distinguishable but not sharply so.

Suggestions

Replace 'following best practices' with specific concrete actions (e.g., 'drafts SEO articles, optimizes meta descriptions, structures headings for search intent').

Add concrete trigger phrases users actually say, e.g. 'Use when the user needs SEO blog posts, articles, or web copy optimized for target keywords.'

Drop 'Use PROACTIVELY' phrasing in favor of natural 'Use when...' triggers to reduce overlap with generic writing skills.

DimensionReasoningScore

Specificity

Names the SEO-content domain and a couple of concrete actions ('Writes SEO-optimized content based on provided keywords and topic briefs'), but 'Creates engaging, comprehensive content following best practices' is generic filler, so coverage is not comprehensive — fitting the score-3 anchor rather than 4.

3 / 5

Completeness

It explicitly answers both what ('Writes SEO-optimized content based on provided keywords and topic briefs') and when ('Use PROACTIVELY for content creation tasks'); the 'when' is present but generic, matching the score-4 anchor where 'when could be more explicit or specific' rather than the concrete trigger phrases required for 5.

4 / 5

Trigger Term Quality

Relevant terms appear ('SEO-optimized content', 'keywords', 'topic briefs', 'content creation tasks') but common user synonyms like 'blog posts', 'articles', 'web copy', or 'copywriting' are missing, matching the 'some relevant keywords but missing common variations' anchor at 3 rather than the fuller coverage of 4.

3 / 5

Distinctiveness Conflict Risk

The SEO/keyword/brief framing gives it a niche, but the trigger 'content creation tasks' is broad and could overlap with general writing or blog skills, matching the 'somewhat specific but could still overlap with similar skills' anchor at 3 rather than the mostly-distinct 4.

3 / 5

Total

13

/

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.

Validation15 / 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
administrakt0r/AI-Agents-Safe-Coding-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.