copywriting
Marketing copy for homepages, landing pages, pricing pages, and other conversion-focused web pages.
woo-coupon-hygiene-cleanup
Find expired, zero-use, or past-expiry coupons and batch-delete after confirmation.
Full skill instructions
Audit WooCommerce coupons for expired, never-used, or usage-exhausted codes and delete them in batch after confirmation. Reduces coupon table bloat and prevents confusion from stale codes. Includes dry-run preview listing every coupon to be deleted.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
store_url | string | yes | — | Base URL of the WooCommerce store |
consumer_key | string | yes | — | WooCommerce REST API consumer key (ck_...) |
consumer_secret | string | yes | — | WooCommerce REST API consumer secret (cs_...) |
dry_run | bool | no | true | Preview without deleting |
format | string | no | human | Output format: human or json |
delete_expired | bool | no | true | Delete coupons past their date_expires |
delete_zero_use | bool | no | false | Delete coupons that have never been used (use with caution) |
delete_usage_exhausted | bool | no | true | Delete coupons where usage_count >= usage_limit |
expired_before | string | no | <today> | Only delete coupons that expired before this date |
force_delete | bool | no | true | Permanently delete (bypass trash) |
WooCommerce uses OAuth 1.0a for HTTP and Basic Auth over HTTPS.
For HTTPS stores (recommended):
Authorization: Basic base64(consumer_key:consumer_secret)
For HTTP stores (development only): Use OAuth 1.0a — include oauth_consumer_key, oauth_nonce, oauth_signature, oauth_signature_method=HMAC-SHA1, oauth_timestamp, oauth_version=1.0
Never log or output consumer_key or consumer_secret values.
See docs/AUTHENTICATION.md for full setup instructions.
Step 3 permanently deletes coupons. Deleted coupons cannot be recovered. Always run with dry_run: true first (the default) and review the list carefully. Do not use delete_zero_use: true without verifying those coupons are not in active email campaigns.
Step 1 — Fetch all coupons
GET /wp-json/wc/v3/coupons?per_page=100&page=1
Extract: id, code, discount_type, amount, date_expires, usage_count, usage_limit, date_created
Step 2 — Classify coupons for deletion
date_expires != null and date_expires < now (and < expired_before)usage_count == 0 (if delete_zero_use: true)usage_limit > 0 and usage_count >= usage_limitStep 3 — Preview or delete
If dry_run: true: list coupons to be deleted. Stop.
If dry_run: false and confirmed:
DELETE /wp-json/wc/v3/coupons/{id}?force=<force_delete>
GET /wp-json/wc/v3/coupons — list all coupons
DELETE /wp-json/wc/v3/coupons/{id} — delete individual coupon
WooCommerce REST API uses page/per_page pagination (not cursor-based).
Standard pattern:
page = 1
while True:
response = GET /endpoint?per_page=100&page=page
process(response)
if len(response) < 100: break
page += 1
Maximum per_page is 100 for most endpoints. The X-WP-Total and X-WP-TotalPages response headers report totals. Always read X-WP-TotalPages on the first request to estimate job size.
Claude MUST emit the following output at each stage. This is mandatory.
STARTUP:
╔══════════════════════════════════════════╗
║ SKILL: woo-coupon-hygiene-cleanup ║
║ STORE: <store_url> ║
║ TIME: <ISO-8601 UTC> ║
║ MODE: <DRY RUN | LIVE> ║
╚══════════════════════════════════════════╝
PER-OPERATION (emit after each API call batch):
[N/TOTAL] <METHOD> <endpoint> → <result_count> records | params: <key>=<val>
COMPLETION (human format):
╔══════════════════════════════════════════╗
║ COMPLETE: woo-coupon-hygiene-cleanup ║
║ RECORDS PROCESSED: <n> ║
║ OUTPUT: stdout ║
╚══════════════════════════════════════════╝
COMPLETION (json format):
{
"skill": "woo-coupon-hygiene-cleanup",
"store": "<store_url>",
"completed_at": "<ISO-8601>",
"records_processed": <n>,
"output_file": null,
"dry_run": <bool>
}
Human format: table of coupon codes, expiry date, usage count, and deletion reason.
| Error | Cause | Resolution |
|---|---|---|
401 Unauthorized | Invalid credentials | Verify consumer_key and consumer_secret |
403 Forbidden | Key lacks Read/Write scope | Regenerate with Read/Write scope |
429 Too Many Requests | Rate limit during delete | Wait 2 seconds and retry |
dry_run: true first (the default). Deletion is permanent.delete_zero_use: true without cross-referencing active email campaigns using those codes.Marketing copy for homepages, landing pages, pricing pages, and other conversion-focused web pages.
Fast image generation with Flux 2 Klein, optimized for sub-second iteration and multi-reference brand styling.
Psychological principles and mental models for understanding customer behavior and influencing marketing decisions.
Plan searchable and shareable content that drives traffic, builds authority, and generates leads.
Build SEO-optimized pages at scale using templates, data, and proven playbook patterns.
Brainstorm and prioritize marketing strategies tailored to your SaaS stage, budget, and goals.
Optimize content for discovery, citation, and visibility across AI search platforms and LLM assistants.
Systematic improvement of existing marketing copy through seven focused editing passes.
Plan and optimize your website's page hierarchy, navigation, URL structure, and internal linking.
Design and optimize systems connecting marketing, sales, and customer success into a unified revenue engine.
Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.
Convert websites into professional HyperFrames videos with guided storyboarding and brand-aligned composition.
Revolutionize Video Creation with AI-Generated Avatars and Voices
Social media on autopilot
Design custom logos instantly with AI.
Text-heavy marketing and design images
Boost Your SEO with Content and SEO Silos
Revolutionize Your Marketing with AI-Powered MarketingBlocks!
10X faster & free AI content creation for 100+ use cases
Tribescaler | Make Your Tweets Go Viral