Skip to content

adrianwedd/lemonsqueezy-claude-skills

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Lemon Squeezy Skills for Claude Code

6 production-ready Claude Code skills for automating Lemon Squeezy payment platform operations

Automate customer support, sales analytics, and marketing attribution for your Lemon Squeezy store using Claude Code skills. Save 15-20 hours/week during launch and 5+ hours/week ongoing.

License: MIT Claude Code Lemon Squeezy


🚀 Quick Start

  1. Install skills:

    # Copy skills to your Claude Code project
    cp -r skills/ .claude/skills/
  2. Configure credentials:

    # Create .dev.vars file with your Lemon Squeezy API credentials
    cp examples/.dev.vars.example .dev.vars
    # Edit .dev.vars with your API key and store ID
  3. Use skills:

    Ask Claude: "Show me sales dashboard"
    Claude uses /sales-dashboard skill automatically
    

📖 Full setup guide: GETTING-STARTED.md


📦 What's Included

Customer Support Skills (3)

Skill Purpose Time Saved
/customer-lookup Find customer purchase history instantly 2 min → 10 sec
/resend-receipt Resend download links (solves #1 support request) 2 min → 15 sec
/refund-order Process full/partial refunds with auto-notifications 3 min → 30 sec

Business Analytics Skills (2)

Skill Purpose Time Saved
/sales-dashboard Revenue metrics, order counts, top products 20 min → 30 sec
/discount-analytics Marketing attribution and promo code ROI 60 min → 2 min

Marketing Skills (1)

Skill Purpose Time Saved
/create-discount-code Generate promotional codes with usage limits 3 min → 20 sec

💡 Use Cases

Daily Operations

Morning check:
  "How are sales today?" → /sales-dashboard

Customer support:
  "Customer lost download link for order #12345" → /resend-receipt
  "Issue refund to customer@example.com" → /refund-order

Account lookup:
  "Can you check if customer@example.com has purchased?" → /customer-lookup

Launch Day

Pre-launch:
  "Create LAUNCH50 for 50% off, limit 100 uses, 7 days" → /create-discount-code

During launch:
  "Show me sales dashboard" → /sales-dashboard
  "Which promo codes are working?" → /discount-analytics

Post-launch:
  "Compare PODCAST30 vs EMAIL30 performance" → /discount-analytics

Weekly Review

Revenue analysis:
  "What's our revenue this week?" → /sales-dashboard

Marketing attribution:
  "Which discount codes drove the most sales?" → /discount-analytics
  "Show me ROI by marketing channel" → /discount-analytics

⚡ Performance Impact

Time Saved:

  • Launch week: 15-20 hours
  • Ongoing: 5 hours/week (~260 hours/year)

Speed Improvements:

  • Customer lookup: 12x faster (2 min → 10 sec)
  • Refund processing: 6x faster (3 min → 30 sec)
  • Sales reporting: 40x faster (20 min → 30 sec)
  • Marketing analytics: 30x faster (60 min → 2 min)

Business Impact:

  • ✅ Instant customer support (< 5 minute response time)
  • ✅ Real-time sales tracking
  • ✅ Marketing attribution (know which channels work)
  • ✅ Automated promo code generation
  • ✅ Revenue analytics on demand

📚 Documentation


🛠️ Requirements

  • Claude Code (CLI or IDE integration)
  • Lemon Squeezy account with API access
  • API Key with these permissions:
    • ✅ Read stores, products, orders, customers, subscriptions, discounts
    • ✅ Write discounts, refunds

Platform support:

  • ✅ macOS, Linux, Windows
  • ✅ Local development (.dev.vars)
  • ✅ Production (Cloudflare Pages, Vercel, etc.)

🔧 Installation

Option 1: Copy Skills Directly

# Clone this repo
git clone https://github.com/adrianwedd/lemonsqueezy-claude-skills.git

# Copy skills to your project
cp -r lemonsqueezy-claude-skills/skills/ your-project/.claude/skills/

# Configure credentials
cp lemonsqueezy-claude-skills/examples/.dev.vars.example your-project/.dev.vars
# Edit .dev.vars with your API credentials

Option 2: Git Submodule (Recommended)

# Add as submodule
cd your-project
git submodule add https://github.com/adrianwedd/lemonsqueezy-claude-skills.git .claude/skills/lemonsqueezy

# Configure credentials
cp .claude/skills/lemonsqueezy/examples/.dev.vars.example .dev.vars
# Edit .dev.vars with your API credentials

Option 3: Download ZIP

  1. Download latest release
  2. Extract to your-project/.claude/skills/
  3. Configure .dev.vars with your API credentials

🎯 Skill Details

/customer-lookup

Find customer purchase history and support details

Input: Email address or order number
Output: Customer name, location, total spent, all orders, subscriptions

Example:
  "Lookup customer@example.com"

Returns:
  - 6 orders, $29.97 total spent
  - Customer since Dec 31, 2025
  - Location: Sydney, Australia

Full documentation →


/sales-dashboard

Revenue metrics and business analytics

Input: Optional date range (defaults to all-time)
Output: Revenue summary, order counts, recent orders, top products, geographic breakdown

Example:
  "Show me sales dashboard"

Returns:
  - Total revenue: $892.00
  - 112 orders (6 today, 45 this week)
  - Top product: Main Book ($720)
  - Top countries: Australia (58%), US (22%)

Full documentation →


/create-discount-code

Generate promotional codes with usage limits

Input: Code name, discount %, max uses, expiry date
Output: Active discount code ready to share

Example:
  "Create LAUNCH50 for 50% off, limit 100 uses, expires in 7 days"

Returns:
  - Code: LAUNCH50
  - Discount: 50% off
  - Max uses: 100
  - Expires: Jan 12, 2026
  - Status: Published ✅

Full documentation →


/refund-order

Process full or partial refunds instantly

Input: Order number or email, refund amount (optional)
Output: Refund confirmation, customer notification

Example:
  "Refund order #12345"

Returns:
  - Refund amount: $15.00 (100%)
  - Status: Processed ✅
  - Customer notified: Yes
  - Refund timeline: 5-10 business days

Full documentation →


/resend-receipt

Resend download links (solves #1 support request)

Input: Order number or email
Output: Receipt re-sent confirmation

Example:
  "Customer lost download link for order #12345"

Returns:
  - Receipt sent to: customer@example.com
  - Status: Delivered ✅
  - Contents: Download links, PDF receipt

Full documentation →


/discount-analytics

Marketing attribution and promo code ROI

Input: Optional specific code or date range
Output: All codes ranked by redemptions, revenue, ROI

Example:
  "Show discount code performance"

Returns:
  - 5 active codes, 112 total redemptions
  - Top performer: LAUNCH50 (45 uses, $337.50)
  - Best ROI: PODCAST30 (best revenue per redemption)
  - Marketing attribution by channel

Full documentation →


🔐 Security

API Key Protection:

  • ✅ Store in .dev.vars (gitignored)
  • ✅ Use environment secrets for production (Cloudflare, Vercel, etc.)
  • ✅ Never commit to git
  • ✅ Rotate keys every 90 days
  • ❌ Don't share keys via email/Slack

Customer Data Privacy:

  • ✅ Verify customer identity before refunding
  • ✅ Mask emails in logs (cus****@example.com)
  • ❌ Don't reveal payment details
  • ❌ Don't refund to different payment methods

See Security Best Practices for full details.


🤝 Contributing

Contributions welcome! Please read CONTRIBUTING.md first.

Ideas for new skills:

  • /order-lookup - Fast order search by number
  • /webhook-test - Verify webhook integration
  • /customer-export - Build email list (CSV)
  • /license-key-tool - Manage premium content access
  • /subscription-manager - Handle recurring billing

📄 License

MIT License - see LICENSE for details.

TL;DR: Free to use, modify, and distribute. Attribution appreciated but not required.


🙏 Acknowledgments


💬 Support


🌟 Star History

If these skills save you time, consider starring the repo! ⭐


Made with ❤️ by the Claude Code community

About

6 production-ready Claude Code skills for automating Lemon Squeezy operations. Customer support, sales analytics, discount codes, and refunds. Saves 5+ hours/week.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors