โ† All skills
Tencent SkillHub ยท Content Creation

Gotchi Finder

Fetch Aavegotchi by ID from Base mainnet and display image with full traits. Shows on-chain SVG, converts to PNG, and displays complete gotchi stats.

skill openclawclawhub Free
0 Downloads
0 Stars
0 Installs
0 Score
High Signal

Fetch Aavegotchi by ID from Base mainnet and display image with full traits. Shows on-chain SVG, converts to PNG, and displays complete gotchi stats.

โฌ‡ 0 downloads โ˜… 0 stars Unverified but indexed

Install for OpenClaw

Quick setup
  1. Download the package from Yavira.
  2. Extract the archive and review SKILL.md first.
  3. Import or place the package into your OpenClaw setup.

Requirements

Target platform
OpenClaw
Install method
Manual import
Extraction
Extract archive
Prerequisites
OpenClaw
Primary doc
SKILL.md

Package facts

Download mode
Yavira redirect
Package format
ZIP package
Source platform
Tencent SkillHub
What's included
BRS_POLICY.md, CHANGELOG.md, README.md, SKILL.md, package.json, scripts/calculate-aging-bonus-timestamp.js

Validation

  • Use the Yavira download entry.
  • Review SKILL.md after the package is downloaded.
  • Confirm the extracted package contains the expected setup assets.

Install with your agent

Agent handoff

Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.

  1. Download the package from Yavira.
  2. Extract it into a folder your agent can access.
  3. Paste one of the prompts below and point your agent at the extracted folder.
New install

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

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.

Trust & source

Release facts

Source
Tencent SkillHub
Verification
Indexed source record
Version
1.2.1

Documentation

ClawHub primary doc Primary doc: SKILL.md 24 sections Open source page

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! ๐Ÿ”ฅ

Category context

Writing, remixing, publishing, visual generation, and marketing content production.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package
4 Docs1 Scripts1 Config
  • SKILL.md Primary doc
  • BRS_POLICY.md Docs
  • CHANGELOG.md Docs
  • README.md Docs
  • scripts/calculate-aging-bonus-timestamp.js Scripts
  • package.json Config