convez.ai
MCP ServerDesign & UIIntermediário
psmon

Pencil Creator

psmon/pencil-creator

Design de animações antes do código com controles reutilizáveis

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server para design e validação de animações em aplicações web usando Claude Code. Fornece 11+ controles animáveis prontos para uso e permite descobrir novos componentes apenas com prompts, seguindo filosofia de design animation-first.

Instalação

$npx convez-ai psmon/pencil-creator

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
7
Forks
1
Acompanhando
0
Saúde
28%
Último commit
há 2 meses
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Prototipagem de interfaces com animações complexas
  • Validação de transições de estado e easing antes da implementação
  • Descoberta iterativa de novos componentes animados via prompts

Veredito

Ferramenta especializada que inverte o fluxo comum de design ao colocar animações no centro do processo. Ideal para times que precisam validar motion design com Claude antes da implementação em HTML/CSS, reduzindo iterações custosas.

README

A tradução para o português deste README ainda está na fila.

Pencil Creator

Pencil Creator Demo

▶ Click the image to watch the PencilCreator demo video.

Pencil Creator

Look & Feel + Animation First Design — A Claude Code project for designing and validating look & feel and animations before building web applications. It provides 11+ (and growing) animatable controls out of the box, and with this design harness you can discover and add controls like the above using only prompts.

MS Blend for Visual Studio

Pencil Creator

Pencil can implement animated web content using definition files alone.

Optionally, by using the Blend tool in addition, you can control the detailed movements of animations more directly. It serves as a complement to Pencil's timeline & storyboard features.


Pencil Design Files (.pen)

The design artifacts of this project are managed as .pen files for the Pencil editor. Download the files below and open them in the Pencil editor to explore the animation templates and project designs.

FileDescriptionDownload
WPF Animation Template12 CATs, 40+ technique card librarydesign/wpf-animation.pen
Publisher App DesignWeb ZIP publisher app (4 screens + 12 animation guide cards)projects/design/publisher-app.pen

Design-First Concept

The core philosophy of this project is "Design before code, animation design before static design."

+----------------------------------------------------------------+
|                    ANIMATION-FIRST DESIGN                       |
|                                                                 |
|  1. WPF Animation Research   DoubleAnimation, ScaleTransform,   |
|     (Case A)                 Easing, Storyboard pattern mining  |
|           |                                                     |
|           v                                                     |
|  2. Animation Template       wpf-animation.pen                  |
|     Library Build            10 CATs, 37 technique cards        |
|           |                                                     |
|           v                                                     |
|  3. Project Design           Static look & feel screens         |
|     (Case B)                 + Animation guides (separated!)    |
|           |                                                     |
|           v                                                     |
|  4. HTML Implementation      Convert to CSS/JS animations       |
|     (Case W)                 Apply WPF -> CSS mapping rules     |
|           |                                                     |
|           v                                                     |
|  5. Harness Evaluation       3-axis scoring + RPG experience    |
|     & Improvement                                               |
|           |                                                     |
|           v                                                     |
|        Iterate                                                  |
+----------------------------------------------------------------+

Why design animations first?

  • Animations feel awkward when added later. You need to design state transitions (Before -> After) from the start for a natural UX.
  • WPF Storyboard patterns are the best reference for explicitly defining animation properties (target, duration, easing).
  • Separating static design from dynamic definitions allows animations to remain independent when the look & feel changes.

Application Layout — Project Design Artifacts

Publisher App (Web ZIP Publisher)

An application for uploading ZIP files to publish and manage websites.

Static Design (4 screens):

ScreenKey Components
Dashboard4 stat cards + published sites table
UploadDrag & drop zone + progress bar + completed file list
PublishForm (name/publisher/description/favicon) + validation + publish button
View Sites6 site card grid (3x2) + open in new window / delete

Animation Guide (4 categories, 12 cards):

CategoryCardWPF TechniqueTarget Element
CAT-A DashboardCounter Roll-UpDoubleAnimation + CubicEaseOutStat value text
Staggered Row EntranceTranslateY + Opacity StaggerTable rows
Skeleton ShimmerGradientStop + ForeverLoading state
CAT-B UploadDropzone Pulse GlowOpacity + Shadow AutoReverseDropzone border
Progress Bar GradientWidth DoubleAnimationProgress fill
File Card Slide-InTranslateX + ElasticEaseCompleted file cards
CAT-C PublishFloating Label InputY + Scale + ColorAnimationInput fields
Validation Stagger CheckScale + BounceEaseValidation items
Publish Button RippleEllipse Scale + OpacityPublish button
CAT-D View SitesCard Hover Scale + LiftScaleTransform + ShadowSite cards
Gradient Background ShiftPointAnimation + ForeverCard thumbnails
Delete Bounce ShrinkBackEaseIn + OpacityDelete action

File: projects/design/publisher-app.pen


WPF Animation Research Techniques

Research -> Visualization Pipeline

WPF Storyboard/DoubleAnimation/Transform patterns are researched and statically visualized as Pencil design cards.

WebSearch XAML examples
    |
    v
Extract key properties
  - TargetProperty (Opacity, ScaleX, TranslateX...)
  - Duration, BeginTime
  - EasingFunction (CubicEaseOut, ElasticEase, BounceEase...)
  - RepeatBehavior, AutoReverse
    |
    v
Create Pencil card
  +------------------------------+
  | 1-1  FLOATING LABEL TEXTBOX  |  <- Number + Title
  |                               |
  | Focus -> Label Y^18px        |  <- Behavior description
  | Scale 75%, Color transition   |
  |                               |
  | +----------+  ->  +----------+|  <- Before -> After
  | | Username |      | Username ||
  | |          |      | #        ||
  | +----------+      +----------+|
  |                               |
  | <DoubleAnimation              |  <- XAML code
  |   TargetProperty="Y"         |
  |   To="-18" Duration="0.2"/>  |
  +------------------------------+

Current Template Library

