CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

woocommerce-backend-dev

Add or modify WooCommerce backend PHP code following project conventions. Use when creating new classes, methods, hooks, or modifying existing backend code in WooCommerce projects.

59

Quality

74%

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

Quality

Content

53%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 SKILL.md body is a well-organized, token-efficient overview that correctly avoids inlining detail, and the version-numbering section is genuinely executable. However, the entire progressive-disclosure structure is broken in practice — all seven referenced bundle files are absent — which also undermines actionability, since the conventions the skill exists to convey are unreachable. A concrete lint/test command would strengthen the lone implicit validation checkpoint.

Suggestions

Add the seven referenced bundle files (file-entities.md, code-entities.md, coding-conventions.md, hooks.md, dependency-injection.md, data-integrity.md, unit-tests.md) to the skill bundle, or remove the references and inline the essential conventions — as written, every detailed instruction is a dead link.

Replace 'Run linting and tests before committing changes' with the specific lint and test commands (e.g., the exact phpcs/phpunit invocations the project uses) so the validation checkpoint is executable.

Drop the redundant opening paragraph that restates the frontmatter description, and clarify the odd 'Prefer bun over npm/bunx' phrasing (npm/npx?) so it reads unambiguously.

DimensionReasoningScore

Conciseness

The body is lean, assumes Claude's competence, and explains nothing Claude already knows — close to the top anchor. It is not a 5 because of minor trimmable content: the opening sentence 'This skill provides guidance for developing WooCommerce backend PHP code according to project standards and conventions.' merely restates the frontmatter description.

4 / 5

Actionability

The in-body guidance is concrete in places — 'Place new internal classes in `src/Internal/`', 'Use PSR-4 autoloading with `Automattic\WooCommerce` namespace', and a fully executable version-determination procedure — but the primary instruction path delegates all convention detail to seven referenced files ('See [file-entities.md](file-entities.md)...') that do not exist in the bundle, so key executable details are missing. Not a 4 because following the main instructions dead-ends rather than yielding mostly executable guidance.

3 / 5

Workflow Clarity

The Version Information section gives a clear sequenced procedure (read `$version` in `includes/class-woocommerce.php` on trunk, strip `-dev`), and 'Run linting and tests before committing changes' is a checkpoint, but it is implicit with no commands given, and there is no validation or error-recovery loop for the code-modification work the skill directs. This matches the 'steps listed but validation gaps' anchor rather than 4, which requires most checkpoints to be explicit.

3 / 5

Progressive Disclosure

The SKILL.md structure itself is well organized — a topical index with clearly signaled, one-level-deep references per topic — but every one of the seven referenced files (file-entities.md, code-entities.md, coding-conventions.md, hooks.md, dependency-injection.md, data-integrity.md, unit-tests.md) is missing from the bundle, so the navigation promise fails entirely. This sits noticeably below the midpoint between 'impossible to navigate' (1) and 'good structure' (3/4): the overview is clean but the disclosed content does not exist.

2 / 5

Total

12

/

20

Passed

Description

83%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: concise, third-person, with an explicit 'Use when...' trigger clause naming concrete code artifacts (classes, methods, hooks). Coverage of backend tasks is somewhat narrow relative to what the skill body actually addresses, and a few natural synonyms (plugin, .php, WordPress) are missing.

DimensionReasoningScore

Specificity

The description lists several specific actions — 'Add or modify WooCommerce backend PHP code', 'creating new classes, methods, hooks' — with concrete artifacts, placing it at the 'several specific actions; minor gaps' anchor. It is not a 5 because it does not enumerate the full breadth of backend work covered by the skill (e.g., naming conventions, dependency injection, data integrity, testing), staying at the level of 'classes, methods, hooks'.

4 / 5

Completeness

It explicitly answers 'what' ('Add or modify WooCommerce backend PHP code following project conventions') and 'when' with a concrete trigger clause ('Use when creating new classes, methods, hooks, or modifying existing backend code in WooCommerce projects'), matching the top anchor's both-what-and-when-with-concrete-trigger-phrases pattern. It is not lower because neither half is missing or merely implied.

5 / 5

Trigger Term Quality

Natural terms a user would say are present: 'WooCommerce', 'backend PHP', 'classes', 'methods', 'hooks', 'modifying existing backend code'. It falls short of the comprehensive anchor because common variations like '.php', 'plugin', 'extension', or 'WordPress' are absent, though the core vocabulary is well chosen.

4 / 5

Distinctiveness Conflict Risk

The 'WooCommerce backend' niche is clear and the triggers ('WooCommerce projects', 'hooks') are distinct from most skills, sitting between 'mostly distinct' and 'clear niche with minimal conflict risk'. It is not a 5 because a general WordPress plugin development or PHP conventions skill would plausibly trigger on the same phrases.

4 / 5

Total

17

/

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: 8 missing

Warning

Total

15

/

16

Passed

Repository

secondsky/claude-skills

Path

plugins/woocommerce-backend-dev/skills/woocommerce-backend-dev/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.