CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

apto-payments

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

Quality

66%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/apto-payments/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 body delivers concrete, executable Membrane CLI guidance with a genuinely good connection-state handling section, and it avoids teaching concepts Claude already knows. Its main weaknesses are a duplicated action-discovery section with a stub 'Popular actions' list, broken step numbering ('Step 2' / '1b' with no anchors), and the absence of any validation or verification guidance for payment-mutating operations. Tightening the redundancy and adding Apto-specific action examples would lift it materially.

Suggestions

Fix the workflow numbering: define 'Step 1/1a' and 'Step 2' sections explicitly (or remove the 'skip to Step 2' references) so the connection → discovery → execution flow is unambiguous.

Merge 'Searching for actions' and 'Popular actions' into one section, pick a single canonical command form, and actually list 3-5 popular Apto actions (e.g. list cards, get transactions, manage funding sources) with example invocations.

Add validation/verification guidance for mutating operations: confirm destructive parameters before running actions or proxy POST/PUT/DELETE calls against the payments API, and check the response `output`/`error` fields before proceeding.

Either populate the 'Apto Payments Overview' entity list with one-line descriptions of Account/Funding Source/Card/Transaction/Merchant or remove it.

DimensionReasoningScore

Conciseness

The body is mostly command-driven and efficient, but the action-discovery command is documented twice with inconsistent forms ('Searching for actions' uses `membrane action list` while 'Popular actions' repeats it as `npx @membranehq/cli@latest action list`), and the 'Apto Payments Overview' entity list is a contentless stub. This fits anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') rather than anchor 4, since the duplication and stub sections are trimmable, not merely minor over-explanation.

3 / 5

Actionability

Guidance is largely copy-paste executable: install command, login flow including the headless `login complete <code>` path, `connection ensure`, polling with `--wait`, `action run` with `--input` JSON, and a full proxy flag table. It falls short of anchor 5 because 'Popular actions' promises examples but lists none — no concrete Apto action (e.g. list cards, get transactions) is ever shown — leaving a minor gap in covering the common cases.

4 / 5

Workflow Clarity

The install → login → connect → poll → discover → run sequence is present with a state-based feedback loop (READY / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR handling and re-polling), but the flow references 'Step 2' twice with no Step 2 defined, has a '1b' heading with no '1a', and provides no verification or caution steps for financially consequential operations (action runs and arbitrary proxy POST/PUT/DELETE against a payments API). Per the destructive-operations cap, a workflow on a payments API without validation cannot score above 3.

3 / 5

Progressive Disclosure

There are no bundle files (no references/, scripts/, or assets/), so the skill is self-contained; at ~140 lines with well-organized sections (Install, Authentication, Connecting, Searching, Running actions, Proxy, Best practices) most content is appropriately placed in a single overview. Minor organization gaps — the duplicated action-list sections and the stub entity list — keep it at anchor 4 rather than 5.

4 / 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 correctly names the Apto Payments niche and includes an explicit 'Use when' clause, but its capability statement is generic connector boilerplate rather than anything specific to payments. Rewriting it around Apto's actual domain concepts (payment cards, card programs, transactions, funding sources) would substantially improve specificity, trigger coverage, and distinctiveness. Voice is appropriately third person.

Suggestions

Replace the generic phrase 'Manage data, records, and automate workflows' with Apto-specific capabilities, e.g. 'Create and manage branded payment cards, card programs, funding sources, and transactions'.

Expand the 'Use when' clause with concrete trigger phrases users would naturally say, e.g. 'Use when the user mentions Apto Payments, payment cards, card issuing, or card program management'.

Add natural synonyms and domain vocabulary (issuing, cardholder, transaction history, rewards/loyalty cards) to reduce overlap with other generic data-connector skill descriptions.

DimensionReasoningScore

Specificity

The description names the domain ("Apto Payments integration") but the actions — "Manage data, records, and automate workflows" — are generic boilerplate that could describe any connector, with no concrete operations like creating cards or listing transactions. This matches the anchor 'Names the domain but actions are minimal or generic' and falls short of level 3, which requires 1-2 genuinely concrete actions.

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 Apto Payments data"). However, the when clause merely restates the domain and the what is vague, so it fits anchor 4 ('when' could be more explicit or specific) rather than anchor 5's concrete trigger phrases. The explicit 'Use when...' clause keeps it above the cap of 3.

4 / 5

Trigger Term Quality

"Apto Payments" is a natural term a user would say, but the remaining keywords ("data", "records", "workflows") are generic, and common synonyms a user would actually use — payment cards, card programs, transactions, issuing — are missing. It has some relevant keywords but is missing common variations, matching anchor 3 rather than anchor 4's 'good keyword coverage'.

3 / 5

Distinctiveness Conflict Risk

The named platform gives it a clear niche with minimal conflict risk against unrelated skills, but the generic tail "Manage data, records, and automate workflows" is likely identical across sibling Membrane connector skills, creating minor overlap risk with closely related skills. This matches anchor 4 rather than anchor 5, whose example includes distinct concrete triggers.

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/apto-payments/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.