Skip to main content
AI coding assistants like Claude Code, Cursor, and Windsurf are transforming how developers build software. To help you integrate Creem faster and with best practices built-in, we’ve created an official Creem API Skill that gives AI assistants deep knowledge about our payment infrastructure.

Quick Install for Claude Code

Install the Creem skill with a single command:
/plugin marketplace add armitage-labs/creem-skills
Then install the skill using either method: Option A: Use the interactive UI (easiest)
  1. Type /plugin and press Enter
  2. Go to the Discover tab
  3. Search for creem-api
  4. Press Enter to install
Option B: Use the command directly
/plugin install creem-api@creem-skills
That’s it! Claude Code now has complete knowledge of the Creem API and will generate production-ready integration code when you ask about payments, subscriptions, webhooks, or licenses.

What is a Skill?

A skill is a structured set of instructions and reference materials that AI assistants use to provide more accurate, contextual help for specific tasks. When you load the Creem skill, your AI assistant gains comprehensive knowledge about:
  • All 24 API endpoints with request/response schemas
  • Webhook events and signature verification
  • Common integration patterns and workflows
  • Best practices for security and error handling
  • Test mode configuration

Get the Skill

Claude Code (Recommended)

/plugin marketplace add armitage-labs/creem-skills
/plugin install creem-api@creem-skills

GitHub Repository

Clone, fork, or download the skill files directly

Download ZIP

Download as a ZIP file for manual setup

Skill Contents

The skill includes four comprehensive reference files:
FileDescription
Skill.mdCore skill with quick reference and implementation patterns
REFERENCE.mdComplete API reference with all endpoints and schemas
WEBHOOKS.mdWebhook events documentation with payload examples
WORKFLOWS.mdStep-by-step integration guides for common use cases

What’s Covered

  • Checkouts: Create and retrieve checkout sessions
  • Products: Create, retrieve, and list products
  • Customers: Manage customers and portal links
  • Subscriptions: Full lifecycle management (get, update, upgrade, cancel, pause, resume)
  • Licenses: Activation, validation, and deactivation
  • Discounts: Create, retrieve, and delete promotional codes
  • Transactions: Query payment history
  • checkout.completed - Payment successful
  • subscription.active - New subscription created
  • subscription.paid - Recurring payment processed
  • subscription.canceled - Subscription ended
  • subscription.expired - Period ended without payment
  • subscription.trialing - Trial started
  • subscription.paused - Subscription paused
  • subscription.update - Subscription modified
  • refund.created - Refund processed
  • dispute.created - Chargeback opened
  • Basic SaaS subscription flows
  • One-time purchases with digital delivery
  • License key systems for desktop/mobile apps
  • Seat-based team billing
  • Freemium with upgrade flows
  • Affiliate and referral tracking
  • Webhook signature verification (HMAC-SHA256)
  • Error handling patterns
  • Test mode development
  • Security considerations
  • Idempotency and retry handling

Setup by AI Tool

Claude Code

Recommended Method: Use the plugin marketplace for the easiest setup experience.
One-Line Install (Plugin Marketplace) Claude Code’s plugin marketplace makes installation effortless:
1

Add the Marketplace

Open Claude Code and run:
/plugin marketplace add armitage-labs/creem-skills
2

Install the Skill

Option A: Interactive UI (easiest)Type /plugin, go to the Discover tab, search for creem-api, and press Enter to install.Option B: Command
/plugin install creem-api@creem-skills
3

Start Building

Ask Claude to help with Creem integration:
Help me create a checkout flow for my SaaS product
Managing the Plugin
# View installed plugins
/plugin

# Disable the skill temporarily
/plugin disable creem-api@creem-skills

# Enable again
/plugin enable creem-api@creem-skills

# Uninstall
/plugin uninstall creem-api@creem-skills

# Update marketplace to get latest version
/plugin marketplace update creem-skills
Alternative: Direct Reference If you prefer not to use the marketplace, you can reference the skill directly in any conversation:
Help me integrate Creem payments. Use the skill at https://github.com/armitage-labs/creem-skills

Cursor

Cursor supports adding context through multiple methods: Option 1: Add to Project
  1. Clone the skill repository into your project:
    git clone https://github.com/armitage-labs/creem-skills.git .cursor/skills
    
  2. Reference the skill files in your conversations using @ mentions:
    @.cursor/skills/creem-api/Skill.md Help me create a checkout flow
    
Option 2: Custom Instructions Add the skill content to your project’s .cursorrules file:
When working with Creem payment integration:
- Use the Creem API at https://api.creem.io (or test-api.creem.io for test mode)
- Authenticate with x-api-key header
- Always verify webhook signatures using HMAC-SHA256
- Prices are in cents (1000 = $10.00)
- Reference: .cursor/skills/creem-api/
Option 3: Docs Integration Add the Creem documentation to Cursor’s docs:
  1. Open Cursor Settings → Features → Docs
  2. Add: https://docs.creem.io
  3. Cursor will index our documentation for context

Windsurf

Windsurf supports custom knowledge through its Cascade feature:
  1. Clone the skill repository:
    git clone https://github.com/armitage-labs/creem-skills.git .windsurf/creem
    
  2. Add to your project’s knowledge base in Windsurf settings
  3. Reference in conversations:
    Using the Creem skill, help me implement subscription billing
    

Other AI Tools

For other AI coding assistants (GitHub Copilot Chat, Cody, Continue, etc.):
  1. Download the skill files from the GitHub repository
  2. Add to your project in a dedicated folder (e.g., .ai/creem/)
  3. Reference in context when asking questions about Creem integration
  4. Copy relevant sections into your conversation when needed
Most AI tools support adding files to conversation context - simply include the relevant skill file when working on payment integration.

Example Usage

Once the skill is loaded, you can ask natural language questions and get production-ready code:

Creating a Checkout

Create a checkout API route for my Next.js app that handles subscription purchases
with metadata tracking

Handling Webhooks

Create a webhook handler that verifies signatures and handles subscription events

License Key Integration

Implement license key activation and validation for my Electron desktop app

Why Use the Skill?

Faster Development

Skip reading documentation - describe what you want and get working code instantly

Best Practices Built-in

Generated code includes security patterns, error handling, and production considerations

Always Up-to-Date

We maintain the skill alongside our API - you always get current patterns

Comparison

Without SkillWith Skill
Read API docs, find endpointsDescribe your goal in plain English
Copy-paste examples, adapt manuallyGet tailored, working code
Miss edge cases and best practicesSecurity and error handling included
Search for webhook payload formatsFull payload examples in context
Trial and error with parametersCorrect parameters from the start

Skill vs SDK

The Creem skill is designed for direct API integration and complements our SDKs:
Use the Skill WhenUse an SDK When
Building custom integrationsUsing Next.js, TypeScript, or Better Auth
Learning the APIWant type-safety and abstractions
Working with any languagePrefer pre-built components
Need full control over requestsWant faster development with helpers
The skill focuses on the REST API. For SDK-specific help, see our TypeScript SDK, Next.js SDK, or Better Auth documentation.

Contributing

Found an issue or want to improve the skill? We welcome contributions:

Next Steps