CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-payments

Agent skill for payments - invoke with $agent-payments

56

3.70x
Quality

32%

Does it follow best practices?

Impact

100%

3.70x

Average score across 3 eval scenarios

SecuritybySnyk

Medium

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/agent-payments/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

36%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 an agent persona prompt with a strong concrete tool-call section, but it buries that actionability under verbose aspirational sections, presents focus areas as if they were a workflow, and opens with a stray second YAML frontmatter block that confuses the skill's identity. Financially risky operations (payments, tier upgrades) lack any validation or error-recovery guidance.

Suggestions

Remove the duplicate frontmatter block at the top of the body and keep a single, accurate YAML header, moving the persona description into clean prose sections.

Convert the 'financial management approach' list into a sequenced workflow with validation checkpoints (e.g., check balance → warn user below threshold → create payment link → confirm credit applied → verify via ruv_history).

Trim the 'Quality standards' and 'Cost optimization strategies' sections to the few items that carry Flow Nexus-specific facts, and move the tool-signature reference and tier tables into a references/ file with a one-level-deep pointer.

DimensionReasoningScore

Conciseness

Several sections are padded filler that add no executable guidance: 'Quality standards' ('Secure payment processing with industry-standard encryption', 'Responsive billing support and dispute resolution'), the closing paragraph ('always prioritize transparency, cost efficiency, security, and user value...'), and generic advice like 'Batch Operations: Group related tasks to minimize overhead costs' that Claude does not need taught. This matches 'Noticeably verbose; several unnecessary explanations or padded sections' — below level 3, whose padding is limited to isolated instances.

2 / 5

Actionability

The toolkit block is genuinely concrete (real MCP tool names with parameter shapes, e.g., mcp__flow-nexus__configure_auto_refill({enabled, threshold, amount})), but everything else is descriptive rather than instructive — 'Track credit usage and predict refill needs' and 'Evaluate subscription needs and recommend appropriate tiers' give no steps, thresholds, or error handling. This lands at 'Some concrete guidance but incomplete' rather than level 4, where guidance is mostly executable with only minor gaps.

3 / 5

Workflow Clarity

The 'Your financial management approach' numbered list (Balance Monitoring, Payment Optimization, ...) is a list of focus areas, not a sequenced workflow, and there are zero validation checkpoints for operations (payments, tier upgrades) that are financially risky — per the rubric's cap guidance, missing validation in risky operations keeps this at or below 3. It matches level 2 ('Rough sequence present but many gaps; steps poorly defined; validation absent') rather than level 3 because even the sequence itself is not an actual step order.

2 / 5

Progressive Disclosure

The body has recognizable sections (responsibilities, toolkit, approach, tiers, optimization), but a stray duplicate YAML frontmatter block ('name: flow-nexus-payments / color: pink') sits at the top of the body, muddying what the skill actually is, and everything is inlined in one monolithic prompt with no reference files. This matches 'Some structure but could be better organized' — above level 2's truly minimal structure, but below level 4 given the confusing duplicate frontmatter and no separation of the large reference-style lists (tool signatures, tiers) into distinct files.

3 / 5

Total

10

/

20

Passed

Description

28%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 is a bare invocation label rather than a capability description: it names the payments domain but lists no actions, no usage triggers, and no natural keywords beyond 'payments'. A user or Claude scanning skill descriptions would have little basis for knowing what this skill actually does or when to invoke it.

Suggestions

Enumerate the concrete capabilities in the description, e.g., 'Processes payments, manages rUv credit balances, configures auto-refill, and handles tier upgrades within Flow Nexus.'

Add an explicit trigger clause such as 'Use when the user asks about credits, billing, payment links, subscriptions, or tier changes in Flow Nexus.'

Include natural trigger keywords and synonyms (credits, billing, subscription, refund, balance) so the skill surfaces for the phrasings users actually say.

DimensionReasoningScore

Specificity

The description 'Agent skill for payments - invoke with $agent-payments' names the domain (payments) but gives no concrete actions whatsoever — no payment processing, credit management, or billing operations are mentioned. This matches the level-2 anchor 'Names the domain but actions are minimal or generic' (e.g., 'Processes PDF files'); it is below level 3, which requires 1-2 concrete actions, and above level 1, which requires no domain naming at all.

2 / 5

Completeness

The 'what' is vague ('Agent skill for payments') and the 'when' is entirely absent — there is no 'Use when...' clause, which caps completeness at 3 per the guidelines. It sits at level 2 ('Has a vague what and no when') rather than 3 because the what lacks any named capability beyond the domain label.

2 / 5

Trigger Term Quality

Only one natural keyword ('payments') appears; the '$agent-payments' token is an invocation syntax, not a phrase a user would say. Common user phrases like billing, credits, subscription, refund, or invoice are entirely missing, matching 'One or two generic keywords; missing the natural phrases users say' rather than level 3, which requires a broader set of relevant keywords with only synonyms missing.

2 / 5

Distinctiveness Conflict Risk

The payments domain plus the explicit '$agent-payments' invocation string give it a recognizable identity, so it is not entirely generic (level 1-2), but 'payments' is broad enough to overlap with any billing, invoicing, or subscription skill. This matches 'Somewhat specific but could still overlap with similar skills' and falls short of level 4, which requires mostly-distinct triggers with only minor overlap risk.

3 / 5

Total

9

/

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
ruvnet/ruflo
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.