Build automated billing systems for recurring payments, invoicing, subscription lifecycle, and dunning management. Use when implementing subscription billing, automating invoicing, or managing recurring payment systems.
82
78%
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 ./.agent/skills/billing-automation/SKILL.mdQuality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a well-crafted skill description that follows best practices. It uses third person voice, lists specific concrete capabilities, includes natural trigger terms users would say, and explicitly separates the 'what' from the 'when' with a clear 'Use when...' clause. The domain-specific terminology (dunning management, subscription lifecycle) makes it highly distinctive.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'recurring payments, invoicing, subscription lifecycle, and dunning management' - these are distinct, actionable capabilities within the billing domain. | 3 / 3 |
Completeness | Clearly answers both what ('Build automated billing systems for recurring payments, invoicing, subscription lifecycle, and dunning management') and when ('Use when implementing subscription billing, automating invoicing, or managing recurring payment systems') with explicit trigger guidance. | 3 / 3 |
Trigger Term Quality | Includes natural keywords users would say: 'subscription billing', 'invoicing', 'recurring payments', 'subscription lifecycle', 'dunning management' - these cover common terminology users would naturally use when needing this skill. | 3 / 3 |
Distinctiveness Conflict Risk | Clear niche focused on billing/subscription systems with distinct triggers like 'dunning management', 'subscription lifecycle', and 'recurring payments' - unlikely to conflict with general payment or e-commerce skills. | 3 / 3 |
Total | 12 / 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-organized and concise with good progressive disclosure to detailed resources. However, it critically lacks actionable, concrete guidance - the instructions are abstract directives without executable code, specific commands, or copy-paste ready examples. For a billing automation skill involving financial operations, the workflow also needs explicit validation checkpoints.
Suggestions
Add concrete code examples for at least one core operation (e.g., subscription creation, invoice generation, or dunning retry logic) with specific API patterns or data structures
Include explicit validation checkpoints in the workflow, such as 'Verify sandbox transaction succeeded before proceeding' or 'Reconcile ledger totals match expected amounts'
Provide a specific example of proration calculation or tax handling with actual numbers/formulas rather than abstract 'model taxes and compliance requirements'
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is lean and efficient, using bullet points without explaining concepts Claude already knows. No unnecessary padding or verbose explanations of what billing, subscriptions, or invoicing are. | 3 / 3 |
Actionability | The content provides only vague, abstract guidance like 'Define plans, pricing, billing intervals' and 'Implement invoicing, payments, retries' without any concrete code, commands, specific examples, or executable patterns. | 1 / 3 |
Workflow Clarity | Instructions are listed in a logical sequence (define → map → implement → model → validate), but lack explicit validation checkpoints, feedback loops for error recovery, or specific verification steps for these complex financial operations. | 2 / 3 |
Progressive Disclosure | Clear overview structure with well-signaled one-level-deep references to implementation-playbook.md for detailed patterns. Content is appropriately split between 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 | |
332e58b
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.