ResourcePathScale
Animation Templatedesign/wpf-animation.pen12 CATs, 40+ cards
XAML Samplesdesign/xaml/sample/*.xaml27 standalone files
Research Historydesign/xaml/research-history.md20 sources/techniques recorded
WPF App (for Blend)design-wpf-app/27 UserControls (Blend timeline editable)

Category List:

CATTopicKey Techniques
1Data Input ControlsFloating Label, ComboBox, Toggle
2Feedback & NotificationSnackbar, Progress Bar, Badge
3Navigation & TransitionsPage Transition, Tab Slide, Hamburger Morph
4Decorative & BackgroundGradient BG, Particle Dots, Pulsing Glow
53D Transform & Shape MorphFlip Card, Morphing, Elastic Spring
6Path & TrajectoryPath Follower, Parallax, Drag & Drop
7Text & SequentialTypewriter, Marquee, Staggered List
8Interactive UI ControlsRipple Button, Accordion, Tooltip
9Data Visualization & LoadingSkeleton Shimmer, Circular Progress, Bar Chart
10Ambient & Decorative FXWave Ripple, Breathing Pulse, Marching Ants
11Celebration & AdvancedConfetti Burst, Zoom/Pinch, Animated Tooltip
12Spring & Nature ParticleCherry Blossom Fall, Petal Scatter, Breeze Sway

3-Case Harness Workflow

Case A: WPF Template Enrichment

> "Research WPF templates and enrich them"
> "Research WPF Elastic/Spring effects and add them to wpf-animation.pen"

Directly researches WPF XAML via WebSearch and adds cards to design/wpf-animation.pen.

Evaluation AxisMax ScoreKey Criteria
A1 Research Novelty35Were new techniques added without duplicating existing ones?
A2 Visualization Expressiveness35Is the Before->After transition intuitive?
A3 Metadata Completeness30Are the XAML code and sources accurate?

Case B: Project Design (Design-First)

> "Design a publisher app in Pencil referencing wpf-animation effects"
> "Design a shopping mall admin page referencing wpf-animation"

Uses wpf-animation.pen as a reference library to create separated static look & feel + animation guide designs.

Evaluation AxisMax ScoreKey Criteria
B1 Requirements Fidelity35Were all required pages/features designed?
B2 Animation Guide Richness35Diverse WPF technique mapping + target specification
B3 Design Quality & Separation30Look & feel consistency + static/dynamic separation

Case W: HTML Implementation

> "Create HTML referencing the Pencil design"
> "Implement the publisher-app.pen design as a web page"

Converts the .pen file's static design + animation guide into HTML/CSS/JS.

Evaluation AxisMax ScoreKey Criteria
W1 Design Coverage35How much of the .pen elements were reflected?
W2 Animation Fidelity35Were the animation guides actually implemented?
W3 Creative Extension30Were interactions beyond the design added?

Case S: Sprite Animation (Concept / Video -> Sprite Sheet)

> "Make sprite sheets from this concept art"
> "Analyze this YouTube singer's motion and build a vocal-ex sprite"

Turns concept art or a real video's motion into background-transparent, game/web-ready sprite sheets (Aseprite Hash JSON). Two image providers are supported — Gemini (batch, seed-fixed consistency) and OpenAI gpt-image-2 (concept-as-reference consistency, no seed). Real footage can be analyzed first via the video-motion-analysis skill (yt-dlp + ffmpeg contact sheets) to extract a motion vocabulary, which is then mapped to sprite keyframes.

Featured case — vocal-ex (FIFA World Cup 'DNA' stage singer): the singer's 47–55s close-up sequence was analyzed, a character concept was generated with gpt-image-2, then 14 frames (idle 6 + play 8 — 1.75x the standard 8) were produced and post-processed (HSV matte -> palette quantize -> Aseprite JSON). Case S score: 93 / A.

Concept (gpt-image-2) -> sprite sheet (play, 8 frames):

vocal-ex concept

vocal-ex play sheet

The motion arc: mic raise -> head sway -> chin-up climax -> sustain -> both-arms finale. A live player for all sprite collections (orchestra + vocal + dance + vocal-ex) ships as sample15 — see the demo site.

Evaluation AxisMax ScoreKey Criteria
S1 Character Fidelity35Concept vs. frame 0 palette/identity consistency
S2 Animation Quality35Frame count, grid alignment, loop seam
S3 Engineering Usability30Alpha, Aseprite JSON, packed master + index

Pipeline Bonus

PathConditionXP Bonus
A -> BBoth 60+ ptsx1.2
A -> WBoth 60+ ptsx1.2
B -> WBoth 60+ ptsx1.3
S -> WBoth 60+ ptsx1.3
A -> B -> WAll 60+ ptsx1.5
S -> B -> WAll 60+ ptsx1.5

RPG System

Earn XP upon task completion and level up.

Earned XP = Base XP (score x 10) x Grade multiplier (A:x5 B:x3 C:x1 D:x0.5) x Type multiplier (x1.2)

Grades: A (80-100) B (60-79) C (40-59) D (0-39)

Current Status: Lv.20 "Keyboard Warrior" | Total XP: 12,708

Skill Configuration

SkillRoleTrigger
harness-usageExecute Case A/B/W + evaluation"Enrich WPF template", "Design it", "Create HTML"
pencil-designPencil MCP diagrams/blueprints + WPF App migration"Draw architecture in Pencil", "Migrate XAML"
harness-creatorHarness structure improvement"Upgrade the harness"

Directory Structure

pencil-creator/
├── .claude/skills/
│   ├── pencil-design/         <- Pencil MCP design skill
│   ├── harness-usage/         <- Case A/B/W workflow + evaluation
│   └── harness-creator/       <- Harness structure improvement
├── design/
│   ├── wpf-animation.pen      <- WPF animation template (10 CATs, 37 cards)
│   └── xaml/
│       ├── research-history.md <- WPF research history
│       ├── sample/*.xaml       <- 17 XAML samples
│       └── output/sample{N}/   <- HTML output
├── design-wpf-app/
│   ├── design-wpf-app.slnx    <- Open in Blend for Visual Studio
│   ├── migrated/               <- 27 converted UserControls (Blend timeline editable)
│   ├── db/migration-db.json    <- Migration status DB (v2 schema)
│   └── docs/                   <- Core conversion guide
├── projects/
│   ├── design/*.pen            <- Per-project designs (static + animation guide)
│   └── prompt/                 <- Project prompt history
├── harness/
│   ├── knowledge/              <- Evaluation criteria (design-craft.md)
│   ├── agents/                 <- Evaluation agents
│   ├── engine/                 <- RPG rules + state model
│   ├── logs/                   <- Work logs + RPG state
│   └── docs/                   <- Version change history
├── CLAUDE.md                   <- Claude Code project instructions
└── README.md

WPF App Migration (for Blend Editing)

A project that converts 27 collected XAML animations into a WPF App editable via Blend for Visual Studio timeline. When implementing animations on other platforms (web, mobile), use the Blend timeline to visually inspect keyframes and easing.

Usage

# Open in Blend
design-wpf-app/design-wpf-app.slnx   # <- Open this file in Blend for Visual Studio

# Runtime execution (Gallery Viewer)
cd design-wpf-app && dotnet run

# Request new XAML migration (Claude Code)
> "Migrate XAML to WPF app"
> "Convert design/xaml/sample/28-xxx.xaml to Blend-compatible format"

Blend Timeline Usage

  1. Open migrated/Sample{NN}_*.xaml files in Blend
  2. Select a Storyboard from the timeline dropdown (GlassHoverIn, SpinnerRotate, etc.)
  3. Select DemoSequence to play the full animation flow at once
  4. Click keyframes to modify easing, timing, and values

Project Structure

design-wpf-app/
├── design-wpf-app.slnx     <- Open in Blend
├── MainWindow.xaml          <- Left navigation + right content viewer
├── migrated/                <- 27 converted UserControls
├── db/migration-db.json     <- Migration status DB (v2)
└── docs/animation-migration-guide.md  <- Core conversion guide

Roadmap

This project will continuously add sample web pages alongside harness design upgrades.

  • Publisher App HTML Implementation (Case W) — Implement publisher-app.pen design + 12 animation guides as an actual web page
  • WPF Template Expansion (Case A) — Add CAT 10+ (Scroll-driven Animation, View Transition, etc.)
  • New Project Designs (Case B) — Various app layouts: dashboards, e-commerce, SaaS landing pages, and more
  • Harness v3.0 — Auto-connect Case B->W pipeline, add accessibility evaluation axis
  • Design System — Reusable component library shareable across projects

All samples follow the Animation-First Design principle: look & feel and animation guides are designed first, then implemented.


Getting Started

# 1. Prerequisites
# Install Claude Code + Pencil

# 2. Open the project
cd pencil-creator
claude

# 3. Start your first task
> "Design a portfolio app in Pencil referencing wpf-animation"  # Case B
> "Research and enrich WPF templates"                            # Case A
> "Create HTML referencing the Pencil design"                    # Case W
> "Migrate XAML to WPF app"                                      # Blend editing
> "What is the harness?"                                         # Usage guide

Built with the Harness

Everything you see above is produced on top of the Pencil Design Harness (v2.6.0) — not a plain prompt runner, but a quality framework that closes the loop of prompt → design → evaluation → level-up.

  • 5 workflow cases — A (WPF → Template) · B (Template → Project) · C (Web → JSON → Component) · D (DesignMD → Pencil) · W (Pencil → HTML)
  • 3-axis × 100-point auto evaluation — every artifact gets a score/grade (A/B/C/D) logged under harness/logs/
  • Pipeline bonuses — chain cases like A → B → W to earn up to 1.5× XP
  • RPG level & achievement system — levels and achievements accumulate with each run, making quality bars visible

The video below walks through the full loop — from a single prompt to Pencil design, HTML implementation, and automated scoring — driven entirely by the Harness.

▶ Click the image to watch the Harness making-of video on YouTube.


License

MIT


Korean / 한국어 README

Ver o original no GitHub

Bom para

Relacionados