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

77%

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/claude/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 strongly engineered consultative workflow: mandatory compatibility validation, explicit feedback loops, checklists, and copy-paste scripts/options make it highly actionable and sequenced, with a well-organized one-level reference bundle. Its main weakness is redundancy — repeated checklist blocks and compatibility/preview rules stated in two or three places (inline and in references) inflate the token budget without adding guidance value.

Suggestions

Replace the five full checklist reprints with a single instruction ("mark the current step complete in the progress checklist"), saving ~30 lines.

Deduplicate the public-preview rules: state them once (Step 4a or a short reference section) and have the Step 3 SaaS guardrail point there, since both currently repeat the same four disclosure requirements and BLOCKED caveats.

Move the Step 4a enumerated compatibility rules into references/compatibility-matrix.md (which already contains the Core Rule and full matrix), keeping only "cross-check the tuple against the matrix; if BLOCKED, show tuple + mechanism + nearest ALLOWED fix" inline.

DimensionReasoningScore

Conciseness

The body assumes Claude's competence — no concept explanations or padding — but contains structural redundancy beyond "minor" trimmings: the 4-line progress checklist is reprinted in full five times, the public-preview disclosure rules appear nearly verbatim in both the Step 3 SaaS guardrail and Step 4a items 3, and the BLOCKED rules inlined at Step 4a duplicate the Core Rule already in references/compatibility-matrix.md. That matches anchor 3 (mostly efficient, could be meaningfully tightened) rather than 4's "minor instances".

3 / 5

Actionability

Fully executable instruction-only guidance: exact question scripts and option sets ("Does this recommendation look right?" with max-4 options), copy-paste warning text, specific grep patterns ("transfers.create", "account.updated", "application_fee_amount"), named embedded components, exact output file ("connect-recommend-plan.md"), and unambiguous decision rules (BLOCKED/CAUTION/SALES-GATED with the fix path). Common cases are covered with concrete scripts, matching anchor 5.

5 / 5

Workflow Clarity

Steps 0-6 are explicitly sequenced with ordering constraints ("ALWAYS runs first", "Run this AFTER Step 1"), a mandatory pre-presentation validation gate (Step 4a compatibility cross-check), explicit feedback loops (BLOCKED → corrected configuration → re-run; "Change something" → re-ask the relevant question), a fee-structure checkpoint before Step 4, and a progress checklist — anchor 5's validation, error-recovery, and checklist requirements are all literally present. The workflow is conversational/consultative, not destructive or batch, so no cap applies.

5 / 5

Progressive Disclosure

All eight references/ files exist, are referenced in the body, are one level deep (no reference file points to another), and are well-signaled at point of need ("Read <references/decision-matrix.md> and map the findings..."). However, the 361-line body inlines material that duplicates the bundle — Step 4a's enumerated compatibility rules restate compatibility-matrix.md's Core Rule, and the ~250-word SaaS guardrail paragraph overlaps discovery-questions.md — so content placement has real gaps versus anchor 5's "appropriately split".

4 / 5

Total

17

/

20

Passed

Description

61%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 unusually thorough, well-differentiated trigger list that makes the "when" crystal clear, but it is trigger-only: it never explicitly states what the skill does, forcing the reader to infer the recommendation function from one incidental phrase. Adding a leading capability statement (e.g., "Recommends the right Stripe Connect integration configuration...") would lift both completeness and specificity.

Suggestions

Open the description with an explicit capability statement before the trigger list, e.g., "Recommends the right Stripe Connect integration configuration (dashboard, responsibility settings, charge pattern) for a business," so the 'what' is stated rather than inferred from "for a recommendation".

Add missing natural trigger terms users commonly say: "account type" (e.g., "what Connect account type should I use?"), "express/custom/standard accounts", and "payouts" as a noun, since the skill's own body handles account-type reframing.

Trim the overlapping trigger clauses (the list restates payment-routing concepts three ways: "payment flows", "multi-party payments", "routes money between parties") to reduce token cost without losing coverage.

DimensionReasoningScore

Specificity

The domain is named with rich, concrete vocabulary ("Stripe Connect configuration, charge patterns, Dashboard access", "split payments, revenue sharing, multi-party payments", "onboarding or KYC"), but the only explicit action is "for a recommendation" — what the skill actually does (recommend an integration configuration) is otherwise unstated. This matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive) rather than 4, which requires several listed actions, or 2, whose domain naming would be generic.

3 / 5

Completeness

The "when" is maximally explicit ("Use this skill when the user asks about...") with concrete trigger phrases, but the "what" is only vaguely present via "provides a company URL or business description for a recommendation" — the skill's core function (recommending a Connect configuration) must be inferred. This is not anchor 4 (which needs both present with the 'when' as the weaker side) nor anchor 2 ('when' present with no 'what' at all), so 3 fits best.

3 / 5

Trigger Term Quality

Strong natural-phrase coverage with synonyms ("marketplace, platform, multi-vendor store, gig platform", "pay out sellers, vendors, or providers", "white-label payments, embedded payments") — phrases users would genuinely say. A few natural terms are missing ("account types", "express/custom/standard accounts", "payouts" as a noun) and some triggers lean technical ("responsibility configurations", "charge patterns"), so it sits between anchors 4 and 5, landing at 4.

4 / 5

Distinctiveness Conflict Risk

The Stripe Connect niche is clear and triggers are distinct, with a thoughtful carve-out ("not operational SaaS without payment routing") that shows conflict awareness. Minor overlap risk remains with closely related Stripe skills: "subscription platform" could pull in Billing/subscription questions, and "POS, booking, invoicing" examples broaden the surface — matching anchor 4 rather than 5's "minimal conflict risk".

4 / 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/claude/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.