Index of every page on this site: llms.txt
All skills
wshobson avatar

/billing-automation

@4220308
by Seth Hobsonwshobson/agents43k stars
4,518
Run it yourself

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.

Use this Skill: https://skilld.dev/gh/wshobson/agents/billing-automation

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈60 tokens for metadata: the name and description. ≈408 when used: this file. ≈3.9k more on demand in 1 file.

Description uses 3.0% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈240 characters, or 3.0%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

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.

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning2mo5 checks · Risk SAFE
  • Gen Agent Trust Hub2mo

    The skill provides guidelines and reference implementations for building automated billing systems, including subscription lifecycle management, dunning processes, and tax calculation. No security concerns or malicious patterns were detected.

  • Socket2mo

    No alerts

  • Snyk2mo

    Risk: MEDIUM · 1 issue

  • Runlayer8mo

    1 file scanned · No issues

  • ZeroLeaks7mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at 4220308. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 days ago.

Activeupdated 6 months ago
  • billing
  • subscriptions
  • invoicing
  • payments
  • dunning
  • saas
  • recurring
  • tax
  • proration

README badge

README badge for wshobson/agents/billing-automation

Builds automated billing systems for recurring payments, invoicing, subscription lifecycle management, and failed payment recovery. Covers SaaS subscription billing, invoice generation, dunning (payment retry), proration for plan changes, and tax calculation across multiple billing cycles.

Generated from the current SKILL.md.

What programming languages does this skill support?
The skill includes Python examples in the quick start, but the SKILL.md does not specify language constraints or examples for other languages.
Does this skill handle tax calculation?
Yes. The skill mentions handling sales tax, VAT, and GST as part of its core concepts, though specific implementation details are in the referenced details.md file.
Can this skill manage usage-based billing?
Yes. Usage-based billing is listed as a use case, and custom billing cycles are mentioned as an option alongside monthly, annual, quarterly, and weekly intervals.
Does this skill support dunning (failed payment recovery)?
Yes. Dunning management is a core concept that includes retry schedules, customer notifications, grace periods, and account restrictions for recovering failed payments.
Can this handle prorated charges for mid-cycle changes?
Yes. The skill includes proration for plan upgrades/downgrades mid-cycle, seat additions/removals, and billing frequency changes.

Generated from the current SKILL.md. These answers refresh after source changes.