CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

big-cartel

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

Quality

65%

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/big-cartel/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%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 operationally strong — concrete executable CLI commands, thorough connection-state handling, and a full action catalog — but it is diluted by marketing-style padding, an incomplete step-labeling scheme (dangling "Step 2" references), and no progressive disclosure into reference files. Destructive actions lack any validation guidance, capping workflow clarity.

Suggestions

Fix the dangling "Step 2" references by explicitly numbering the workflow steps (install → authenticate → connect → discover → run) or removing the step labels entirely.

Add a validation step for destructive actions (delete-category, delete-discount): get the record first and confirm with the user before running the delete.

Move the Popular actions table to a references/actions.md file and trim the platform-intro paragraph and the content-free "Big Cartel Overview" bullets from SKILL.md.

DimensionReasoningScore

Conciseness

The CLI command examples are lean, but padding is noticeable: a three-sentence platform pitch ("Big Cartel is an e-commerce platform... It provides simple tools for building a storefront..."), a content-free "Big Cartel Overview" bullet tree ("Products / Product / Orders / Order / Account"), and a broken aside ("Those will be used to adjust tooling to be used best with your harness"). Anchor 3 rather than 4 because multiple sections add no operational value.

3 / 5

Actionability

Nearly everything is copy-paste ready: "membrane connection ensure \"https://bigcartel.com\" --json", "membrane action run <actionId> --connectionId=... --input '{...}'", plus a 20-row actions table with keys and descriptions. Anchor 4 rather than 5 because examples stay placeholder-generic ({"key": "value"}) and the table lists action "Key" while run commands take an "actionId", leaving the mapping ambiguous.

4 / 5

Workflow Clarity

The connect-then-poll sequence has real checkpoints ("READY — skip to Step 2", "CLIENT_ACTION_REQUIRED — ... poll again", "CONFIGURATION_ERROR or SETUP_FAILED — check the error field"), but the referenced "Step 2" is never labeled anywhere in the document, and destructive actions (delete-category, delete-discount) are offered with no verification guidance. Per the rubric's cap for destructive/batch operations without validation, workflow clarity cannot exceed 3.

3 / 5

Progressive Disclosure

Section structure is decent, but ~20 rows of API-catalog content (the "Popular actions" table) are inlined where a reference file belongs, and the skill ships no bundle files at all (no references/, scripts/, or assets/). Anchor 3 ("content that should be separate is inline"), not 4, because there are no one-level-deep references to be "mostly clear" — everything lives in the single SKILL.md.

3 / 5

Total

13

/

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 names the domain and includes an explicit 'Use when' clause, but its capability statement is generic boilerplate that would fit any app integration, and the only natural trigger term is the brand name itself. It is serviceable but leaves task-level phrasing users would actually use (products, orders, discounts, store) uncovered.

Suggestions

Replace "Manage data, records, and automate workflows" with concrete capabilities, e.g. "List, create, update, and delete products, orders, categories, discounts, and shipments in a Big Cartel store."

Expand the trigger clause with natural user phrases, e.g. "Use when the user mentions Big Cartel, their Big Cartel store, products, orders, discounts, or shipments."

State the domain context (artist/creator storefront) so the skill reads as distinct rather than one of a family of interchangeable integration descriptions.

DimensionReasoningScore

Specificity

Names the domain ("Big Cartel integration") but the actions — "Manage data, records, and automate workflows" — are generic boilerplate applicable to any integration; no concrete operations such as products, orders, or discounts are ever named. Closest to anchor 2 ("Names the domain but actions are minimal or generic"), not 3, because the description never states what is actually done with that data.

2 / 5

Completeness

Both parts are present: a what ("Manage data, records, and automate workflows") and an explicit when ("Use when the user wants to interact with Big Cartel data"), matching anchor 4. Not 5 because both the what and the when are generic and lack concrete trigger phrases; not 3 because the "Use when..." clause is explicit rather than missing or weakly implied.

4 / 5

Trigger Term Quality

The only substantive natural term is "Big Cartel" (used twice), mirroring anchor 3's "Works with PDF files" pattern. Not 4 — users would naturally say "products", "orders", "store", or "merch" and none appear; not 2 — "Big Cartel" is a specific domain keyword rather than generic filler like "files".

3 / 5

Distinctiveness Conflict Risk

"Big Cartel" names a clear niche with minimal conflict risk, but the surrounding boilerplate ("Manage data, records, and automate workflows") would read identically for any sibling app-integration skill, leaving the app name as the sole differentiator. Anchor 4 (mostly distinct, minor overlap with closely related skills) rather than 5 (distinct triggers beyond just the brand name).

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/big-cartel/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.