CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

billing-automation

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

Quality

74%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills/skills/billing-automation/SKILL.md

The canonical home for this skill is billing-automation in rmyndharis/antigravity-skills

SKILL.md
Quality
Evals
Security

Quality

Content

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

A concise, well-structured instruction-style skill with a clear use/do-not-use boundary, a sensible workflow, and an explicit sandbox-validation checkpoint. Its two real weaknesses are a dangling reference to a nonexistent `resources/implementation-playbook.md` and instructions that stay at the level of named deliverables without executable specifics.

Suggestions

Create the referenced `resources/implementation-playbook.md` (with the promised patterns, checklists, and examples) or remove both references to it — as written, the skill points users to a file that does not exist.

Add concrete, executable detail to the instructions: e.g., a sample plan/proration data model, a dunning retry schedule (e.g., 3 retries over 14 days), specific tax API or rate-table handling, and the exact sandbox-validation commands.

Include an explicit validate → fix → retry loop around sandbox payment validation and ledger reconciliation, since billing changes are batch operations on customer money.

DimensionReasoningScore

Conciseness

The body is lean and directive with zero padding: sections are 'Use this skill when', 'Do not use this skill when', six one-line instructions, a safety section, and a resources pointer. No concepts Claude already knows are explained, and every token earns its place — matching the 5 anchor ('lean and efficient; assumes Claude's competence').

5 / 5

Actionability

The instructions enumerate concrete deliverables ("Define plans, pricing, billing intervals, and proration rules", "Implement invoicing, payments, retries, and dunning workflows", "Validate with sandbox payments and reconcile ledger outputs") but contain no executable specifics — no commands, schemas, library choices, or worked examples. This fits the 3 anchor ('some concrete guidance but incomplete; missing key details') rather than 4, since nothing is directly executable, and rather than 2, because the guidance goes beyond high-level hints to name specific artifacts.

3 / 5

Workflow Clarity

The instructions form a sensible build sequence (define plans → map lifecycle → implement invoicing/dunning → model taxes → validate) and include an explicit validation checkpoint ("Validate with sandbox payments and reconcile ledger outputs") plus a safety guard ("Do not charge real customers in testing environments"). It stops short of the 5 anchor because there is no error-recovery feedback loop (validate → fix → retry) for what is a batch/financial operation, leaving a minor validation gap consistent with the 4 anchor.

4 / 5

Progressive Disclosure

The body twice references `resources/implementation-playbook.md` ("If detailed templates are required, open `resources/implementation-playbook.md`" and the Resources section), but the bundle contains no `resources/` directory at all — the referenced file does not exist, so the disclosure path is broken. While the in-file structure and reference signaling are clean, a dangling reference to a nonexistent file leaves the skill without its promised detailed content, matching the 2 anchor's 'minimal structure / broken disclosure' level rather than 3, where references at least resolve.

2 / 5

Total

14

/

20

Passed

Description

71%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 specific, well-scoped description with strong capability coverage and natural trigger terms, undermined by a missing 'Use when...' clause — the single biggest gap, and the reason it cannot score above the midpoint on completeness. Adding trigger guidance would lift it to the quality of the reference good examples.

Suggestions

Append a trigger clause such as: 'Use when implementing SaaS subscription billing, automating invoices or dunning, calculating proration or sales tax/VAT/GST, or processing usage-based billing.'

Include the natural synonyms already present in the body ('subscription billing', 'failed payment recovery', 'VAT', 'GST') so users searching those terms match the description.

Consider naming the billing context (SaaS/subscription platforms) in the description to further reduce overlap with generic invoicing or tax skills.

DimensionReasoningScore

Specificity

The description lists five concrete capability areas — "recurring billing, invoice generation, dunning management, proration, and tax calculation" — which comprehensively covers the billing-automation domain with specific, non-generic actions. It matches the 'multiple specific concrete actions; comprehensive coverage' anchor exactly, and the level-4 'minor gaps in coverage' anchor does not apply since nothing major in the domain is omitted.

5 / 5

Completeness

The 'what' is clear ("Master automated billing systems including recurring billing, invoice generation, dunning management, proration, and tax calculation"), but there is no 'Use when...' clause or equivalent trigger guidance, so completeness is capped at 3 per the judging guidelines. It is not a 2 because the 'what' is concrete and specific, not vague.

3 / 5

Trigger Term Quality

Natural trigger terms like "recurring billing", "invoice generation", "dunning", "proration", and "tax calculation" are phrases users would actually say, giving good keyword coverage. It falls short of the 5 anchor because common variations users say — "subscription billing", "payments", "VAT/GST", "failed payment recovery" — appear only in the body, not the description.

4 / 5

Distinctiveness Conflict Risk

The niche is mostly distinct — "dunning management" and "proration" are unambiguous billing-automation triggers — but "invoice generation" and "tax calculation" each overlap with plausible standalone invoicing or tax skills. It sits between the 'mostly distinct; minor overlap risk' (4) and 'clear niche with minimal conflict' (5) anchors, closer to 4 due to that overlap.

4 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/billing-automation/SKILL.md

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.