CtrlK
BlogDocsLog inGet started
Tessl Logo

billing-agent

Billing specialist for invoices, payments, refunds, and plan changes. Use when customers ask about charges, billing inquiries, or subscription management; typically reached via handoff from the support agent.

56

Quality

66%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Medium

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./modules/skills/src/main/resources/META-INF/skills/billing-agent/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

45%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 token-efficient and cleanly sectioned, but it functions as a persona statement plus label lists rather than operational guidance. None of the four advertised skills has a procedure, irreversible operations like refunds have no confirmation or validation checkpoint, and payment processing and plan changes lack any tool or steps.

Suggestions

Add a short step-by-step procedure for each skill — e.g., refund handling: look up the invoice with get_invoice → check refund eligibility → confirm the amount with the customer → issue process_refund → report the result.

Add validation checkpoints before irreversible actions: confirm with the customer (and against the invoice) before calling process_refund, and verify the requested plan before applying a change.

Provide concrete guidance for 'Payment processing' and 'Plan changes and upgrades', which currently have no tools and no instructions — either name the tools to use or describe the concrete steps to take.

DimensionReasoningScore

Conciseness

The body is lean with zero padding and no explanation of concepts Claude already knows; the only flaw is redundancy — the opening line 'You help customers with invoices, payments, refunds, and plan changes' restates the '## Skills' bullet list verbatim. That minor trimmable redundancy places it at anchor 4 ('efficient; minor instances that could be trimmed') rather than 5's 'every token earns its place'.

4 / 5

Actionability

Concrete guidance is limited to two tool names with one-line descriptions ('get_invoice: Retrieve customer invoices', 'process_refund: Issue refunds'); the four skill entries ('Payment processing', 'Refund handling', 'Plan changes and upgrades') are bare labels with no steps, criteria, or examples — and two of them have no corresponding tool. This matches anchor 2 ('minimal concrete guidance; high-level hints but missing the specific steps'), not 3, because no skill area has a complete or near-complete procedure.

2 / 5

Workflow Clarity

There is no sequence at all: no steps for handling a refund, payment, or plan change, and no validation before irreversible financial actions like process_refund, matching anchor 1 ('steps missing or incoherent; no sequence; no validation for risky operations'). It is not 2 because even a rough sequence is absent, and the simple-skill exception does not apply since the skill declares four distinct multi-step task areas.

1 / 5

Progressive Disclosure

The body is under 50 lines with no external references needed (no references/, scripts/, or assets/ files exist in the bundle), and it is organized into clear '## Skills' and '## Tools' sections. Per the rubric's guideline for short, self-contained skills, well-organized sections alone warrant a 5.

5 / 5

Total

12

/

20

Passed

Description

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

A strong description: third-person voice, explicit 'Use when' trigger clause with natural customer phrasing, concrete capability areas, and clear routing context that distinguishes it from adjacent support skills. The only minor gap is the absence of a few common trigger variations (e.g., 'overcharged', 'cancel my plan').

DimensionReasoningScore

Specificity

The description names the domain and lists several concrete capability areas — 'invoices, payments, refunds, and plan changes' — comparable to the anchor 'lists several specific actions; minor gaps'. It falls short of a 5 because the capabilities are stated as noun phrases rather than concrete operations (e.g., 'issue refunds against a verified invoice'), and it is above 3 because it covers four distinct capability areas rather than only 1-2.

4 / 5

Completeness

It explicitly answers both what ('Billing specialist for invoices, payments, refunds, and plan changes') and when ('Use when customers ask about charges, billing inquiries, or subscription management') with concrete trigger phrases, matching the anchor-5 example structure. It is not a 4 because the 'when' clause is already explicit and specific, not merely present with room to improve.

5 / 5

Trigger Term Quality

Trigger phrases 'charges, billing inquiries, or subscription management' are natural terms a customer would actually say, alongside 'invoices, payments, refunds'. It does not reach 5 because common variations are missing (e.g., 'overcharged', 'duplicate charge', 'cancel my plan', 'receipt'), but it clearly exceeds 3's 'missing common variations or synonyms' since charges/billing/subscription synonyms are present.

4 / 5

Distinctiveness Conflict Risk

Billing is a clear niche with distinct triggers, and 'typically reached via handoff from the support agent' explicitly delineates routing from adjacent skills, giving minimal conflict risk. It does not exhibit the overlap-with-similar-skills weakness of anchor 4.

5 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository
Atmosphere/atmosphere
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.