Voucher

Skill br3eze-code/br3eze-code/skills/voucher

Personal Ai Agent

Install

npx -y skills add br3eze-code/br3eze-code --skill voucher

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

2.2 KB, as published. Nobody here has run it

Skill: voucher

Version: 2026.7.0
Dispatcher: manage_vouchers
Domain: billing

Description

Voucher lifecycle management for AgentOS community WiFi operators. Generates STAR-XXXX-XXXX codes, provisions users on MikroTik RouterOS, creates QR codes, and runs the Auto-Renewal (recurring billing) engine that extends sessions when a user's wallet has sufficient balance.

When to Use

Invoke when the user asks about:

Creating a new WiFi voucher for a plan (1hour / 1Day / 7Day / 30Day)
Redeeming a voucher code for a user
Listing vouchers (active, used, recent)
Revenue and usage statistics
Revoking a voucher
Auto-renewing an expiring subscription

Plans

Plan	Duration	Price (USD)
`1hour`	1 hour	$0.50
`1Day`	24 hours	$2.00
`7Day`	7 days	$3.00
`30Day`	30 days	$6.00

Code format: STAR-[A-F0-9]{6} — generated via crypto.randomBytes(3)

Tools

Action	Description
`voucher.create`	Generate code, save to DB, provision on MikroTik, return QR URL
`voucher.redeem`	Mark voucher as used for a specific user
`voucher.list`	List vouchers (optional `used` filter, `limit`)
`voucher.stats`	Count, revenue, and breakdown by plan
`voucher.revoke`	Mark used + remove MikroTik hotspot user
`voucher.renew`	Auto-renew: deduct wallet, extend MikroTik session

Lifecycle

createVoucher() → saved to DB → provisioned on MikroTik → QR URL returned →
customer redeems → session expires →
Auto-Renewal Engine (checks wallet balance) → renews or kicks →
expireOldVouchers() marks used

Example: Create Voucher

{
  "action": "voucher.create",
  "plan": "1Day",
  "actor": "telegram:123456789"
}

Example: Redeem

{
  "action": "voucher.redeem",
  "code": "STAR-4A2F8C",
  "user": "alice"
}

Recurring Billing (Auto-Renewal)

The guardHotspot reaper in AgentOSOrchestrator runs every 1 hour.
If a user has hasPlan status and wallet balance ≥ plan price:

Wallet is debited
MikroTik session is extended — no service interruption

If wallet is insufficient, the session expires and the user is notified.