CtrlK
BlogDocsLog inGet started
Tessl Logo

billing-automation

Master automated billing systems including recurring billing, invoice generation, dunning management, proration, and tax calculation.

42

Quality

28%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/billing-automation/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

42%

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 lists specific billing-related capabilities which is a strength, but it uses the imperative 'Master' framing rather than describing what the skill does in third person, and critically lacks any 'Use when...' guidance. The technical terms are appropriate for the domain but miss common user language variations, and the absence of explicit trigger conditions significantly weakens its utility for skill selection.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user asks about subscription billing, recurring charges, invoice generation, payment retries, or billing-related tax calculations.'

Include more natural user-facing trigger terms like 'subscription', 'payment failed', 'billing cycle', 'charge', 'refund', and 'credit note' to improve matching.

Rewrite in third person declarative voice (e.g., 'Manages automated billing systems including...') instead of the imperative 'Master' framing.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: recurring billing, invoice generation, dunning management, proration, and tax calculation. These are distinct, well-defined capabilities.

3 / 3

Completeness

Describes what the skill does but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per the rubric, a missing 'Use when...' clause caps completeness at 2, and since the 'when' is entirely absent, this scores a 1.

1 / 3

Trigger Term Quality

Includes relevant domain terms like 'billing', 'invoice', 'dunning', 'proration', and 'tax calculation', but misses common user variations like 'subscription billing', 'payment retry', 'failed payments', 'billing cycle', or 'charges'. Some terms like 'dunning' and 'proration' are more technical than what users would naturally say.

2 / 3

Distinctiveness Conflict Risk

The billing domain is fairly specific, but 'automated billing systems' is broad enough to potentially overlap with payment processing, accounting, or subscription management skills. The word 'Master' is vague and doesn't help distinguish it.

2 / 3

Total

8

/

12

Passed

Implementation

14%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill is essentially a high-level outline that defers all substantive content to a referenced resource file that doesn't exist in the bundle. The instructions are abstract and vague, providing no concrete code, schemas, commands, or specific patterns for billing automation. For a complex domain involving financial transactions and tax compliance, the lack of actionable guidance, validation workflows, and supporting resources makes this skill ineffective.

Suggestions

Add concrete, executable code examples for key billing operations (e.g., subscription lifecycle state machine, proration calculation formula, dunning retry logic with specific intervals).

Include explicit multi-step workflows with validation checkpoints, especially for payment processing and tax calculation — e.g., 'Calculate tax → Validate against regional rules → Generate invoice → Verify totals → Process payment → Confirm settlement'.

Either provide the referenced `resources/implementation-playbook.md` bundle file or inline the essential patterns and examples directly in the SKILL.md body.

Replace vague instructions like 'Model taxes and compliance requirements per region' with specific guidance such as tax calculation code snippets, region-specific rule examples, or concrete schema definitions.

DimensionReasoningScore

Conciseness

The skill is relatively brief but includes several sections that are somewhat generic and don't add much value (e.g., 'Do not use this skill when' lists obvious cases, 'Limitations' section restates common sense). The instructions themselves are high-level bullet points that don't waste many tokens but also don't provide much unique information Claude wouldn't already know.

2 / 3

Actionability

The instructions are entirely abstract and vague — 'Define plans, pricing, billing intervals' and 'Implement invoicing, payments, retries' are descriptions of what to do, not concrete guidance on how to do it. There are no code examples, no specific commands, no schemas, no concrete patterns. Everything actionable is deferred to a resource file that doesn't exist in the bundle.

1 / 3

Workflow Clarity

The instructions list high-level activities but lack clear sequencing, validation checkpoints, or feedback loops. For a billing system involving financial transactions, tax compliance, and payment processing, the absence of explicit validation steps and error recovery workflows is a significant gap. The mention of 'Validate with sandbox payments' is too vague to constitute a real checkpoint.

1 / 3

Progressive Disclosure

The skill references `resources/implementation-playbook.md` for detailed patterns and examples, but no bundle files are provided, meaning the reference leads nowhere. The SKILL.md itself contains almost no substantive content, making it an empty shell that depends entirely on a non-existent resource file.

1 / 3

Total

5

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
sickn33/antigravity-awesome-skills
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.