# Send Gotchi Finder to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "gotchi-finder",
    "name": "Gotchi Finder",
    "source": "tencent",
    "type": "skill",
    "category": "内容创作",
    "sourceUrl": "https://clawhub.ai/aaigotchi/gotchi-finder",
    "canonicalUrl": "https://clawhub.ai/aaigotchi/gotchi-finder",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/gotchi-finder",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=gotchi-finder",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "BRS_POLICY.md",
      "CHANGELOG.md",
      "README.md",
      "SKILL.md",
      "package.json",
      "scripts/calculate-aging-bonus-timestamp.js"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "gotchi-finder",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T20:14:50.629Z",
      "expiresAt": "2026-05-06T20:14:50.629Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=gotchi-finder",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=gotchi-finder",
        "contentDisposition": "attachment; filename=\"gotchi-finder-1.2.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "gotchi-finder"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/gotchi-finder"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/gotchi-finder",
    "downloadUrl": "https://openagent3.xyz/downloads/gotchi-finder",
    "agentUrl": "https://openagent3.xyz/skills/gotchi-finder/agent",
    "manifestUrl": "https://openagent3.xyz/skills/gotchi-finder/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/gotchi-finder/agent.md"
  }
}
```
## Documentation

### Gotchi Finder Skill

Find and display any Aavegotchi by ID with complete traits and image.

### Features

✅ Instant ID lookup - Fetch any gotchi by ID number
✅ Fetch any gotchi by ID from Base mainnet
✅ Display full traits (BRS, Kinship, Level, XP, Haunt, Name, Owner)
✅ TOTAL BRS - Shows base + wearables modifiers (true power level)
✅ Generate PNG images (standard 512x512 or hi-res 1024x1024)
✅ Export as SVG (scalable vector graphics)
✅ Flexible format options (PNG, hi-res, SVG, or all)
✅ Support for all gotchi states (Portal, Gotchi, etc.)
✅ Automatic image conversion and delivery

### Default Behavior (ALWAYS)

When you run gotchi-finder, it ALWAYS outputs:

🖼️ Gotchi PNG image (512×512) - sent as photo/media
📊 Stats as caption - displayed below the image

This creates a single message with the gotchi artwork on top and complete metadata below.

Example:

bash scripts/find-gotchi.sh 9638

Output: One Telegram message with:

Image at top (PNG)
Caption below with all stats, traits, and info

### Additional Format Options (Optional)

After seeing the default output, users can request additional formats:

# Hi-res PNG (1024×1024)
bash scripts/find-gotchi.sh 9638 --format hires

# SVG vector
bash scripts/find-gotchi.sh 9638 --format svg

# All formats
bash scripts/find-gotchi.sh 9638 --format all

### Format Options

preview - Show traits + standard PNG (default)
png - Standard PNG (512x512)
hires - Hi-res PNG (1024x1024)
svg - SVG only (no PNG conversion)
all - All formats at once

### Examples

Preview first (conversational flow):

# Show gotchi info + preview image
bash scripts/find-gotchi.sh 9638

# Then user picks format
bash scripts/find-gotchi.sh 9638 --format hires

Direct download (skip preview):

# Get hi-res immediately
bash scripts/find-gotchi.sh 9638 --format hires

# Get all formats at once
bash scripts/find-gotchi.sh 9638 --format all

Output Files:

gotchi-{ID}.json - Complete metadata (always)
gotchi-{ID}.svg - Vector image (always)
gotchi-{ID}.png - Standard PNG (preview/png/all)
gotchi-{ID}-hires.png - Hi-res PNG (hires/all)

### Live Gotchis (Status 3)

ALWAYS send as single message with media + caption:

Format:

media: gotchi-{ID}.png (512×512 PNG image)
caption: (text below)

Caption Template:

👻 **Gotchi #{ID} - {Name}**

**📊 Stats:**
⭐ BRS: **{brs}** ({TIER} tier)
💜 Kinship: **{kinship}**
🎮 Level: **{level}** (XP: {xp})
👻 Haunt: **{haunt}**
💎 Collateral: **{collateral}**

**🎭 Traits:**
⚡ Energy: **{value}**
👊 Aggression: **{value}**
👻 Spookiness: **{value}**
🧠 Brain Size: **{value}**

**👔 Wearables:** {None/equipped count}

LFGOTCHi! 🦞🚀

Rarity Tiers:

BRS ≥ 580: GODLIKE
BRS ≥ 525: MYTHICAL
BRS ≥ 475: UNCOMMON
BRS < 475: COMMON

### Portals (Status 0-1)

Single message: Portal PNG image with status info as caption

### Technical Details

Blockchain:

Chain: Base mainnet (8453)
RPC: https://mainnet.base.org
Diamond: 0xA99c4B08201F2913Db8D28e71d020c4298F29dBF

Dependencies:

Node.js with ethers v6
Sharp library for image conversion

Status Codes:

0: Unopened Portal
1: Opened Portal
2: Gotchi (rare on Base)
3: Gotchi (standard on Base)

### Files

scripts/show-gotchi.sh - Display gotchi (RECOMMENDED) - Shows PNG + stats in single message
scripts/find-gotchi.sh - Fetch and convert (advanced usage)
scripts/fetch-gotchi.js - Fetch from blockchain
scripts/svg-to-png.js - Convert SVG to PNG
package.json - Node dependencies

### For OpenClaw Agents

Use show-gotchi.sh - it outputs the exact format needed for the message tool:

cd ~/.openclaw/workspace/skills/gotchi-finder
bash scripts/show-gotchi.sh 8746

Output:

PNG_PATH=./gotchi-8746.png
CAPTION=<<EOF
👻 **Gotchi #8746 - LE PETIT MARX**
...complete stats...
EOF

Then use:

message(action: "send", media: PNG_PATH, caption: CAPTION)

### Installation

cd /home/ubuntu/.openclaw/workspace/skills/gotchi-finder
npm install

### Examples

Find your gotchi:

bash scripts/find-gotchi.sh 9638

Find any gotchi:

bash scripts/find-gotchi.sh 5000

Find multiple gotchis:

for id in 9638 21785 10052; do
  bash scripts/find-gotchi.sh $id
done

Built with 💜 by AAI

### 🔒 Security

This skill is 100% SAFE - Read-only! ✅

### Security Features

✅ Read-only - No wallet interaction at all
✅ No transactions - Cannot modify blockchain state
✅ No credentials needed - Public data only
✅ No private keys - Zero wallet access
✅ Safe for anyone - Cannot cause harm

### What This Skill Does

✅ Fetches gotchi data from public subgraph
✅ Generates images from public SVG data
✅ Displays gotchi traits (read-only)

### What This Skill CANNOT Do

❌ Access wallets
❌ Sign transactions
❌ Modify gotchis
❌ Transfer anything
❌ Spend money

### Data Sources

Public subgraph: api.goldsky.com (read-only)
Public SVG data: Aavegotchi Diamond contract (read-only)
No authentication required

### Privacy

✅ Fetches only PUBLIC gotchi data
✅ No wallet addresses exposed
✅ No sensitive information

### Compliance

✅ ClawHub security standards
✅ Read-only best practices
✅ Zero-risk skill classification

Security Score: 10/10 ✅ (Read-only = Maximum Safety)
ClawHub Status: Approved
Risk Level: NONE (Read-only)
Last Audit: 2026-02-19

### BRS Calculation (OFFICIAL)

gotchi-finder ALWAYS uses TOTAL BRS = Base BRS + Wearables Modifiers

This shows the gotchi's true power level with all equipped gear!

### JSON Output Fields

brs - TOTAL BRS (base + wearables) - main field ⭐
baseBrs - Base BRS only (no wearables)
baseRarityScore - Same as baseBrs (from contract)
modifiedRarityScore - Same as brs (from contract)

### Example Output

{
  "name": "SHAAMAAN",
  "brs": "670",           // ← TOTAL BRS (used everywhere)
  "baseBrs": "562",       // Base only (reference)
  "traits": { ... },      // Base traits (no wearables)
  "modifiedTraits": { ... } // Modified traits (with wearables)
}

Console Display:

⭐ Total BRS: 670 (Base: 562 + Wearables: +108)

### Why Total BRS?

✅ Shows gotchi's actual strength in battles
✅ Reflects equipped gear value
✅ Determines rarity tier with wearables
✅ Consistent with Baazaar listings

A MYTHICAL gotchi can become GODLIKE with the right gear! 🔥
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: aaigotchi
- Version: 1.2.1
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-29T20:14:50.629Z
- Expires at: 2026-05-06T20:14:50.629Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/gotchi-finder)
- [Send to Agent page](https://openagent3.xyz/skills/gotchi-finder/agent)
- [JSON manifest](https://openagent3.xyz/skills/gotchi-finder/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/gotchi-finder/agent.md)
- [Download page](https://openagent3.xyz/downloads/gotchi-finder)