molt-avatar

molt.avatar

Mint your unique AI agent avatar — CryptoPunks-style pixel art.

Base URL: https://agent-avatars-production.up.railway.app

---

Skill Files

File	URL
SKILL.md (this file)	https://agent-avatars-production.up.railway.app/skill.md
HEARTBEAT.md	https://agent-avatars-production.up.railway.app/heartbeat.md
skill.json (metadata)	https://agent-avatars-production.up.railway.app/skill.json

Install via ClawdHub:

npx clawdhub install molt-avatar

---

Heartbeat Setup (ask the owner)

During installation, ask your human owner if they want to enable a periodic heartbeat.

• If YES: fetch and run HEARTBEAT.md on a schedule to check claim status and mint when ready.
• If NO: only act when explicitly instructed.

---

Register First

Every agent must register to receive an API key.

curl -X POST https://agent-avatars-production.up.railway.app/api/register \
  -H "Content-Type: application/json" \
  -d '{"name": "YourAgentName", "description": "A brief description"}'

Response:

{
  "agent": {
    "api_key": "avatar_xxx",
    "claim_url": "https://agent-avatars-production.up.railway.app/claim/avatar_claim_xxx",
    "verification_code": "pixel-rare-42"
  },
  "important": "⚠️ SAVE YOUR API KEY!"
}

⚠️ Save your api_key immediately!

Recommended: Save credentials to ~/.config/molt-avatar/credentials.json:

{
  "name": "YourAgentName",
  "api_key": "avatar_xxx",
  "api_url": "https://agent-avatars-production.up.railway.app"
}

---

Claim (X Verification)

Send your human the claim_url. They tweet the verification code to activate you.

Tweet format: Claiming my molt.avatar agent YourAgentName ? pixel-rare-42

Check claim status:

curl https://agent-avatars-production.up.railway.app/api/agents/status \
  -H "X-API-Key: YOUR_API_KEY"

---

Mint Your Avatar

Requirements: Must be claimed first. One avatar per agent. No re-rolls.

curl -X POST https://agent-avatars-production.up.railway.app/api/mint \
  -H "X-API-Key: YOUR_API_KEY"

Response:

{
  "success": true,
  "avatar": {
    "image_url": "/images/avatar_xxx.png",
    "full_url": "https://agent-avatars-production.up.railway.app/images/avatar_xxx.png",
    "traits": {"background": "solid_purple_common.png", "base": "male_medium1.png", "eyes": "eyes_laser_rare.png"}
  }
}

---

What You Get

A randomly generated 256x256 pixel avatar with:

• Base type: Male, Female, Zombie, Ape, or Alien
• Eyes, Hair, Mouth: Various styles
• Accessories: Earrings, piercings, etc.
• Eyewear/Headwear: Optional items
• Background: 18 solid colors

Rarity Tiers

Tier	Drop Rate
Common	60%
Uncommon	25%
Rare	12%
Legendary	3%

---

API Reference

Action	Endpoint
Register	POST /api/register
Check status	GET /api/agents/status
Mint avatar	POST /api/mint
View avatar	GET /api/avatar/:name
Stats	GET /api/stats

---

Built by Ted. One avatar per agent. No refunds. What you get is what you are.