Skip to main content
← Skills
Skill · Link

Turn Machines into Hand-Drawn 3D Cutaways

Explain everyday machines with hand-drawn 3D figures you can rotate, operate and see inside. Colorfigures highlights each part’s label as it operates and delivers a self-contained HTML page.

@Aprilzz423 Colorfigures
  • Technical diagrams
  • SVG
  • Interactive

Works with Claude Code · Codex · Gemini CLI

Requirements

  • Python 3
  • Chrome / Chromium

Overview

What you get

  • A self-contained HTML figure with a rotatable 3D model, working controls, zoom and body-colour swatches.
  • See-through internals with part labels that highlight during operation; numbered labels and a list on phones.
  • A hand-drawn SVG engine, three editable examples and a Python script that packages the figure into one file.

Good fit

  • Explaining how an appliance, vending machine or other everyday device works through its controls and moving parts.
  • Making colourful, playable illustrations for lessons, articles and product explanations.

Tutorial

See how a machine works

An exterior drawing shows what a washing machine looks like. To explain how it fills, heats and spins, show its internal parts. Colorfigures turns everyday devices into hand-drawn 3D figures: drag to change the view, reveal the mechanism and watch part labels highlight during operation.

The author’s video above runs for about 25 seconds. You can also try the interactive washing machine. Watch three things:

  • Rotation: inspect the same machine from the front, side and back.
  • See-through: turn on See-through to reveal the drum, pipes and drive components.
  • Process and labels: turn on Labels and watch which parts work during the wash.

The style combines ink outlines, flat colours, a paper background and a blue cast shadow. The result is one self-contained HTML file that recipients can open and operate in a browser.

Choosing between Colorfigures and Anatomy

  • Colorfigures: builds colourful, hand-drawn models around the real operating sequence of everyday objects, with rotation, see-through internals and part labels.
  • Anatomy: explains technical concepts through mechanical diagrams for documentation and product explanations, with SVG, HTML or React output.

Install the skill and preview the toaster

This walkthrough uses Claude Code, a macOS or Linux terminal, Python 3, and Chrome or Chromium. Python packages the HTML; use Chrome or Chromium to preview the result and capture screenshots for review.

  1. Run the official installation command in your terminal:
mkdir -p ~/.claude/skills && curl -fsSL https://april-zhu.com/colorfigures/colorfigures.tar.gz | tar -xz -C ~/.claude/skills
  1. Restart Claude Code. Ask it to read colorfigures and confirm it can find SKILL.md, assets/core.js, assets/examples/ and scripts/build.py.
  2. In your terminal, create a practice folder and package the bundled toaster into a standalone page:
mkdir -p colorfigures-practice
cd colorfigures-practice
python3 "$HOME/.claude/skills/colorfigures/scripts/build.py" \
  "$HOME/.claude/skills/colorfigures/assets/examples/toaster.html" \
  toaster-demo.html

The terminal should print wrote toaster-demo.html. Open that file in your browser and try the controls in order:

  1. Use Choose shade to select a setting.
  2. Press Push the lever and watch the bread lower, toast and pop up.
  3. After the bread pops up, use Take the toast to remove it.

Then enable see-through and labels to locate the heating elements, spring and latch.

We built this official example and checked its heating sequence, pop-up action and phone labels. The package also includes desk-lamp and claw-machine examples.

On Windows, download the ZIP from the official page, move the complete colorfigures folder into .claude/skills/ in your user folder, and restart Claude Code. The same page covers Codex and Gemini installation.

Turn an operating sequence into a brief

Choose the principle you want to explain before choosing buttons and parts. This exercise follows the bundled toaster’s bimetal-strip mechanism, focusing on how heating triggers the pop-up action.

What to specifyThis exercise
AudienceSomeone learning about a toaster’s internals for the first time
Operating sequenceLower the carriage, heat the elements, bend the bimetal strip, release the latch, let the spring raise the bread
Viewer actionsInsert bread, choose a shade, push the lever, take the toast
Visible feedbackBread position and colour, heating-element state, latch and spring movement, highlighted labels

Open colorfigures-practice in Claude Code and send this editorial practice request.

/colorfigures
Make a hand-drawn 3D toaster figure for someone learning how a bimetal strip triggers the pop-up action.
Read the skill's three examples and engine first. Research this type of toaster, then list its main parts and how they connect.
Provide actions to insert bread, choose a shade, push the lever and take the toast. Do not start toasting without bread.
Sequence the bread lowering, heating, browning, latch release and pop-up, with labels highlighting the working parts.
Keep rotation, zoom, See-through and Labels controls.
Propose the operating sequence, parts and buttons first. Wait for my approval before writing code.

Check that every button produces a visible result. Pushing the lever should change the carriage, bread and heating state together. At the end, heating stops while the latch and spring release the bread. If a part is decorative or a button only changes text, specify its role in the sequence.

After approving the proposal, continue with:

Build toaster.html from the approved proposal. Deliver the source and a standalone toaster-final.html.
Find scripts/build.py in the loaded colorfigures skill and use it to package the result. Keep skill files in their installation folder; put source and output in the current practice folder.
Follow the skill's Chrome checks for multiple angles, see-through and labels, the full operating sequence and a phone layout. Open the screenshots and fix occlusion, missing parts and incorrect states, for at most three rounds.
Return the actual file paths, build command and button instructions.

The build script embeds the drawing engine into the final HTML. After changing the source, rebuild and open the updated toaster-final.html.

Inspect the internals and make one focused change

Open the finished figure, try the actions in order, then inspect it from other views:

  1. With see-through off, drag to the side and back. Check the case, lever and power cord, and whether nearer parts correctly hide those behind them.
  2. Turn on see-through and labels, then start toasting again. Labels should point to real parts and move with them. Highlights should follow the heating, release and pop-up stages.
  3. Switch to a phone width. Labels should become numbered badges with names below the figure, and the buttons should remain usable.

Choose one shade setting in your finished figure. Replace [setting name] below with its actual name, then send this revision request:

Change only the [setting name] setting's heating demonstration to 6 seconds. Keep the model, buttons, other settings and colours.
Adjust bread browning, bimetal-strip bending and latch-release timing together so the bread does not pop while the heating elements are still on.
Rebuild toaster-final.html, check a complete cycle and return before-and-after screenshots of the key states.

This changes the pace of the demonstration. When timing changes, the visual feedback and internal actions need to stay in sync to explain the same process.

Use your own object

Start with a small device with clear actions, such as a bike pump, coffee machine or capsule toy machine. Replace the brackets below and send the brief to your AI:

Use colorfigures to make a hand-drawn, interactive 3D figure of [object].
Audience: [who it is for]. Principle to explain: [one focus].
References: [manual, photos or reliable source URLs/file paths].
Main parts and connections: [known structure].
What moves through it, such as air, water or an object: [from where to where].
Viewer actions: [in order]. Visible result of each step: [motion, state, readings or colour changes].
See-through must show: [key internal parts]. Colours: [choose or describe].
Research the mechanism and parts, then propose a plan. After approval, build it, inspect rotation, see-through and phone screenshots, and deliver one standalone HTML file.

For a new object, rewrite the sequence, connections and feedback. Keep the visual style if it suits the project; design the internals around the new device.

Colorfigures is MIT licensed. It builds on April Zhu’s ISO-GLOW and Tolga Cohce’s iso-figure, and draws on Anatomy’s see-through method. When distributing the skill or pages containing its code, retain the relevant copyright and licence notices. See LICENSE in the package for the terms.