playbooks

home / skills / aidotnet / moyucode / qrcode-generator

qrcode-generator skill

/skills/tools/qrcode-generator

This skill generates QR codes from text, URLs, or data with customizable colors and embedded logos for flexible output.

npx playbooks add skill aidotnet/moyucode --skill qrcode-generator

Review the files below or copy the command above to add this skill to your agents.

Files (2)
SKILL.md
968 B
---
name: qrcode-generator
description: 从文本、URL或数据生成二维码，支持自定义颜色、Logo和多种输出格式。
metadata:
  short-description: 生成二维码
source:
  repository: https://github.com/lincolnloop/python-qrcode
  license: BSD
---

# QR Code Generator Tool

## Description
Generate QR codes with custom styling, colors, and embedded logos.

## Trigger
- `/qrcode` command
- User requests QR code generation
- User needs to encode data as QR

## Usage

```bash
# Generate simple QR code
python scripts/qrcode_generator.py --data "https://example.com" --output qr.png

# Generate with custom colors
python scripts/qrcode_generator.py --data "Hello" --output qr.png --fill-color "#000000" --back-color "#FFFFFF"

# Generate with logo
python scripts/qrcode_generator.py --data "https://example.com" --output qr.png --logo logo.png
```

## Tags
`qrcode`, `barcode`, `image`, `encoding`

## Compatibility
- Codex: ✅
- Claude Code: ✅

Overview

This skill generates QR codes from text, URLs, or arbitrary data with options for custom colors, embedded logos, and multiple output formats. It is implemented in TypeScript and exposes a simple command-style interface for quick generation of image files. The tool focuses on readable, high-quality QR output suitable for print and digital use.

How this skill works

You provide the input data (plain text, URL, or encoded payload) and the skill encodes it into a QR matrix, then renders that matrix to an image file. Rendering supports parameters for foreground/background colors, logo overlays centered in the code, and export formats such as PNG or SVG. The generator ensures sufficient error correction when a logo is used so the code remains scannable.

When to use it

  • Create QR codes for web links, contact info, Wi‑Fi credentials, or short messages.
  • Generate branded QR images with company colors and a centered logo for marketing materials.
  • Produce high-resolution QR assets for print: posters, business cards, packaging.
  • Automate bulk QR creation in scripts or build pipelines for event tickets or product tagging.
  • Export QR codes as SVG when you need vector output for design tools.

Best practices

  • Use high error-correction levels when embedding a logo to maintain scan reliability.
  • Choose high contrast between fill and back colors; avoid low-contrast combinations.
  • Test the generated QR with multiple scanner apps and devices before distribution.
  • Keep logos small and centered; leave quiet zones (margins) around the QR code.
  • Prefer SVG for scaling and PNG for raster-ready assets depending on final use.

Example use cases

  • Generate a QR for an event landing page with brand colors and export as PNG for social posts.
  • Create vector QR codes (SVG) for print-ready brochures that designers can scale without loss.
  • Embed Wi‑Fi network credentials into QR to place on office welcome signs for easy guest access.
  • Batch-generate QR codes for product SKUs in an e-commerce pipeline and save files for labeling.

FAQ

Can I include a logo without breaking the QR code?

Yes — the skill increases error correction when a logo is added; keep the logo small and test scanning across devices.

What output formats are supported?

Common formats such as PNG and SVG are supported to cover both raster and vector use cases.