Master automated billing systems including recurring billing, invoice generation, dunning management, proration, and tax calculation.
42
28%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/billing-automation/SKILL.mdQuality
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
9d0b37c
Table of Contents
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.