Name: braintree
Rating: 57.599999999999994 (1 reviews)
Author: membranedev

braintree

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

Quality

66%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Medium

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./skills/braintree/SKILL.md

Quality

Content

76%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 executable CLI commands and a clear connection workflow, and it is reasonably concise and well-structured. Its main weakness is the absence of validation/verification guidance for the destructive actions the skill exposes.

Suggestions

Add a validation/verification checkpoint around destructive actions, e.g. 'Before running delete-payment-method or refund/void, confirm the target ID with the user and verify the resulting transaction state afterward.'

Trim editorial filler such as the agent-types aside and 'This is the fastest way to get a connection' to tighten token efficiency.

Consider moving the full popular-actions catalog to a separate reference file and keeping a small representative subset inline, with a clearly signaled link to the complete list.

Dimension	Reasoning	Score
Conciseness	The body is mostly lean and command-driven with minimal concept over-explanation, but contains minor trimmable editorial phrases like 'This is the fastest way to get a connection' and the loose agent-types line.	4 / 5
Actionability	It provides fully executable, copy-pasteable membrane CLI commands with flags and a proxy option table covering the common cases (auth, connecting, searching/running actions, proxying requests).	5 / 5
Workflow Clarity	The connection flow is sequenced with a poll-until-ready loop and state branching, but the skill exposes destructive operations (delete-payment-method, delete-customer, refund/void) with no validation/verification steps, capping clarity at 3.	3 / 5
Progressive Disclosure	The single SKILL.md is well-organized with clear section headers and no nested references, though the 18-row popular-actions table is borderline bulk inline reference that could be split out.	4 / 5
	Total	16 / 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 identifies the Braintree domain and includes an explicit Use-when trigger, but its action language is generic and lacks concrete domain-specific operations or richer trigger synonyms. It is distinguishable mainly because of the named service rather than its descriptive specificity.

Suggestions

Replace generic verbs with concrete Braintree operations, e.g. 'charge and refund transactions, vault payment methods, search customers, and manage subscriptions and disputes.'

Broaden trigger terms to include natural user phrasings like 'payments, transactions, refunds, chargebacks, or vaulting payment methods' alongside 'Braintree data'.

Tie the 'when' clause to specific intents, e.g. 'Use when the user wants to process payments, manage customers, or handle disputes in Braintree.'

Dimension	Reasoning	Score
Specificity	It names the domain (Braintree) but the actions are generic ('Manage data, records, and automate workflows') with no concrete domain-specific operations like charge, refund, or search.	2 / 5
Completeness	Both a 'what' ('Braintree integration. Manage data, records, and automate workflows.') and an explicit 'when' ('Use when the user wants to interact with Braintree data.') are present, though the 'what' is generic.	4 / 5
Trigger Term Quality	'Braintree' and 'interact with Braintree data' are natural terms, but coverage is thin with no synonyms or related keywords (payments, transactions, refunds, subscriptions).	3 / 5
Distinctiveness Conflict Risk	'Braintree' is a distinctive named service giving a clear niche, but the generic 'manage data, records, automate workflows' phrasing creates minor overlap risk with other CRM-style skills.	4 / 5
	Total	13 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
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/braintree/SKILL.md
Commit: f484c82

Reviewed: 4 days ago

Table of Contents

Discovery Implementation Validation

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.