voucher

A billing skill for managing Wi-Fi access vouchers for AgentOS community Wi-Fi operators. It handles voucher codes, user redemption, MikroTik RouterOS access setup, QR codes, and recurring renewals.

In plain words
What is it for?
Use it to create vouchers for fixed plans, redeem them for users, list active or used vouchers, view revenue and usage statistics, revoke vouchers, and renew subscriptions when the user's wallet has enough balance.
Why use it?
It centralizes the work of issuing, redeeming, tracking, revoking, and renewing paid Wi-Fi access.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/br3eze-code/br3eze-code/voucher
Any agent
npx skills add br3eze-code/br3eze-code --skill voucher
Clone the repo
git clone --depth 1 https://github.com/br3eze-code/br3eze-code

Made for: Claude Code, Codex.

Per session 0 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 622 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00000 $0.00622
Opus 5 $0.00000 $0.00311
Sonnet 5 $0.00000 $0.00124
Haiku 4.5 $0.00000 $0.00062

Measured 2d ago against content hash d6ebccb0e40f, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

voucher scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (index.js), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/voucher/SKILL.md · 82 lines

How it starts

The opening of the file, as written. The whole thing — 82 lines — stays where its author put it; the contents beside it link to each section on GitHub.

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:

Read the full file on GitHub · 82 lines

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 82 lines · 0 tokens per session scan A d6ebccb0e40f

Subscribe to this mod's changes

voucher is a skill published in the GitHub repository br3eze-code/br3eze-code (2 stars, last pushed 2d ago), licensed Apache-2.0. It costs nothing until one of its globs matches a file; then it loads 622 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

risk-scoring

Score how concentrated and risky a portfolio is on a 0-100 scale from its position weights. Use when the user asks how risky their portfolio is, whether it is too concentrated, or for a diversification check.

microsoft/agent-framework · 47 tokens

valuation

Estimate whether a stock looks cheap or expensive using a price-to-earnings (P/E) based fair-value method. Use when the user asks if a stock is over- or under-valued, or for a fair-value / target price.

microsoft/agent-framework · 51 tokens

travel-expense-audit

Audit travel / 差旅报销 claims against uploaded policy handbooks and rate tables (lodging caps, transport, per diem). Use for 差旅费审核, travel expense review, or lodging over-limit checks.

vixues/LeAgent · 51 tokens

billing

Use for refunds, disputed charges, invoices and any billing question.

footprintjs/agentfootprint · 15 tokens

expense

Read a receipt or invoice — pasted text, or a photo/scan — and turn it into one clean, structured expense record: merchant, date, currency, total, tax id, and itemised amounts, with those amounts checked to actually sum to the stated total. OCR text is dirty (O↔0, l↔1, misplaced decimals); this skill calibrates that…

Caprista/KarvyLoop · 165 tokens

foundry-hosted-agent-validation

Step-by-step process for validating a Python Foundry hosted agent sample (under python/samples/04-hosting/foundry-hosted-agents/) end to end — running it locally (native runtime and azd ai agent run) and after deploying it to an Azure AI Foundry project with azd. Use this when asked to validate a hosted agent sample.

microsoft/agent-framework · 82 tokens