Name: billing-automation
Author: wshobson

Imported from wshobson/agents (plugins/payment-processing/skills/billing-automation/SKILL.md) via skills.sh. Install upstream with npx skills add wshobson/agents --skill billing-automation. Copyright stays with the author.

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.

Install billing-automation and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "wshobson-agents-billing-automation", "kind": "skill", "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.", "publisher": "wshobson", "version": "1.0.0", "capabilities": { "domains": [ "customer_support" ], "tags": [ "skill-md", "skills-sh" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "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." ], "primary": false, "metadata": { "source": { "provider": "skills.sh", "repository": "https://github.com/wshobson/agents", "path": "plugins/payment-processing/skills/billing-automation/SKILL.md", "ref": "HEAD", "url": "https://www.skills.sh/wshobson/agents/billing-automation", "key": "wshobson/agents/plugins/payment-processing/skills/billing-automation/SKILL.md" } }, "instructions": "# Billing Automation\n\nMaster automated billing systems including recurring billing, invoice generation, dunning management, proration, and tax calculation.\n\n## When to Use This Skill\n\n- Implementing SaaS subscription billing\n- Automating invoice generation and delivery\n- Managing failed payment recovery (dunning)\n- Calculating prorated charges for plan changes\n- Handling sales tax, VAT, and GST\n- Processing usage-based billing\n- Managing billing cycles and renewals\n\n## Core Concepts\n\n### 1. Billing Cycles\n\n**Common Intervals:**\n\n- Monthly (most common for SaaS)\n- Annual (discounted long-term)\n", "cost": { "context_tokens": 405 } }

billing-automation

About