clawdoodle
A Claude Code skill that turns a topic into a short, looping animation of Clawd (the Claude Code mascot) doing something that stands for it.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/diego-mcr13--clawdoodle)HTML
<a href="/listings/diego-mcr13--clawdoodle"><img src="/api/listings/diego-mcr13--clawdoodle/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
One command (recommended)
npx clawdoodle
It asks whether to install **globally** (`~/.claude/skills`, all your projects) or **for the current project only** (`./.claude/skills`), copies the skill, creates its Python environment with Pillow and checks for Chrome. Works the same on macOS, Linux and Windows (needs Node 16.7+ and Python 3.9+).
| Flag | Effect | |---|---| | `--global` | install globally without asking | | `--project` | install for this project only, without asking | | `--force` | update an existing install (your `clawdoodles/` projects are not touched) | | `--no-setup` | only copy the files, skip the Python/Chrome step |
In non-interactive shells (CI, pipes) it installs globally unless you pass `--project`.
With skills.sh
npx skills add diegochoqueramirez/clawdoodle -a claude-code # this project npx skills add diegochoqueramirez/clawdoodle -a claude-code -g # all projects
This only copies the files. Run the one-time setup afterwards (creates the Python venv with Pillow and checks Chrome):
python3 .claude/skills/clawdoodle/scripts/setup.py # with -g: ~/.claude/skills/clawdoodle/scripts/setup.py
On Windows use `py` instead of `python3`. `npx clawdoodle` does the copy and the setup in one step.
Manual install
git clone https://github.com/diegochoqueramirez/clawdoodle.git cd clawdoodle python3 .claude/skills/clawdoodle/scripts/setup.py # Windows: py .claude\skills\clawdoodle\scripts\setup.py claude
Claude Code discovers the skill automatically when opened in the repo. To make it global, copy `.claude/skills/clawdoodle` into `~/.claude/skills/` (`%USERPROFILE%\.claude\skills\` on Windows) and run its `scripts/setup.py`.
> Windows support is implemented (cross-platform launcher, UTF-8 file I/O, `file:///` URLs, Chrome path lookup) but was only tested on macOS so far. If something fails on Windows, please open an issue.
The setup script creates `engine/.venv` with Pillow, checks for Chrome and runs `clawd doctor`. It must finish with `OK`.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 120 lines
- # clawdoodle
- A [Claude Code](https://claude.com/claude-code) skill that turns a topic into a short, looping animation of **Clawd** (the Claude Code mascot) doing something that stands for it.
- > "Clawd explaining what a cache is" → a transparent GIF **and** a self-contained animated SVG.
- 
- *Example: `/clawdoodle Clawd thinks a lot` — [GIF](examples/pensar-mucho.gif) · [animated SVG](examples/pensar-mucho.svg) · [scene](examples/pensar-mucho.scene.json)*
- ## What you get
- - `final.gif`: transparent background, 33 fps, loops seamlessly.
- - `final.svg`: one `.svg` file, no JavaScript (CSS keyframes), works in `<img src>`, browsers and HTML slides. Usually 20–100 KB.
- - Edit by talking: "slower", "add a book", "remove the desk", "another topic", "undo". Every change edits a `scene.json`, never the GIF, and each version is saved so you can revert.
- ## Requirements
- - macOS, Linux or Windows 10/11, Python 3.9+
- - Google Chrome or Chromium (used headless; set `CHROME_PATH` if it is installed somewhere unusual)
- - [Claude Code](https://claude.com/claude-code)
- - Pillow (installed automatically by the setup script)
- ## Install
- ### One command (recommended)
- ```bash
- npx clawdoodle
- ```
- It asks whether to install **globally** (`~/.claude/skills`, all your projects) or **for the current project only** (`./.claude/skills`), copies the skill, creates its Python environment with Pillow and checks for Chrome. Works the same on macOS, Linux and Windows (needs Node 16.7+ and Python 3.9+).
- | Flag | Effect |
- |---|---|
- | `--global` | install globally without asking |
- | `--project` | install for this project only, without asking |
- | `--force` | update an existing install (your `clawdoodles/` projects are not touched) |
- | `--no-setup` | only copy the files, skip the Python/Chrome step |
- In non-interactive shells (CI, pipes) it installs globally unless you pass `--project`.
- ### With skills.sh
- ```bash
- npx skills add diegochoqueramirez/clawdoodle -a claude-code # this project
- npx skills add diegochoqueramirez/clawdoodle -a claude-code -g # all projects
- ```
- This only copies the files. Run the one-time setup afterwards (creates the Python venv with Pillow and checks Chrome):
- ```bash
- python3 .claude/skills/clawdoodle/scripts/setup.py # with -g: ~/.claude/skills/clawdoodle/scripts/setup.py
- ```
- On Windows use `py` instead of `python3`. `npx clawdoodle` does the copy and the setup in one step.
- ### Manual install
- ```bash
- git clone https://github.com/diegochoqueramirez/clawdoodle.git
- cd clawdoodle
- python3 .claude/skills/clawdoodle/scripts/setup.py # Windows: py .claude\skills\clawdoodle\scripts\setup.py
- claude
- ```
- Claude Code discovers the skill automatically when opened in the repo. To make it global, copy `.claude/skills/clawdoodle` into `~/.claude/skills/` (`%USERPROFILE%\.claude\skills\` on Windows) and run its `scripts/setup.py`.
- > Windows support is implemented (cross-platform launcher, UTF-8 file I/O, `file:///` URLs, Chrome path lookup) but was only tested on macOS so far. If something fails on Windows, please open an issue.
- The setup script creates `engine/.venv` with Pillow, checks for Chrome and runs `clawd doctor`. It must finish with `OK`.
- ## Use
- In Claude Code, run the slash command with a topic (any language):
- ```
- /clawdoodle Clawd explaining what a cache is
- /clawdoodle quiero que clawd piense mucho
- ```
- Claude picks one visual metaphor, builds the scene, checks it, renders a preview and delivers the files under `./clawdoodles/<slug>/out/` in your working directory. Then keep asking for changes in plain language.
- ## How it works
- ```
- .claude/skills/clawdoodle/
- SKILL.md instructions for Claude (workflow, rules, commands)
- engine/ SVG + GSAP scene engine, Pillow GIF export, validator, SVG baker
- scenes/ 11 worked example scenes (thinking, cache, database, ...)
- VOCAB.md what a scene may contain (props, poses, actions)
- STYLE.md art and timing rules
- reviewer/ checklist and brief for the optional reviewer agent
- scripts/ setup.py / setup.sh / setup.ps1 (one-time setup), run.py (launcher)
- ```
- A scene is a small JSON file: pixel-grid sprites with named colors plus a timeline of poses and actions. The engine validates it, renders it in headless Chrome and exports the GIF; the SVG is baked from the GSAP timeline sampled at 60 fps and checked against the GIF render (`clawd export-svg --verify`).
- ### CLI (what the skill runs for you)
- ```bash
- # launcher: python3 .claude/skills/clawdoodle/scripts/run.py <command> (Windows: py ...\run.py <command>)
- python3 .claude/skills/clawdoodle/scripts/run.py new my-topic --from thinking # start from an example
- python3 .claude/skills/clawdoodle/scripts/run.py check my-topic # validate
- python3 .claude/skills/clawdoodle/scripts/run.py render my-topic # preview + review pack
- python3 .claude/skills/clawdoodle/scripts/run.py render my-topic --final # GIF + animated SVG
- python3 .claude/skills/clawdoodle/scripts/run.py save my-topic -m "first version"
- python3 .claude/skills/clawdoodle/scripts/run.py --help
- ```
- See [docs/design.md](docs/design.md) for the design notes (in Spanish).
- ## Notes
- - Style is fixed on purpose: flat 2D, one body color, named palette, no text inside the animation, transparent background.
- - Clawd is Anthropic's mascot; this is an unofficial fan project and is not affiliated with or endorsed by Anthropic.
- ## License
- [MIT](LICENSE)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.