qr-code-generator

QR Code Generator

Workspace Context

Read bootstrap context before asking questions: strategy/brand.md for brand, audience, offer, channels, tools, constraints, and metrics; about/me.md for personal voice; content/ideas.md and content/calendar.md for content planning. Use legacy product-marketing context files only as fallback. Save generated drafts to content/<platform>/drafts/YYYY-MM-DD_short-topic-slug.md, and route durable learnings back to strategy/brand.md, about/me.md, or content/ideas.md.

Operating Contract

This skill is self-contained for its frontmatter scope: use its local instructions, references, scripts, and assets as the playbook; ask only for missing task-specific inputs; hand off to adjacent skills instead of expanding scope; and return an actionable artifact, decision, plan, draft, or diagnostic.

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