Skip to content
Back to search

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/diego-mcr13--clawdoodle/badge.svg)](/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

i

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
  1. # clawdoodle
  2. 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.
  3. > "Clawd explaining what a cache is" → a transparent GIF **and** a self-contained animated SVG.
  4. ![Clawd thinking hard](examples/pensar-mucho.gif)
  5. *Example: `/clawdoodle Clawd thinks a lot` — [GIF](examples/pensar-mucho.gif) · [animated SVG](examples/pensar-mucho.svg) · [scene](examples/pensar-mucho.scene.json)*
  6. ## What you get
  7. - `final.gif`: transparent background, 33 fps, loops seamlessly.
  8. - `final.svg`: one `.svg` file, no JavaScript (CSS keyframes), works in `<img src>`, browsers and HTML slides. Usually 20–100 KB.
  9. - 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.
  10. ## Requirements
  11. - macOS, Linux or Windows 10/11, Python 3.9+
  12. - Google Chrome or Chromium (used headless; set `CHROME_PATH` if it is installed somewhere unusual)
  13. - [Claude Code](https://claude.com/claude-code)
  14. - Pillow (installed automatically by the setup script)
  15. ## Install
  16. ### One command (recommended)
  17. ```bash
  18. npx clawdoodle
  19. ```
  20. 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+).
  21. | Flag | Effect |
  22. |---|---|
  23. | `--global` | install globally without asking |
  24. | `--project` | install for this project only, without asking |
  25. | `--force` | update an existing install (your `clawdoodles/` projects are not touched) |
  26. | `--no-setup` | only copy the files, skip the Python/Chrome step |
  27. In non-interactive shells (CI, pipes) it installs globally unless you pass `--project`.
  28. ### With skills.sh
  29. ```bash
  30. npx skills add diegochoqueramirez/clawdoodle -a claude-code # this project
  31. npx skills add diegochoqueramirez/clawdoodle -a claude-code -g # all projects
  32. ```
  33. This only copies the files. Run the one-time setup afterwards (creates the Python venv with Pillow and checks Chrome):
  34. ```bash
  35. python3 .claude/skills/clawdoodle/scripts/setup.py # with -g: ~/.claude/skills/clawdoodle/scripts/setup.py
  36. ```
  37. On Windows use `py` instead of `python3`. `npx clawdoodle` does the copy and the setup in one step.
  38. ### Manual install
  39. ```bash
  40. git clone https://github.com/diegochoqueramirez/clawdoodle.git
  41. cd clawdoodle
  42. python3 .claude/skills/clawdoodle/scripts/setup.py # Windows: py .claude\skills\clawdoodle\scripts\setup.py
  43. claude
  44. ```
  45. 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`.
  46. > 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.
  47. The setup script creates `engine/.venv` with Pillow, checks for Chrome and runs `clawd doctor`. It must finish with `OK`.
  48. ## Use
  49. In Claude Code, run the slash command with a topic (any language):
  50. ```
  51. /clawdoodle Clawd explaining what a cache is
  52. /clawdoodle quiero que clawd piense mucho
  53. ```
  54. 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.
  55. ## How it works
  56. ```
  57. .claude/skills/clawdoodle/
  58. SKILL.md instructions for Claude (workflow, rules, commands)
  59. engine/ SVG + GSAP scene engine, Pillow GIF export, validator, SVG baker
  60. scenes/ 11 worked example scenes (thinking, cache, database, ...)
  61. VOCAB.md what a scene may contain (props, poses, actions)
  62. STYLE.md art and timing rules
  63. reviewer/ checklist and brief for the optional reviewer agent
  64. scripts/ setup.py / setup.sh / setup.ps1 (one-time setup), run.py (launcher)
  65. ```
  66. 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`).
  67. ### CLI (what the skill runs for you)
  68. ```bash
  69. # launcher: python3 .claude/skills/clawdoodle/scripts/run.py <command> (Windows: py ...\run.py <command>)
  70. python3 .claude/skills/clawdoodle/scripts/run.py new my-topic --from thinking # start from an example
  71. python3 .claude/skills/clawdoodle/scripts/run.py check my-topic # validate
  72. python3 .claude/skills/clawdoodle/scripts/run.py render my-topic # preview + review pack
  73. python3 .claude/skills/clawdoodle/scripts/run.py render my-topic --final # GIF + animated SVG
  74. python3 .claude/skills/clawdoodle/scripts/run.py save my-topic -m "first version"
  75. python3 .claude/skills/clawdoodle/scripts/run.py --help
  76. ```
  77. See [docs/design.md](docs/design.md) for the design notes (in Spanish).
  78. ## Notes
  79. - Style is fixed on purpose: flat 2D, one body color, named palette, no text inside the animation, transparent background.
  80. - Clawd is Anthropic's mascot; this is an unofficial fan project and is not affiliated with or endorsed by Anthropic.
  81. ## License
  82. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.