CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

connect-recommend

Use this skill when the user asks about Stripe Connect configuration, charge patterns, Dashboard access, or how to get started with Connect, is building a marketplace, platform, multi-vendor store, gig platform, or subscription platform, needs to pay out sellers, vendors, or providers, mentions split payments, revenue sharing, multi-party payments, or similar payment distribution concepts, provides a company URL or business description for a recommendation, builds SaaS that routes money between parties (for example, POS, booking, invoicing — not operational SaaS without payment routing), asks about onboarding or KYC for merchants, sellers, and vendors, mentions connected account Dashboard or responsibility configurations, or asks about payment flows, white-label payments, or embedded payments.

Quality

76%

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 ./providers/antigravity/plugin/skills/connect-recommend/SKILL.md

The canonical home for this skill is connect-recommend in stripe/ai

SKILL.md
Quality
Evals
Security

Quality

Content

81%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 well-engineered interactive workflow: concrete scripts, mandatory validation with correction loops, and a clean one-level reference bundle that all checks out on disk. Its main weakness is token efficiency — repeated checklist blocks, triplicated public-preview instructions, and a few wall-of-text guardrail paragraphs that could be compressed or pushed into the references.

Suggestions

Replace the five full checklist reproductions with a single 'update the checklist' instruction plus one canonical checklist block in Step 0.

State the public-preview disclosure requirements once (e.g., in a short subsection or in the compatibility-matrix reference) and have the two Step 4a bullets and the Step 3 guardrail reference it instead of restating all four requirements three times.

Break the Step 3 SaaS direct-charge guardrail into a short decision list and move the Express preview configuration detail into a reference file, mirroring how discovery questions are already handled.

DimensionReasoningScore

Conciseness

Most of the body is dense, non-obvious Stripe policy (compatibility tuples, fee-economics rules) that earns its tokens, but there is real padding: the 4-line progress checklist is reproduced in full five times, the public-preview disclosure instructions are stated three times (Step 3 guardrail and both Step 4a bullets), and the Step 3 SaaS guardrail is a single ~200-word run-on paragraph. This fits 'mostly efficient but could be tightened'; a 2 would require several sections of explanation Claude already knows, which is not the case.

3 / 5

Actionability

The guidance is copy-paste ready throughout: exact user-facing question scripts and option sets ('Does this recommendation look right?' with three defined responses), exact warning copy with links, concrete grep patterns for the codebase scan ('transfers.create', 'account.updated', 'transfer_data'), and specific API field names (dashboard, fees_collector, losses_collector, application_fee_amount) with defined behavior for each option. As an instruction-only skill, the absence of code is not penalized and the specificity fully covers common cases.

5 / 5

Workflow Clarity

Steps 0-6 are explicitly numbered and sequenced, each step ends with a checklist update, and there are genuine validation checkpoints with feedback loops: a mandatory compatibility validation before presenting any recommendation, BLOCKED configs trigger 're-run the recommendation with the corrected configuration', a fee-structure checkpoint gates Step 4, and 'Change something' loops back to re-ask the relevant question. This matches the top anchor including error-recovery loops.

5 / 5

Progressive Disclosure

All 8 referenced files (terminology-rules, company-researcher, decision-matrix, discovery-questions, account-types, charge-patterns, compatibility-matrix, recommendation-template) exist in references/, are one level deep, and are clearly signaled at the point of need ('Read <references/decision-matrix.md> and apply it'), with bulk content correctly split out (38KB decision matrix, 20KB discovery questions). Not a 5: SKILL.md itself runs ~360 lines and inlines compatibility and guardrail detail that overlaps the reference files, and there is no upfront index of the reference bundle.

4 / 5

Total

17

/

20

Passed

Description

58%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 excellent trigger coverage and a clearly distinct niche, but it is entirely one-sided: it exhaustively enumerates when to use the skill while never stating what the skill actually does. Adding a leading capability statement would fix both the completeness and specificity gaps at once.

Suggestions

Open with an explicit 'what' statement, e.g., 'Recommends the right Stripe Connect integration configuration (dashboard type, responsibility settings, charge pattern) from a company URL or a business description.', then keep the trigger enumeration.

The parenthetical exclusion '(for example, POS, booking, invoicing — not operational SaaS without payment routing)' is doing double duty as the only capability hint; fold its content into the what-statement so the triggers can stay lean.

Trim overlapping trigger variants (e.g., consolidate 'asks about payment flows' with the earlier flow-related triggers) so the description stays scannable once the what-statement is added.

DimensionReasoningScore

Specificity

The description names the domain richly ('Stripe Connect configuration, charge patterns, Dashboard access', 'connected account Dashboard or responsibility configurations') but contains no concrete capability actions — it never says what the skill does. This matches the anchor 'Names the domain but actions are minimal or generic'; a 3 would require at least 1-2 explicit actions, which are absent.

2 / 5

Completeness

Only the 'when' is present — the description is a single trigger enumeration with no statement of what the skill does (e.g., 'recommends a Stripe Connect integration configuration'). This matches the anchor 'only when is present without what'; scoring only what is explicit, the capability must be inferred, so it cannot reach 3.

2 / 5

Trigger Term Quality

Comprehensive natural-language triggers with synonyms: 'marketplace, platform, multi-vendor store, gig platform', 'pay out sellers, vendors, or providers', 'split payments, revenue sharing, multi-party payments', 'onboarding or KYC', 'white-label payments, or embedded payments'. These are exactly the phrases a user needing this skill would say, with no obvious variation missing.

5 / 5

Distinctiveness Conflict Risk

Clear niche (Stripe Connect configuration recommendation for payment-routing businesses) with distinct, specific triggers like 'split payments', 'connected account Dashboard', and 'white-label payments'. Minimal overlap risk with other skills; a neighboring anchor would require generic language that is not present.

5 / 5

Total

14

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

stripe/ai

Path

providers/antigravity/plugin/skills/connect-recommend/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.