qr-code-generator

dkyazzentwatwa's avatarfrom dkyazzentwatwa

Generate QR codes with URLs and UTM tracking. Exports PNG/SVG with captions. Use for single codes, batch generation, or marketing campaigns with tracking parameters.

⭐1stars🔀0forks📁View on GitHub🕐Updated Dec 17, 2025

When & Why to Use This Skill

This Claude skill automates the creation of professional-grade QR codes with built-in UTM tracking and customizable visual elements. It supports high-resolution PNG and SVG exports, batch processing from CSV files, and human-readable captions, streamlining the bridge between physical marketing materials and digital analytics.

Use Cases

  • Marketing Campaign Tracking: Generate QR codes with embedded UTM parameters for flyers, posters, or mailers to accurately track offline-to-online conversions in analytics platforms.
  • Bulk Asset Creation: Use the batch generation feature to create hundreds of unique QR codes from a CSV list for event ticketing, personalized invitations, or inventory management.
  • Print-Ready Design: Export scalable SVG files with high error correction levels for large-scale physical branding, ensuring perfect scannability on any surface from business cards to billboards.
  • Enhanced User Engagement: Add custom labels and human-readable captions to QR codes to provide context and increase scan rates for retail displays or promotional signage.
nameqr-code-generator
descriptionGenerate QR codes with URLs and UTM tracking. Exports PNG/SVG with captions. Use for single codes, batch generation, or marketing campaigns with tracking parameters.

QR Code Generator

What this skill does

Given a URL, this skill generates:

  • a QR code that encodes the URL
  • optional captions (human-readable URL or short label)
  • exports in PNG and/or SVG
  • optional batch runs from a CSV

Guardrails

  • Don’t generate QR codes for suspicious links (phishing, credential prompts, malware). If unsure, ask for confirmation or suggest a safer destination page.
  • Prefer HTTPS URLs.
  • If the QR is for print, prefer SVG (scales cleanly) and high error correction.

Inputs

Required:

  • URL

Optional:

  • label/caption text (e.g., “Scan to book a call”)
  • whether to show the URL under the QR (yes/no)
  • output formats: PNG, SVG
  • UTM params (source, medium, campaign, content, term)
  • size intent: screen / print / sticker

Workflow

  1. Validate the URL (scheme + domain).
  2. Optionally append UTM parameters (using assets/templates/utm_template.json).
  3. Generate QR:
    • Error correction: M (default), H for print/complex usage
    • Border: 4 (default)
  4. Export:
    • PNG (good for web)
    • SVG (best for print)
  5. If caption enabled:
    • PNG: add label and/or URL under the QR
    • SVG: add a text element under the QR
  6. Return links + a quick “usage notes” block (recommended minimum size, print tips).

Output format (required)

  • Encoded URL (final URL after UTM, if used)
  • Files generated (with links)
  • Recommendations (error correction, min size, when to use SVG vs PNG)

Scripts in this pack

  • scripts/generate_qr.py — single QR (PNG/SVG, optional caption)
  • scripts/batch_generate.py — batch from CSV (id,url,label)

Templates

  • assets/templates/utm_template.json
  • assets/templates/print_notes.md
  • assets/templates/prompt_snippets.md