# Clawcap Avatar Equip

> AI-powered avatar accessory synthesis — automatically analyzes art style, lighting, and angle to seamlessly add hats and headwear to any avatar image.

- Skill: `dvcrn/clawcap-avatar-equip` (Agent Skill, multi-file: 16 files)
- Install (CLI): `npx skillmds@latest add dvcrn/clawcap-avatar-equip`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/clawcap-avatar-equip/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/clawcap-avatar-equip

---


# 🦞🧠 The ClawCap — Avatar Accessory Skill

When the user wants to **add a hat, headwear, or accessory to an avatar image**, use this skill.

## What It Does

ClawCap uses a 3-stage AI pipeline to add accessories to any avatar:

1. **VLM Fingerprint** — Gemini Vision analyzes the avatar's art style, lighting, color palette, and head position
2. **Mask Generation** — Automatically creates a pixel-precise placement mask using Pillow/NumPy
3. **AI Inpainting** — Gemini generates the accessory that perfectly matches the original style

## Supported Styles

- 📷 Real photos
- 🎨 Anime / 2D illustrations
- 🧊 3D renders
- 👾 Pixel art / NFT avatars

## How to Use

### As MCP Skill (Claude Desktop)

Add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "clawcap": {
      "command": "python",
      "args": ["mcp_server.py"],
      "cwd": "/path/to/The-ClawCap"
    }
  }
}
```

Then tell Claude: *"给这个头像戴上一顶龙虾帽"* with an image attached.

### As Web API

```bash
POST http://localhost:8000/api/skill/alpha-equip
Content-Type: application/json

{
  "image_base64": "<base64 encoded image>",
  "accessory_prompt": "a red lobster claw beanie hat"
}
```

### Live Demo

🌐 **[Try it online](http://107.172.78.150:8000)** (Rate limited: 3 requests/minute per IP)

## Requirements

- Python 3.10+
- `GEMINI_API_KEY` environment variable (get one at https://aistudio.google.com/apikey)
- Install deps: `pip install -r requirements.txt`

## Repository

🔗 [GitHub: The-ClawCap](https://github.com/ls569333469/The-ClawCap)