Master automated billing systems including recurring billing, invoice generation, dunning management, proration, and tax calculation.
59
Quality
50%
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 effectively lists specific billing capabilities but fails to provide explicit trigger guidance for when Claude should select this skill. The use of 'Master' as the opening verb is unusual and slightly vague compared to action-oriented verbs. The lack of a 'Use when...' clause significantly limits Claude's ability to correctly choose this skill from a large skill library.
Suggestions
Add a 'Use when...' clause with explicit triggers like 'Use when the user asks about subscription billing, recurring charges, invoice automation, failed payment handling, or billing proration calculations.'
Include common user-facing terms like 'subscriptions', 'payment failures', 'billing cycles', 'automatic charges' to improve trigger term coverage.
Replace 'Master' with an action verb like 'Manages' or 'Handles' for clearer capability description.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'recurring billing, invoice generation, dunning management, proration, and tax calculation' - these are distinct, actionable 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. | 1 / 3 |
Trigger Term Quality | Contains relevant domain keywords like 'billing', 'invoice', 'dunning', 'proration', 'tax calculation', but missing common user variations like 'subscriptions', 'payment', 'charges', 'billing cycle', or 'automated payments'. | 2 / 3 |
Distinctiveness Conflict Risk | The billing domain is fairly specific, but 'automated billing systems' could overlap with payment processing, accounting, or subscription management skills without clearer boundaries. | 2 / 3 |
Total | 8 / 12 Passed |
Implementation
57%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill is well-structured and concise with good progressive disclosure to detailed resources. However, it critically lacks actionability - the instructions are abstract directives without concrete code examples, specific commands, or executable guidance that would enable Claude to actually implement billing automation.
Suggestions
Add concrete code examples for key operations like creating a subscription, generating an invoice, or handling a failed payment retry
Include specific data models or schemas for plans, subscriptions, and invoices rather than just mentioning 'define plans'
Add explicit validation checkpoints with specific commands or checks (e.g., 'Run test charge with $0.50 amount, verify webhook received, check ledger balance')
Provide at least one complete workflow example showing the full cycle from subscription creation through invoice generation to payment processing
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is lean and efficient, avoiding explanations of concepts Claude already knows (like what billing or subscriptions are). Every section serves a clear purpose without padding. | 3 / 3 |
Actionability | The instructions are vague and abstract ('Define plans, pricing...', 'Implement invoicing...') with no concrete code, commands, or specific examples. It describes what to do rather than showing how to do it. | 1 / 3 |
Workflow Clarity | Steps are listed in a logical sequence but lack explicit validation checkpoints. For billing systems involving financial transactions, there should be clearer feedback loops for testing and verification beyond 'Validate with sandbox payments.' | 2 / 3 |
Progressive Disclosure | Clear overview structure with well-signaled one-level-deep reference to the implementation playbook. Content is appropriately split between the overview and detailed resources. | 3 / 3 |
Total | 9 / 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 | |
9c177eb
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.