Pebble Watchface Generator Skill

Notice: Use the official Core Devices fork which is more likely to be kept updated with the latest!

https://github.com/coredevices/pebble-watchface-agent-skill

Generate complete, buildable Pebble smartwatch watchfaces using Claude Code with full PBW artifact output and QEMU emulator testing.

What This Does

This repository contains a Claude Code skill that transforms natural language descriptions into fully functional Pebble watchfaces. Simply describe what you want, and Claude will:

1. Design the watchface architecture
2. Generate all source files (C code, package.json, wscript)
3. Build a ready-to-install .pbw file
4. Test in the QEMU emulator
5. Verify visually with screenshots
6. Deliver the final artifacts with app icons and animated previews

Sample Watchfaces

These watchfaces were generated using this agent skill and are live on the Rebble App Store:

• The Swordsmen - Animated Prince of Persia sword fighting scene
• Castle Knights - Animated medieval castle with jousting knights

Prerequisites

Before using this skill, ensure you have:

• Claude Code CLI installed and configured
• Pebble SDK Follow the instructions in the official documentation
• QEMU for emulator testing (bundled with Pebble SDK)
• Python 3 with Pillow (pip install Pillow) for icon/GIF generation

Quick Start

1. Clone This Repository

git clone 
cd pebble-wf-skill

2. Run Claude Code

claude

3. Ask for a Watchface

Simply describe what you want:

Create a retro digital watchface with a neon green display on black background

Or:

Make an animated watchface with floating bubbles and the time in the center

Claude will automatically invoke the pebble-watchface skill and handle everything from design to delivery.

How the Skill Works

Skill Location

.claude/skills/pebble-watchface/
├── SKILL.md              # Main skill definition
├── reference/            # API documentation
│   ├── pebble-api-reference.md
│   ├── animation-patterns.md
│   └── drawing-guide.md
├── samples/              # Working example watchfaces
│   └── aqua-pbw/         # Animated aquarium watchface
├── scripts/              # Helper utilities
│   ├── create_app_icons.py
│   ├── create_preview_gif.py
│   ├── create_project.py
│   ├── generate_uuid.py
│   └── validate_project.py
└── templates/            # Code templates
    ├── animated-watchface.c
    ├── static-watchface.c
    ├── rocky-watchface.js
    ├── package.json.template
    └── wscript.template

The 7-Phase Workflow

The skill follows a rigorous end-to-end workflow: