CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

content-writer

Use when the user asks to "write SEO content", "draft a blog post / landing page", "update outdated content", or "fix traffic/ranking decay"; two modes — new drafts pages with keywords, headers, snippets, and evidence boundaries; refresh scores decay, prioritizes update work, and produces a republish plan with GEO guidance. Not for AI-citation/GEO readiness scoring — use geo-content-optimizer; not for publish-gate scoring — use content-quality-auditor. SEO文章写作/内容更新/排名恢复

Quality

88%

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

88%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-engineered instruction skill: two crisply sequenced nine-step workflows with explicit validation gates, concrete thresholds and copy-paste commands, and a verified one-level-deep reference bundle. The only deductions are minor token weight in operational detail and cross-bundle references that do not resolve inside this evaluated bundle.

Suggestions

Conciseness: move the publish-time index-push command details and the handoff-summary dependency tuple into an existing reference (e.g., instructions-detail.md or the evidence-and-cycle-control profile) and keep a one-line pointer in SKILL.md.

Progressive disclosure: make the cross-bundle references resolvable — either ship the shared files (skill-contract.md, CONNECTORS.md, SECURITY.md, measurement-protocol.md) within the evaluated bundle or inline the small amount of needed content, so navigation does not break at the bundle boundary.

Progressive disclosure: the Refresh Templates and Refresh Example references overlap in purpose; consider merging them or stating when to use each so the reference list is easier to navigate.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence — no padding and no explanation of concepts Claude already knows; every section carries non-obvious specifics ("a page's own median over the prior comparable window", republish-date thresholds). Anchor 4 rather than 5 because the publish-time index-push paragraph and the handoff-tuple field list carry operational detail that could be trimmed into a reference file.

4 / 5

Actionability

Guidance is concrete and executable throughout: exact numeric thresholds (30% decay trigger, 40-60 word FAQs, 7/14/28/56-day readbacks, 2-5 internal links), copy-paste commands ("python3 \"${CLAUDE_PLUGIN_ROOT}/scripts/connectors/indexpush.py\" indexnow <url> --key $INDEXNOW_KEY --live"), a mode-selector table, and worked quick-start prompts covering both modes — matches the anchor-5 standard for an instruction-only skill.

5 / 5

Workflow Clarity

Both nine-step workflows are clearly sequenced with explicit validation checkpoints: a Final SEO + CORE-EEAT Self-Check that auto-fixes into a "### Changes Made" table, a pre-handoff quality bar, refresh readback windows judged against a control set, and a Decision Gates section with explicit stop/continue rules and mismatch handling. Anchor 5, not 4, because checkpoints and error paths are explicit rather than implicit.

5 / 5

Progressive Disclosure

Good structure: the body is an overview with a clearly signaled, one-level-deep Reference Materials list, and all 7 local references/*.md files exist with substantive matching content (verified). Anchor 4 rather than 5 because several referenced paths (../../../references/skill-contract.md, ../../../CONNECTORS.md, ../../../SECURITY.md, ../../../references/measurement-protocol.md, ../../tune/content-quality-auditor/SKILL.md) do not resolve within this bundle, breaking navigation at the bundle boundary.

4 / 5

Total

18

/

20

Passed

Description

87%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: explicit trigger phrases, a clear two-mode what, and explicit disambiguation from neighboring skills. It falls just short of top marks on specificity and trigger coverage only because of domain jargon ("evidence boundaries", "GEO") and a few missing natural synonyms. Voice is consistently third person, so no voice penalty applies.

DimensionReasoningScore

Specificity

Names several concrete actions for both modes ("new drafts pages with keywords, headers, snippets, and evidence boundaries"; "refresh scores decay, prioritizes update work, and produces a republish plan"), but terms like "evidence boundaries" and "GEO guidance" are domain shorthand rather than plain actions — anchor 4, not 5, and well above the 1-2 concrete actions of anchor 3.

4 / 5

Completeness

Explicitly answers both questions: a clear "what" (two modes with their distinct outputs) and an explicit "Use when the user asks to…" clause with concrete trigger phrases, exactly matching anchor 5; not 4 because the "when" is explicit and trigger-phrased rather than merely present.

5 / 5

Trigger Term Quality

Includes natural quoted trigger phrases users would actually say ("write SEO content", "draft a blog post / landing page", "update outdated content", "fix traffic/ranking decay"), but misses common variations like "refresh this article", "recover rankings", or "SEO article" — anchor 4 rather than comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

Carves a clear two-mode niche and adds explicit negative boundaries ("Not for AI-citation/GEO readiness scoring — use geo-content-optimizer; not for publish-gate scoring — use content-quality-auditor"), giving minimal conflict risk — anchor 5, not 4, because overlap is addressed rather than merely minor.

5 / 5

Total

18

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 16 suspicious

Warning

Total

13

/

16

Passed

Repository

aaron-he-zhu/aaron-marketing-skills

Path

seo-geo/implement/content-writer/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.