CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

woocommerce-copy-guidelines

Guidelines for UI text and copy in WooCommerce. Use when writing user-facing text, labels, buttons, messages, or documentation in WooCommerce projects.

52

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/woocommerce-copy-guidelines/skills/woocommerce-copy-guidelines/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

46%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 commendably short and correctly avoids explaining what Claude already knows, but it is a hollow shell: the one concrete rule points to a sentence-case.md file that is missing from the bundle, and the remaining principles are too generic to act on. The skill currently tells Claude to follow rules it cannot read.

Suggestions

Either add the missing sentence-case.md (e.g. under references/) with the actual rules, or inline the core sentence-case rules with WooCommerce examples (e.g. "Add to cart", not "Add To Cart") so the guidance is executable without the broken pointer.

Replace vague principles like "Keep copy concise and action-oriented" and "Use clear, simple language" with concrete, checkable rules or before/after examples drawn from real WooCommerce UI text.

Remove the redundant intro paragraph (it repeats the frontmatter description) and the duplicate sentence-case bullet in Key Principles to tighten token use.

DimensionReasoningScore

Conciseness

The body is lean with no explanations of concepts Claude already knows, but the opening paragraph ("This skill provides guidelines for writing user-facing copy in WooCommerce, including UI text, labels, buttons, messages, and documentation") merely repeats the frontmatter description, and the Key Principle "Always use sentence case for UI text, not title case" duplicates Instruction 1 — minor redundancy that could be trimmed.

4 / 5

Actionability

The only substantive rule delegates to "See [sentence-case.md](sentence-case.md) for rules on using sentence case", and that file does not exist in the bundle (no references/, scripts/, or assets/ directories are present). The remaining principles — "Keep copy concise and action-oriented", "Use clear, simple language", "Be consistent with existing WooCommerce copy patterns" — are high-level hints with no examples, matching the 'minimal concrete guidance, missing specific steps' anchor.

2 / 5

Workflow Clarity

As a simple single-purpose skill, the instruction "Follow these guidelines when writing any user-facing text" is coherent and unambiguous in intent. However, the substance that would govern execution — the sentence-case rules — is a pointer to a missing file, and the fallback principles are generic, leaving guidance present but incomplete with no concrete checkpoints.

3 / 5

Progressive Disclosure

Scored against the actual bundle structure: the body's single reference is clearly signaled and one level deep, but sentence-case.md is absent from the skill directory entirely, so the delegated content does not exist and navigation dead-ends. A working, clearly-signaled one-level reference would merit a 3 or higher; a broken sole reference leaves the skill without its substance.

2 / 5

Total

11

/

20

Passed

Description

70%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 is well-formed: third person, concise, with an explicit and concrete 'Use when...' trigger clause. Its main weakness is the 'what' side — it names the domain and artifacts but offers no concrete capability verbs, relying on the generic "Guidelines for" framing.

Suggestions

Replace the generic "Guidelines for..." framing with concrete action verbs, e.g. "Write and review user-facing UI text, labels, buttons, and messages in WooCommerce..." to lift the what-side specificity.

Add one or two natural trigger variations users would actually say, such as "microcopy" or "error messages", to broaden keyword coverage.

DimensionReasoningScore

Specificity

Names the domain ("UI text and copy in WooCommerce") and artifact types ("labels, buttons, messages"), but the only action framing is "Guidelines for" — no concrete action verbs like write, review, or audit, so it matches the 'domain plus limited actions' anchor rather than a list of several specific actions.

3 / 5

Completeness

Both parts are present: an explicit "Use when writing user-facing text, labels, buttons, messages, or documentation in WooCommerce projects" trigger and a clear-enough what ("Guidelines for UI text and copy in WooCommerce"). Not a 5 because the 'what' restates the domain rather than enumerating concrete capabilities.

4 / 5

Trigger Term Quality

Good natural keyword coverage — "user-facing text", "UI text", "labels", "buttons", "messages", "documentation", "WooCommerce" — phrases a user would plausibly say, but common variations like "microcopy", "error messages", "placeholder text", or "tone" are missing, placing it just below comprehensive.

4 / 5

Distinctiveness Conflict Risk

"WooCommerce" pins a clear niche with distinct triggers and minimal conflict risk, but "documentation" and generic "writing text" create minor overlap with general writing and brand-style skills, keeping it below the clear-niche anchor.

4 / 5

Total

15

/

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

relative_links

Relative link issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

secondsky/claude-skills

Path

plugins/woocommerce-copy-guidelines/skills/woocommerce-copy-guidelines/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.