CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

avada-commerce

AVADA Commerce integration. Manage data, records, and automate workflows. Use when the user wants to interact with AVADA Commerce data.

Quality

69%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/avada-commerce/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 a solid, command-driven integration guide: concrete CLI commands, a well-specified connection lifecycle with state-by-state handling, and a sensible escalation path from pre-built actions to the proxy. Weaknesses are modest padding (intro prose, an empty overview list, a duplicated command), a dangling 'Step 2' reference, and an inconsistent mix of 'membrane' vs 'npx' invocation styles.

Suggestions

Remove the marketing-style intro paragraph and the content-free Dashboard/Orders/Customers/Products/Analytics bullet list, or replace them with one line on what the integration covers.

Fix the dangling references: either number the workflow steps ('Step 1', 'Step 2'...) so 'skip to Step 2' resolves, or reword to 'skip to Searching for actions'.

Standardize on one invocation style ('membrane' vs 'npx @membranehq/cli@latest') and add a complete example proxy request (e.g. a POST with -X, -d, --query) alongside the flag table.

DimensionReasoningScore

Conciseness

The command documentation itself is efficient, but there is unnecessary content: a two-sentence marketing intro ('...targeting entrepreneurs and small to medium-sized businesses'), a content-free overview bullet list (Dashboard/Orders/Customers/Products/Analytics), and the action-list command duplicated in 'Searching for actions' and 'Popular actions'. This matches 'Mostly efficient but includes some unnecessary explanation or could be tightened'; not a 2 because the padding is limited rather than pervasive.

3 / 5

Actionability

Commands are concrete and copy-paste ready throughout (npm install, membrane login, connection ensure, connection get --wait, action list, action run with --input), matching 'Mostly executable guidance; concrete code or commands with minor gaps'. Not a 5 because the proxy section gives a flag table but no complete example request, and usage alternates inconsistently between 'membrane' and 'npx @membranehq/cli@latest'.

4 / 5

Workflow Clarity

The sequence (install → authenticate → connect → poll until READY → discover/run actions) is clear with explicit state-based checkpoints ('poll again... to check if the state moved to READY', 'CONFIGURATION_ERROR or SETUP_FAILED — check the error field'), matching 'Clear sequence with most checkpoints present; minor validation gaps'. Not a 5 because 'skip to Step 2' references a step that is never labeled, and there is no verification guidance for action results.

4 / 5

Progressive Disclosure

Scored against the actual bundle structure: no references/, scripts/, or assets/ directories exist, and the body makes no file references, so nothing is broken or nested. The single-file body (~125 lines) is well organized with clear section headers; minor gaps are that it exceeds the simple-skill threshold and some CLI reference material (the proxy flag table) could live in a separate reference file. This matches 'Good structure; most content is appropriately placed; references mostly clear; minor organization gaps'.

4 / 5

Total

15

/

20

Passed

Description

57%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 correctly names the target app and includes an explicit 'Use when...' trigger clause, which gives it decent completeness and distinctiveness. However, its capability statements ('Manage data, records, and automate workflows') are generic marketing-style language with no concrete actions or natural domain keywords like orders, customers, products, or email marketing.

Suggestions

Replace the generic 'Manage data, records, and automate workflows' with concrete capabilities, e.g. 'Manage AVADA Commerce orders, customers, and products; run marketing workflows'.

Add natural trigger terms users would say — e.g. 'Use when the user mentions AVADA, AVADA Commerce, or wants to work with AVADA orders, customers, products, or email marketing'.

Distinguish the skill from sibling app integrations by naming what is unique to AVADA Commerce (e.g. its email marketing and e-commerce automation focus) rather than reusable boilerplate.

DimensionReasoningScore

Specificity

Names the domain ('AVADA Commerce integration') but the actions — 'Manage data, records, and automate workflows' — are minimal and generic, matching the anchor 'Names the domain but actions are minimal or generic'. Not a 3 because no concrete action (e.g. orders, customers, products) is explicitly stated.

2 / 5

Completeness

Has both a 'what' ('Manage data, records, and automate workflows') and an explicit 'when' ('Use when the user wants to interact with AVADA Commerce data'), so the missing-trigger cap does not apply; however the 'what' is generic and the 'when' names no concrete scenarios, matching 'Has both what and when; when could be more explicit or specific'. Not a 5 because neither part includes concrete trigger phrases or capabilities.

4 / 5

Trigger Term Quality

'AVADA Commerce' is a relevant natural keyword and the trigger clause repeats it, but common variations users would actually say (orders, customers, products, email marketing) are missing, matching 'Some relevant keywords but missing common variations or synonyms'. Not a 4 because coverage beyond the app name itself is thin.

3 / 5

Distinctiveness Conflict Risk

The named app ('AVADA Commerce integration', 'interact with AVADA Commerce data') gives a clear niche with minimal wrong-skill triggering, but the generic action boilerplate overlaps with other Membrane app-integration skills, matching 'Mostly distinct; minor overlap risk with closely related skills'. Not a 5 because the triggers are just the app name rather than distinctive task phrases.

4 / 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.

Validation — 15 / 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

membranedev/application-skills

Path

skills/avada-commerce/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.