Skip to content
Back to search

clawd-emotes-skill

🦀 Clawd — tiny pixel-crab emotes as pure SVG + CSS keyframe animations. Plus an agent skill to make your own and export looping (transparent) GIFs.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/xixicc186--clawd-emotes-skill/badge.svg)](/listings/xixicc186--clawd-emotes-skill)

HTML

<a href="/listings/xixicc186--clawd-emotes-skill"><img src="/api/listings/xixicc186--clawd-emotes-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

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 · 156 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # 🦀 clawd-skills
  2. Two packaged **agent skills** (for Claude Code / the Claude Agent SDK) built around **Clawd**, a little pixel crab. Drop either one into your skills folder and your agent can bring Clawd to life:
  3. | Skill | What it does |
  4. | --- | --- |
  5. | [**`clawd-emotes`**](clawd-emotes/) | Design animated pixel-crab emotes as pure **SVG + CSS keyframes**, and export them to looping (transparent) GIFs. |
  6. | [**`clawd-photo-compositor`**](clawd-photo-compositor/) | Drop Clawd **into one of your own photos** — sitting on a desk, peeking over a monitor, hugging a cable — via built-in image generation. |
  7. ---
  8. ## 🦀 clawd-emotes
  9. > Tiny pixel-crab emotes, built as **pure SVG + CSS keyframe animations** — no sprite sheets, no GIF frames, no canvas. Just `<rect>`s and `@keyframes`.
  10. Give Clawd a prop, a hat, and one good motion, and it comes to life — sipping coffee, strumming a guitar, celebrating a holiday. Every emote is a single inline `<svg>` animated entirely in CSS, so it's tiny, razor-sharp at any zoom, themeable, and editable as plain text.
  11. ### Gallery
  12. All 24 below are original SVG+CSS animations, exported to **transparent** looping GIFs.
  13. **🎉 Festivals**
  14. <p>
  15. <img src="clawd-emotes/gallery/clawd-birthday.gif" width="110"><img src="clawd-emotes/gallery/clawd-spring.gif" width="110"><img src="clawd-emotes/gallery/clawd-mid-autumn.gif" width="110"><img src="clawd-emotes/gallery/clawd-dragon-boat.gif" width="110"><img src="clawd-emotes/gallery/clawd-christmas.gif" width="110">
  16. <img src="clawd-emotes/gallery/clawd-halloween.gif" width="110"><img src="clawd-emotes/gallery/clawd-new-year.gif" width="110"><img src="clawd-emotes/gallery/clawd-lantern.gif" width="110"><img src="clawd-emotes/gallery/clawd-valentine.gif" width="110"><img src="clawd-emotes/gallery/clawd-qixi.gif" width="110">
  17. </p>
  18. **☕ Daily life**
  19. <p>
  20. <img src="clawd-emotes/gallery/clawd-listening.gif" width="110"><img src="clawd-emotes/gallery/clawd-gaming.gif" width="110"><img src="clawd-emotes/gallery/clawd-singing.gif" width="110"><img src="clawd-emotes/gallery/clawd-reading.gif" width="110">
  21. <img src="clawd-emotes/gallery/clawd-eating.gif" width="110"><img src="clawd-emotes/gallery/clawd-exercise.gif" width="110"><img src="clawd-emotes/gallery/clawd-shower.gif" width="110"><img src="clawd-emotes/gallery/clawd-sleeping.gif" width="110">
  22. </p>
  23. **🎨 Hobbies**
  24. <p>
  25. <img src="clawd-emotes/gallery/clawd-coffee.gif" width="110"><img src="clawd-emotes/gallery/clawd-painting.gif" width="110"><img src="clawd-emotes/gallery/clawd-photo.gif" width="110"><img src="clawd-emotes/gallery/clawd-watering.gif" width="110"><img src="clawd-emotes/gallery/clawd-guitar.gif" width="110"><img src="clawd-emotes/gallery/clawd-coding.gif" width="110">
  26. </p>
  27. ### Why SVG + CSS instead of GIFs?
  28. - **Tiny & sharp.** A whole emote is a few hundred bytes of markup and stays crisp at any size (`image-rendering` keeps the pixels hard).
  29. - **Themeable.** Each card reads CSS variables (`--bg`, `--tagfg`, …), so recoloring a scene never touches the art.
  30. - **Editable.** It's plain text — tweak a coordinate, not a 2000×2000 sprite atlas.
  31. - **Exports anywhere.** When you do need a GIF (or a transparent one), the scripts step the animation deterministically for a clean, seamless loop.
  32. The trade-off: the crab is a fixed pixel grid, so **placement is everything**. Almost every "bug" is just an element at the wrong coordinate or in the wrong group — which is exactly what the skill's rules prevent.
  33. ### The five rules (learned the hard way)
  34. 1. **Feet live *inside* the animated body group** — otherwise the body bobs away and the feet "detach."
  35. 2. **A hat's brim must sit on the torso top (y≈6)**, or it floats in the air.
  36. 3. **A prop held by a moving arm goes *inside that arm's group*** — or the hand moves and the prop stays behind.
  37. 4. **Long props need gentle rotation** — a far-from-pivot prop on a big swing flings off-screen.
  38. 5. **Every inline SVG needs a unique class/keyframe prefix** — shared cards collide in the global CSS namespace.
  39. Full reasoning and ready-to-paste geometry live in [`clawd-emotes/references/anatomy.md`](clawd-emotes/references/anatomy.md) and [`clawd-emotes/references/prop-recipes.md`](clawd-emotes/references/prop-recipes.md).
  40. ### Build & export yourself
  41. ```bash
  42. # open any catalog page in a browser to see the live animations
  43. open clawd-emotes/examples/clawd-hobbies.html
  44. # validate markup + render each card to /tmp/clawd-check for visual review
  45. python3 clawd-emotes/scripts/check.py clawd-emotes/examples/clawd-hobbies.html
  46. # export looping GIFs (needs Node + puppeteer-core + ffmpeg)
  47. npm i puppeteer-core
  48. node clawd-emotes/scripts/export_gif.js clawd-emotes/examples/clawd-festivals.html out/
  49. node clawd-emotes/scripts/export_transparent.js clawd-emotes/examples/clawd-festivals.html out/ # transparent bg
  50. ```
  51. ---
  52. ## 📸 clawd-photo-compositor
  53. > Put the **canonical Clawd** into a photo of your own — and keep it looking like Clawd.
  54. Hand the skill a photograph and say what you want ("坐在显示器上" / "hang it on the screen" / "抱住这根线"), and it picks **one** matching pose from 16 bundled character references, then composites Clawd into your photo through built-in image generation.
  55. ### Demos
  56. Real outputs — Clawd stays a flat pixel block while the photo stays fully realistic:
  57. <p>
  58. <img src="clawd-photo-compositor/gallery/demo-sleep-macmini.png" width="240"><img src="clawd-photo-compositor/gallery/demo-hug-cable.png" width="240"><img src="clawd-photo-compositor/gallery/demo-peek-laptop.png" width="240">
  59. </p>
  60. <sub>Napping on a Mac mini (sleep-top) · hugging a power cable (hug) · peeking over a laptop screen (peek-edge).</sub>
  61. The hard part isn't placement — it's keeping Clawd *Clawd*. The skill locks two things on every generation:
  62. - **Identity lock** — Clawd stays a flat 2D block graphic (wide rectangular body, two block hands, four short legs, fixed proportions) even though the surrounding photo is fully realistic. No 3D-ifying, no rounding, no realistic materials, no stretching.
  63. - **Proxy exclusion** — each pose reference uses a gray placeholder object to show *contact and occlusion only*; that gray shape must never be copied into your photo. The real object in your photo replaces it.
  64. ### Pose library
  65. Bundled references, chosen automatically by what your photo and request imply:
  66. - **A-series** — plain standing views (front / three-quarter / side / back) for when there's no physical interaction.
  67. - **B-series** — contact poses: sit on an edge, peek over/behind, hang, climb, hug, push, pull, stand on top, sleep on top, tiptoe-reach, lean.
  68. Each pose entry in [`clawd-photo-compositor/references/pose-index.yaml`](clawd-photo-compositor/references/pose-index.yaml) carries its trigger keywords, the object types it fits, and a `relation_hint` for the occlusion/contact that sells the interaction.
  69. ---
  70. ## Use them as agent skills
  71. Clone whichever skill you want into your skills directory so your agent picks it up:
  72. ```bash
  73. # emotes
  74. git clone --depth 1 https://github.com/xixicc186/clawd-emotes-skill.git /tmp/clawd-skills
  75. cp -R /tmp/clawd-skills/clawd-emotes ~/.claude/skills/clawd-emotes
  76. cp -R /tmp/clawd-skills/clawd-photo-compositor ~/.claude/skills/clawd-photo-compositor
  77. ```
  78. Then just ask:
  79. - *"add a Clawd emote for stargazing"* — or *"the hat on the sleeping crab floats, fix it."*
  80. - *"把 Clawd 放进这张图里,让它坐在显示器边上"* — or *"hang Clawd on the top of the screen in this photo."*
  81. Each skill knows the anatomy, the rules, and how to verify its own output.
  82. ## Repository layout
  83. ```
  84. clawd-emotes/ # SKILL 1 — SVG+CSS emotes
  85. SKILL.md # the agent skill (workflow + rules)
  86. references/
  87. anatomy.md # base crab geometry, transform-origins, idle animations
  88. prop-recipes.md # catalog of props & hats by technique
  89. scripts/
  90. check.py # validate SVGs + headless-Chrome render for visual review
  91. export_gif.js # one looping GIF per card (deterministic frame stepping)
  92. export_transparent.js # same, with a transparent background
  93. assets/card-template.html # the shared scaffold + one fully-built example card
  94. examples/ # 24 emotes across festivals / daily / hobbies
  95. gallery/ # all 24 emotes as transparent GIFs
  96. clawd-photo-compositor/ # SKILL 2 — drop Clawd into a photo
  97. SKILL.md # the agent skill (workflow + selection rules)
  98. references/pose-index.yaml # pose catalog + identity-lock / proxy-exclusion prompts
  99. assets/poses/ # 16 bundled Clawd character-and-pose references (PNG)
  100. gallery/ # example composited outputs
  101. ```
  102. ## Credits
  103. The pixel-crab character is affectionately inspired by the desk-pet project
  104. [`clawd-on-desk`](https://github.com/rullerzhou-afk/clawd-on-desk). All artwork in
  105. this repo is **original** — none of the upstream assets are redistributed here.
  106. ## License
  107. [MIT](LICENSE) — do whatever you like, attribution appreciated. 🦀

Ratings and comments

Sign in to rate this skill.

Sign in

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