Back to Hermes Agent

p5.js Skill

skills/creative/p5js/README.md

2026.6.53.2 KB
Original Source

p5.js Skill

Production pipeline for interactive and generative visual art using p5.js.

What it does

Creates browser-based visual art from text prompts. The agent handles the full pipeline: creative concept, code generation, preview, export, and iterative refinement. Output is a single self-contained HTML file that runs in any browser — no build step, no server, no dependencies beyond a CDN script tag.

The output is real interactive art. Not tutorial exercises. Generative systems, particle physics, noise fields, shader effects, kinetic typography — composed with intentional color palettes, layered composition, and visual hierarchy.

Modes

ModeInputOutput
Generative artSeed / parametersProcedural visual composition
Data visualizationDataset / APIInteractive charts, custom data displays
Interactive experienceNone (user drives)Mouse/keyboard/touch-driven sketch
Animation / motion graphicsTimeline / storyboardTimed sequences, kinetic typography
3D sceneConcept descriptionWebGL geometry, lighting, shaders
Image processingImage file(s)Pixel manipulation, filters, pointillism
Audio-reactiveAudio file / micSound-driven generative visuals

Export Formats

FormatMethod
HTMLSelf-contained file, opens in any browser
PNGsaveCanvas() — press 's' to capture
GIFsaveGif() — press 'g' to capture
MP4Frame sequence + ffmpeg via scripts/render.sh
SVGp5.js-svg renderer for vector output

Prerequisites

A modern browser. That's it for basic use.

For headless export: Node.js, Puppeteer, ffmpeg.

bash
bash skills/creative/p5js/scripts/setup.sh

File Structure

├── SKILL.md                      # Modes, workflow, creative direction, critical notes
├── README.md                     # This file
├── references/
│   ├── core-api.md              # Canvas, draw loop, transforms, offscreen buffers, math
│   ├── shapes-and-geometry.md   # Primitives, vertices, curves, vectors, SDFs, clipping
│   ├── visual-effects.md        # Noise, flow fields, particles, pixels, textures, feedback
│   ├── animation.md             # Easing, springs, state machines, timelines, transitions
│   ├── typography.md            # Fonts, textToPoints, kinetic text, text masks
│   ├── color-systems.md         # HSB/RGB, palettes, gradients, blend modes, curated colors
│   ├── webgl-and-3d.md          # 3D primitives, camera, lighting, shaders, framebuffers
│   ├── interaction.md           # Mouse, keyboard, touch, DOM, audio, scroll
│   ├── export-pipeline.md       # PNG, GIF, MP4, SVG, headless, tiling, batch export
│   └── troubleshooting.md       # Performance, common mistakes, browser issues, debugging
└── scripts/
    ├── setup.sh                 # Dependency verification
    ├── serve.sh                 # Local dev server (for loading local assets)
    ├── render.sh                # Headless render pipeline (HTML → frames → MP4)
    └── export-frames.js         # Puppeteer frame capture (Node.js)