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

80%

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/agent-plugins/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.

A well-engineered interactive workflow: concrete scripts and output templates, mandatory validation gates with a blocked-configuration feedback loop, and a clean one-level-deep reference structure covering real files. The main costs are repetition — the checklist reprinted at every step and public-preview disclosure rules stated three times — and inline duplication of the compatibility matrix.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious, Connect-specific directives and assumes Claude's competence about general concepts, but contains real padding: the full progress checklist is reprinted four times (once per step), and the Express public-preview disclosure requirements with the preview-changelog link are repeated nearly verbatim three times (Step 3 guardrails, Step 4a express/stripe, Step 4a express/application). This fits the 3 anchor ('mostly efficient but includes some unnecessary explanation or could be tightened'); it is more than the 'minor instances' of the 4 anchor.

3 / 5

Actionability

For an instruction-only skill the guidance is fully executable: exact question scripts with option labels ('"I have a URL" — user provides URL, then research it'), copy-paste warning text ('Warn: "Your platform fee might be below Stripe's processing fees..."'), specific grep patterns ('transfers.create, payouts.create', 'account.updated, capability, payout'), and exact config tuples to validate. This matches the 5 anchor's 'copy-paste ready... specific examples cover the common cases'; absence of code is not penalized per the rubric's instruction-skill note.

5 / 5

Workflow Clarity

Steps 0–6 are clearly sequenced with explicit validation checkpoints: 'Step 4a — Compatibility validation (MANDATORY before presenting recommendation)', '1f. Validate fee economics (ALWAYS runs...)', a fee-structure checkpoint gating Step 4, a visible progress checklist updated at each step, and a feedback loop for error recovery (BLOCKED combination → do not present → output fix → 're-run the recommendation with the corrected configuration'). This matches the 5 anchor (explicit validation, feedback loops, checklists).

5 / 5

Progressive Disclosure

The body is an orchestration overview with all eight references/ files existing, each referenced with a clear purpose ('Read <references/decision-matrix.md> and apply it...'), and references are exactly one level deep (no references/ files point further into the bundle). However, Step 4a's long enumeration of express/full compatibility rules duplicates rules already encoded in references/compatibility-matrix.md, and repeated preview-changelog links inflate the overview — content that belongs in the referenced file is inlined, which fits the 4 anchor ('most content appropriately placed; minor organization gaps') better than 5.

4 / 5

Total

17

/

20

Passed

Description

68%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.

An exceptionally thorough trigger description with strong natural-language synonym coverage and a clear Connect niche, but it is almost entirely 'when' with no explicit statement of what the skill does. Adding a leading capability sentence (research the business, scan the codebase, validate compatibility, produce a recommendation plan) would raise both specificity and completeness.

Suggestions

Open with an explicit capability statement, e.g. 'Recommends the right Stripe Connect integration configuration by researching the user's business, scanning their codebase, and generating a recommendation plan.' — this would supply the missing 'what' for completeness and add concrete actions for specificity.

Qualify the broadest triggers with Connect context (e.g. 'asks about payment flows between a platform and its sellers' instead of 'asks about payment flows') to reduce false-trigger and overlap risk.

Consolidate the single very long trigger sentence and redundant synonym lists into a shorter structured form — verbosity is not rewarded, and the same coverage can be kept in fewer tokens.

DimensionReasoningScore

Specificity

The domain is named with specific concepts ("Stripe Connect configuration, charge patterns, Dashboard access"), but the skill's concrete actions are barely stated — only "for a recommendation" implies what it does, while scanning the codebase, discovery questions, compatibility validation, and plan generation are never mentioned. It names the domain plus roughly one concrete action, matching the 3 anchor ('names domain and 1-2 concrete actions, but not comprehensive') rather than 2, since the domain concepts are specific rather than generic.

3 / 5

Completeness

The 'when' is explicit and exhaustive ("Use this skill when the user asks about..."), but the 'what' is only weakly implied through "for a recommendation" — the description never states a capability like 'recommends the right Connect configuration and generates a plan'. Since scoring only what is explicitly stated, the weak 'what' keeps it at 3 (one half clear, the other weak/implied) rather than 4, which requires a solid statement of both.

3 / 5

Trigger Term Quality

Comprehensive natural-language coverage with abundant synonyms users would actually say: "marketplace, platform, multi-vendor store, gig platform, or subscription platform", "pay out sellers, vendors, or providers", "split payments, revenue sharing, multi-party payments", "onboarding or KYC", "white-label payments, or embedded payments". This matches the 5 anchor's requirement for comprehensive natural terms including synonyms; no common variation is obviously missing.

5 / 5

Distinctiveness Conflict Risk

The niche is clear and Connect-specific ("connected account Dashboard or responsibility configurations", "charge patterns") and even includes disambiguation ("not operational SaaS without payment routing"). However, a few triggers are broad enough to fire outside Connect contexts — "asks about payment flows" and "asks about onboarding or KYC for merchants" could match general payments or KYC questions — creating minor overlap risk, which fits the 4 anchor better than 5.

4 / 5

Total

15

/

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/agent-plugins/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.