CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

writing-copywriting

Applies professional writing and copywriting principles across technical documentation, developer communications, marketing copy, microcopy, blog articles, changelogs, READMEs, and release announcements. Use when drafting, editing, or optimizing any written content for clarity, engagement, conversion, and global accessibility.

62

Quality

78%

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 ./skills/writing-skills/writing-copywriting/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

73%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, comprehensive skill body with excellent actionability and a well-sequenced workflow backed by explicit verification steps. Its main cost is length and duplication: several sections restate material available in the reference file or knowledge Claude already has, which inflates token usage without adding skill-specific value.

Suggestions

Compress Step 2's AIDA/PAS/BAB breakdowns to one-line summaries that defer to references/writing-frameworks.md, and remove the duplicated Inverted Pyramid entry in Step 3.

Trim knowledge Claude already has (AP vs. Chicago rules, active-voice rationale, l10n idioms) down to the skill-specific application of each.

Replace the non-functional 'vale --version || echo' snippet with an actual command that computes Flesch-Kincaid grade level so the readability benchmark is verifiable.

DimensionReasoningScore

Conciseness

The 347-line body is mostly tight (tables, bullets, checklists), but Step 2's full AIDA/PAS/BAB breakdowns and much of Step 5 duplicate material in references/writing-frameworks.md, and sections like AP vs. Chicago style conventions and active-voice explanations cover knowledge Claude already has, fitting the 'mostly efficient but could be tightened' anchor.

3 / 5

Actionability

Highly concrete guidance throughout: headline formulas, a weak/strong microcopy comparison table, the FAB progression, a worked changelog example, and a three-pass editing checklist. Minor gap: the readability check snippet ('vale --version || echo ...') never actually computes the specified Flesch-Kincaid grade levels, keeping it below fully executable anchor 5.

4 / 5

Workflow Clarity

Steps 1-9 are cleanly sequenced (audience -> framework -> principles -> headlines -> content type -> tone -> SEO -> l10n -> editing), and the dedicated Verification section supplies explicit validation checkpoints (readability benchmark, microcopy 4-point audit, runnable code test, link check, linting) with a three-pass checklist, matching the clear-sequence-with-explicit-validation anchor.

5 / 5

Progressive Disclosure

The single reference (references/writing-frameworks.md) is one level deep, real, and clearly signaled in Step 2, and sections are well organized. However, substantial template content (framework definitions, changelog format, README structure) is inlined in SKILL.md despite the reference file already carrying full versions, which is a minor organization gap at anchor 4.

4 / 5

Total

16

/

20

Passed

Description

71%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 well-constructed description with a clear scope enumeration and an explicit 'Use when' trigger clause. Its main weaknesses are abstract rather than concrete trigger phrasing in the 'when' clause and a breadth ('any written content') that raises overlap risk with adjacent writing skills.

Suggestions

Make the 'Use when' clause name concrete user requests, e.g., 'Use when the user asks to write or edit a README, changelog, landing page, blog post, error message, or release announcement.'

Add frequently used synonyms (landing page, newsletter, email copy, press release) to broaden natural trigger coverage.

Narrow 'any written content' to the enumerated content types to reduce conflict with general technical-writing or communication skills.

DimensionReasoningScore

Specificity

The description enumerates a comprehensive range of content types ('technical documentation, developer communications, marketing copy, microcopy, blog articles, changelogs, READMEs, and release announcements') but offers only a few generic verbs ('applies... principles', 'drafting, editing, or optimizing'), so it matches anchor 4 rather than the multi-concrete-action anchor 5.

4 / 5

Completeness

It clearly answers 'what' (applies writing/copywriting principles across enumerated content types) and has an explicit 'Use when drafting, editing, or optimizing any written content...' clause, but the 'when' is abstract rather than concrete trigger phrases, so it sits between anchors 4 and 5.

4 / 5

Trigger Term Quality

Good keyword coverage with natural terms users would say ('technical documentation', 'marketing copy', 'changelogs', 'READMEs'), but common variations like 'landing page', 'newsletter', 'email', or 'press release' are missing, fitting the 'good coverage, a few natural terms missing' anchor.

4 / 5

Distinctiveness Conflict Risk

The copywriting framing and enumerated content types create a recognizable niche, but 'any written content for clarity, engagement, conversion, and global accessibility' is broad enough to overlap with general technical-writing or communication skills, matching anchor 3.

3 / 5

Total

15

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

administrakt0r/pro-skills-repo-administraktor

Path

skills/writing-skills/writing-copywriting/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.