CtrlK
BlogDocsLog inGet started
Tessl Logo

taxjar

TaxJar integration. Manage Orders, Nexuses, Customers. Use when the user wants to interact with TaxJar data.

54

Quality

61%

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

Quality

Content

61%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 content is highly actionable with concrete Membrane CLI commands and a well-sequenced connection workflow, but its conciseness is diluted by redundant action-list examples and concept over-explanation, and its data-operation workflows lack the validation checkpoints required for destructive operations.

Suggestions

Collapse the duplicate "Searching for actions" and "Popular actions" sections into one action-discovery block, and trim the opening TaxJar overview and best-practices prose to what Claude does not already know.

Add explicit validation/verification steps around destructive operations (e.g. verify a transaction was created/updated before proceeding, confirm before Delete Nexus/transaction/refund), including a read-back or list-after-mutate checkpoint.

Add at least one fully worked end-to-end example with a real actionId and sample input/output to lift actionability from 4 toward 5.

DimensionReasoningScore

Conciseness

The body is largely command-dense and efficient, but it includes a TaxJar-is-a-SaaS overview (a concept Claude already knows), two near-duplicate action-list examples (the "Searching for actions" and "Popular actions" sections), and padded best-practices prose ("burn less tokens and make communication more secure"). This fits anchor 3 (mostly efficient, some unnecessary explanation that could be tightened) rather than 4.

3 / 5

Actionability

It provides concrete, copy-paste-ready commands throughout (install, login, connection ensure with a real URL, polled connection get, action list/run with --input, request proxy) plus a flag table, matching anchor 4 (mostly executable guidance with minor gaps). It is not 5 because there is no fully worked end-to-end example showing a real actionId and its output being acted upon.

4 / 5

Workflow Clarity

The connection workflow has a clear sequence with a state-based feedback loop (poll until READY, handle CLIENT_ACTION_REQUIRED / errors), but the skill covers destructive operations (Delete Nexus, Delete/Update sales transactions and refunds) with no validation or verification checkpoints. Per the rubric's destructive-operations guideline, missing validation caps workflow_clarity at 3, so it does not reach anchor 4 despite the strong connection sequence.

3 / 5

Progressive Disclosure

No bundle files are provided; the single SKILL.md is organized into clear section headers with no nested references, and the inline action catalog is a compact ~33-line overview rather than a 200-line reference dump. This matches anchor 4 (good structure, minor organization gaps such as the redundant action-list sections). It is not 5 because a 165-line skill makes no use of one-level-deep reference files, and not 3 because the structure is genuinely good rather than merely "some".

4 / 5

Total

14

/

20

Passed

Description

62%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 cleanly answers both what and when with a product-specific trigger, scoring well on completeness and distinctiveness. It is held back by a generic "Manage" verb (specificity) and missing common natural terms like "sales tax" and "tax filing" (trigger quality).

Suggestions

Replace the generic verb "Manage" with specific actions, e.g. "Calculate sales tax for orders, list and create nexus locations, create and update customers".

Add natural trigger terms users actually say, e.g. "Use when the user wants to calculate sales tax, manage tax nexuses, or file/report sales tax via TaxJar."

Mention the core capability (sales tax calculation/reporting/filing) in the description to strengthen both specificity and trigger coverage.

DimensionReasoningScore

Specificity

"Manage Orders, Nexuses, Customers" names the domain plus several concrete entity targets, but the single generic verb "Manage" collapses distinct actions (list/create/delete) rather than listing them. It clears anchor 3 (domain + a few concrete action targets, not comprehensive) but not 4, which requires several specific distinct action verbs.

3 / 5

Completeness

It states both a clear "what" ("TaxJar integration. Manage Orders, Nexuses, Customers") and an explicit "when" ("Use when the user wants to interact with TaxJar data"), satisfying anchor 4. It is not 5 because the trigger is generic ("interact with TaxJar data") rather than concrete trigger phrases (e.g. "mentions sales tax, TaxJar, nexus, orders"), and not 3 because both what and when are clearly present (no missing-trigger cap).

4 / 5

Trigger Term Quality

It includes natural product/entity keywords ("TaxJar", "Orders", "Nexuses", "Customers") and an explicit trigger ("Use when the user wants to interact with TaxJar data"), but omits common natural variations a user would say such as "sales tax", "tax calculation", "reporting", or "filing". This matches anchor 3 (some relevant keywords, missing common synonyms), falling short of anchor 4's fuller coverage.

3 / 5

Distinctiveness Conflict Risk

TaxJar is a named SaaS product with a distinct sales-tax niche, and "Nexuses" is a product-specific tax concept, giving a clear niche with minimal conflict. It is not 5 because the generic terms "Orders" and "Customers" overlap with e-commerce/CRM skills, leaving minor overlap risk per anchor 4.

4 / 5

Total

14

/

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.

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