loyalty-program

Manages points accrual rules, membership tiers, promotion triggers, and redemption analytics for customer loyalty programs.

1|Updated Jun 21, 2026
One-click install
npx skills add https://github.com/tapway/shogun-os --skill loyalty-program-tapway
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: loyalty-program
Source: https://github.com/tapway/shogun-os/tree/main/skills/retail/loyalty-program
Command: npx skills add https://github.com/tapway/shogun-os --skill loyalty-program-tapway

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Running a customer loyalty program requires coordinating points earning rules, tier promotions, birthday campaigns, and redemption reporting across disconnected spreadsheets and manual processes, making it hard to measure program ROI. ## Core Features & Use Cases - Points & Tier Management: Configure accrual rates (e.g., 1 point per $1) and manage Silver/Gold/Platinum tier progression with promote/demote operations. - Automated Triggers: Run birthday, anniversary, and re-engagement promotions with dry-run support before sending. - Redemption & ROI Analytics: Track redemption rates, points liability, active member percentage, and churn against targets like >30% redemption and >5x ROI. - Use Case: A retail manager runs a dry-run birthday trigger for a target date, reviews the 47 matched members, then queues a 2x points offer and later pulls a 30-day redemption report to verify the 34% redemption rate. ## Quick Start Ask the agent to list the current loyalty tiers and run a dry-run birthday promotion trigger for a specific date.

Frequently Asked Questions about loyalty-program

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure points accrual rules for a loyalty program?

Run the points-rules subcommand with --set, --rate, and --threshold flags to define points earned per currency unit and the minimum redemption threshold. The configuration returns a JSON confirmation with the active rule set.

How do I manage customer loyalty tiers like Silver, Gold, and Platinum?

Use the tiers subcommand with --list to view all tiers and member distribution, or --promote with --customer and --tier to move a specific customer to a new tier. Tier eligibility is evaluated quarterly based on year-to-date points.

Can I test a birthday promotion before sending it to customers?

Yes, the trigger subcommand supports a --dry-run flag that reports how many members match the birthday date without sending any messages. Remove the flag to execute the actual promotion.

What metrics should a loyalty program track for ROI?

Track redemption rate (target above 30%), program ROI (above 5x cost), active member percentage (above 60%), and churn rate (below 10%). The redemptions subcommand generates these metrics for daily, weekly, or monthly periods.

What are common pitfalls when running a points-based loyalty program?

Key risks include unaccrued points liability on the balance sheet, customer backlash from tier demotions, unintended promotion stacking, and fraud from abnormal earning patterns. Use grace periods for demotions, explicit stacking rules, and velocity checks on accrual.