Subscription Billing Automator

Billing automation

by wshobson · MIT license · ★ 39,857 on GitHub · updated Sep 21

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.

---
name: billing-automation
description: 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.
---

# Billing Automation

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

## When to Use This Skill

- Implementing SaaS subscription billing
- Automating invoice generation and delivery
- Managing failed payment recovery (dunning)
- Calculating prorated charges for plan changes
- Handling sales tax, VAT, and GST
- Processing usage-based billing
- Managing billing cycles and renewals

Overview

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

Manual install (npx, ZIP)

Claude Codenpx skills add wshobson/agents --skill billing-automation -g -a claude-code

Claude Code (manual)

mkdir -p ~/.claude/skills && curl -sL https://codeload.github.com/wshobson/agents/tar.gz/4236bb91f839 \
  | tar -xz -C ~/.claude/skills --strip-components=4 agents-4236bb91f839/plugins/payment-processing/skills/billing-automation

Windows (PowerShell)

New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null; Invoke-WebRequest "https://m.agentalley.io/zip/25ece8a23b59f357f6bc/billing-automation.zip" -OutFile "$env:TEMP\billing-automation.zip"; Expand-Archive "$env:TEMP\billing-automation.zip" -DestinationPath "$HOME\.claude\skills" -Force

Claude.ai / desktopDownload the ZIP and upload it under Settings → Capabilities → Skills.

Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

SKILL.md1.9 KB
references/1 file · 15.1 KB

Read the files here

wshobson/4236bb92 files

SKILL.md1.9 KB

SKILL.md

Show the full text80 lines

billing-automation/SKILL.md80 lines · 1.9 KB

PreviewCode

Outline

RawView on GitHub

Billing Automation

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

When to Use This Skill

Implementing SaaS subscription billing
Automating invoice generation and delivery
Managing failed payment recovery (dunning)
Calculating prorated charges for plan changes
Handling sales tax, VAT, and GST
Processing usage-based billing
Managing billing cycles and renewals

Core Concepts

1. Billing Cycles

Common Intervals:

Monthly (most common for SaaS)
Annual (discounted long-term)
Quarterly
Weekly
Custom (usage-based, per-seat)

2. Subscription States

trial → active → past_due → canceled
              → paused → resumed

3. Dunning Management

Automated process to recover failed payments through:

Retry schedules
Customer notifications
Grace periods
Account restrictions

4. Proration

Adjusting charges when:

Upgrading/downgrading mid-cycle
Adding/removing seats
Changing billing frequency

Quick Start

from billing import BillingEngine, Subscription

# Initialize billing engine
billing = BillingEngine()

# Create subscription
subscription = billing.create_subscription(
    customer_id="cus_123",
    plan_id="plan_pro_monthly",
    billing_cycle_anchor=datetime.now(),
    trial_days=14
)

# Process billing cycle
billing.process_billing_cycle(subscription.id)

Detailed patterns and worked examples

Detailed pattern documentation lives in references/details.md. Read that file when the navigation tier above is insufficient.

1	---
2	name: billing-automation
3	description: 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.
4	---
5
6	# Billing Automation
7
8	Master automated billing systems including recurring billing, invoice generation, dunning management, proration, and tax calculation.
9
10	## When to Use This Skill
11
12	- Implementing SaaS subscription billing
13	- Automating invoice generation and delivery
14	- Managing failed payment recovery (dunning)
15	- Calculating prorated charges for plan changes
16	- Handling sales tax, VAT, and GST
17	- Processing usage-based billing
18	- Managing billing cycles and renewals
19
20	## Core Concepts
21
22	### 1. Billing Cycles
23
24	Common Intervals:
25
26	- Monthly (most common for SaaS)
27	- Annual (discounted long-term)
28	- Quarterly
29	- Weekly
30	- Custom (usage-based, per-seat)
31
32	### 2. Subscription States
33
34	```
35	trial → active → past_due → canceled
36	→ paused → resumed
37	```
38
39	### 3. Dunning Management
40
41	Automated process to recover failed payments through:
42
43	- Retry schedules
44	- Customer notifications
45	- Grace periods
46	- Account restrictions
47
48	### 4. Proration
49
50	Adjusting charges when:
51
52	- Upgrading/downgrading mid-cycle
53	- Adding/removing seats
54	- Changing billing frequency
55
56	## Quick Start
57
58	```python
59	from billing import BillingEngine, Subscription
60
61	# Initialize billing engine
62	billing = BillingEngine()
63
64	# Create subscription
65	subscription = billing.create_subscription(
66	customer_id="cus_123",
67	plan_id="plan_pro_monthly",
68	billing_cycle_anchor=datetime.now(),
69	trial_days=14
70	)
71
72	# Process billing cycle
73	billing.process_billing_cycle(subscription.id)
74	```
75
76	## Detailed patterns and worked examples
77
78	Detailed pattern documentation lives in `references/details.md`. Read that file when the navigation tier above is insufficient.
79
80