CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

3dcart

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

Quality

67%

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/3dcart/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 CLI guide with genuinely good connection-lifecycle handling (polling, client actions, error states) and executable commands at every step. Its weaknesses are structural and editorial: an unnecessary platform introduction, a redundant "Popular actions" section that lists no actions, and broken internal references ("Step 2", "1b") that leave the workflow numbering incoherent. Tightening the prose and repairing the section structure would move it from adequate to strong.

Suggestions

Fix the internal navigation: replace the dangling "skip to **Step 2**" references and the orphan "#### 1b" heading with a consistently numbered step sequence (install → login → connect → discover → run).

Delete the redundant "Popular actions" section or populate it with actual common action examples, and remove the 3dcart platform introduction plus "Use action names and parameters as needed" filler.

Add a brief validation note for mutating action runs (e.g., check the response error/output fields, or run a read action to confirm the connection works) before relying on results.

DimensionReasoningScore

Conciseness

Mostly efficient command-focused prose, but it includes unnecessary material: the opening paragraph explaining what 3dcart is ("3dcart is an e-commerce platform that provides businesses with the tools to build and manage online stores..."), the filler line "Use action names and parameters as needed," and duplicated action-discovery instructions in both "Searching for actions" and "Popular actions." It is not a 2 because the bulk is concrete commands rather than padded explanation, and not a 4 because several sections could clearly be trimmed.

3 / 5

Actionability

Concrete, executable bash commands throughout (npm install, membrane login, connection ensure, action list/run with --input JSON, proxy flags table). Minor gaps keep it from a 5: CONNECTION_ID placeholders are never tied to where they come from, the "Popular actions" section promises popular actions but only repeats the discovery command instead of showing any real ones, and two "skip to **Step 2**" references point to a section that does not exist. Well above a 3 since everything shown is copy-paste ready.

4 / 5

Workflow Clarity

The sequence is clear and state-aware: install → login (with headless fallback and code completion) → connection ensure → poll with --wait, then explicit per-state handling (READY, CLIENT_ACTION_REQUIRED with clientAction fields, CONFIGURATION_ERROR/SETUP_FAILED) and a re-poll feedback loop. It misses a 5 because there are no validation steps around running mutating actions and the dangling "Step 2" reference and orphan "1b" numbering break the numbered structure; it stays above 3 because the connection-lifecycle checkpoints and error-recovery loop are explicit.

4 / 5

Progressive Disclosure

There are no bundle files, so everything lives inline in a ~145-line SKILL.md with usable section headers. Structure is present but uneven: the "Popular actions" section duplicates "Searching for actions" instead of listing actions, "1b" appears without a "1a" or numbered steps, and "Step 2" is referenced but undefined, making navigation genuinely confusing. Not a 2 — headers, a table, and code blocks keep it navigable — but the disorganization and redundancy fall short of a 4.

3 / 5

Total

14

/

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 has the right shape — third-person capability statement plus an explicit 'Use when' trigger — but its capability language is generic boilerplate that never says what can actually be done with 3dcart. Naming the platform provides distinctiveness, yet the trigger coverage relies on that single term. Concrete entity-level actions and a few richer trigger phrases would lift it substantially.

Suggestions

Replace "Manage data, records, and automate workflows" with concrete capability statements naming the actual entities (e.g., "Query and update orders, products, customers, discounts, and returns; automate workflows across your 3dcart store").

Broaden the trigger clause beyond the bare platform name: "Use when the user wants to work with 3dcart data — orders, products, customers, or subscriptions — or mentions their 3dcart/Shift4Shop store."

Avoid over-claims like "automate workflows" unless the skill body concretely supports automation guidance.

DimensionReasoningScore

Specificity

The description names the domain ("3dcart integration") but the stated actions are generic: "Manage data, records, and automate workflows" could describe almost any integration skill and names no concrete operations (e.g., orders, products, customers). It is not a 1 because the domain is named and the actions, while generic, are at least stated as verbs; it does not reach 3 because no concrete, 3dcart-specific action is enumerated.

2 / 5

Completeness

It answers both parts: a (vague) what — "Manage data, records, and automate workflows" — and an explicit when — "Use when the user wants to interact with 3dcart data". The 'when' clause is present and explicit but could be more specific, matching the anchor where both exist with room for a sharper trigger; not a 5 because the 'what' lacks concrete capability statements, and not a 3 because the 'Use when' trigger guidance is explicit rather than implied.

4 / 5

Trigger Term Quality

"Use when the user wants to interact with 3dcart data" supplies the natural trigger keyword "3dcart", but there are no synonyms or related natural phrases (e-commerce, store, orders, products, shopping cart). Matches the anchor for some relevant keywords but missing common variations; not a 4 since coverage is essentially a single term, and better than 2 because the one term present is exactly what a user needing this skill would say.

3 / 5

Distinctiveness Conflict Risk

"3dcart" is a specific platform name, giving the skill a clear niche with distinct triggers and minimal conflict risk. It sits below 5 only because the generic tail ("Manage data, records, and automate workflows") could overlap with other e-commerce/integration skills (e.g., a Shopify skill), and above 3 because the platform name alone disambiguates most collisions.

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/3dcart/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.