# Send MintGarden 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": "mintgarden",
    "name": "MintGarden",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/Koba42Corp/mintgarden",
    "canonicalUrl": "https://clawhub.ai/Koba42Corp/mintgarden",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/mintgarden",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mintgarden",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "CHANGELOG.md",
      "README.md",
      "SKILL.md",
      "cli.js",
      "index.js",
      "install.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "mintgarden",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-05T15:56:16.442Z",
      "expiresAt": "2026-05-12T15:56:16.442Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mintgarden",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mintgarden",
        "contentDisposition": "attachment; filename=\"mintgarden-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "mintgarden"
      },
      "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/mintgarden"
    },
    "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/mintgarden",
    "downloadUrl": "https://openagent3.xyz/downloads/mintgarden",
    "agentUrl": "https://openagent3.xyz/skills/mintgarden/agent",
    "manifestUrl": "https://openagent3.xyz/skills/mintgarden/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/mintgarden/agent.md"
  }
}
```
## Documentation

### MintGarden Skill

Browse, search, and analyze Chia NFTs via the MintGarden API.

### What It Does

Search NFTs and collections
View collection stats, floor prices, trading volume
Track NFT ownership and trade history
Monitor recent sales and activity
Get trending collections and top traders
Access profiles and portfolios

### Commands

All commands can be triggered via:

/mg <command> in Telegram
/mintgarden <command> in Telegram
mg <command> in CLI
mintgarden <command> in CLI

### Search

/mg search <query>              # Search everything
/mg search nfts "rare zombie"   # Search NFTs only
/mg search collections "pixel"  # Search collections only

### Collections

/mg collections list            # Top collections by volume
/mg collection <id>             # Collection details
/mg collection nfts <id>        # NFTs in collection
/mg collection stats <id>       # Collection statistics
/mg collection activity <id>    # Recent sales/transfers

### NFTs

/mg nft <launcher_id>           # NFT details
/mg nft history <launcher_id>   # Trade history
/mg nft offers <launcher_id>    # Active offers

### Profiles

/mg profile <username>          # Profile details
/mg profile nfts <username>     # User's NFTs
/mg profile activity <username> # User's recent activity

### Events & Stats

/mg events                      # Recent global activity
/mg events <collection_id>      # Collection-specific events
/mg stats                       # Global marketplace stats
/mg trending                    # Trending collections (24h)
/mg top collectors              # Top collectors (7d)
/mg top traders                 # Top traders (7d)

### Shortcuts

/mg col1abc...                  # Quick collection lookup
/mg nft1abc...                  # Quick NFT lookup
/mg did:chia:...                # Quick profile lookup

### Agent Usage

When users ask about Chia NFTs, collections, or MintGarden:

const { handleCommand } = require('./skills/mintgarden');

// Natural language → formatted response
const output = await handleCommand('show me trending collections');

The skill handles:

Command parsing and normalization
API calls with error handling
Formatted text output (CLI/Telegram friendly)
Pagination for large results

### API Client

For custom integrations, use the API client directly:

const MintGardenAPI = require('./skills/mintgarden/lib/api');
const api = new MintGardenAPI();

// Search
const results = await api.search('zombie');
const nfts = await api.searchNFTs('rare', { limit: 50 });

// Collections
const collections = await api.getCollections({ sort: 'volume_7d' });
const collection = await api.getCollection('col1abc...');
const stats = await api.getCollectionStats('col1abc...');

// NFTs
const nft = await api.getNFT('nft1abc...');
const history = await api.getNFTHistory('nft1abc...');

// Profiles
const profile = await api.getProfile('username');
const profileNFTs = await api.getProfileNFTs('did:chia:...');

// Events
const events = await api.getEvents({ limit: 20 });
const trending = await api.getTrending({ period: '24h' });

// Stats
const globalStats = await api.getGlobalStats();
const topCollectors = await api.getTopCollectors({ period: '7d' });

### Installation

cd skills/mintgarden
npm install
chmod +x cli.js
npm link  # Makes 'mg' and 'mintgarden' global

### Configuration

No API key required — MintGarden API is public.

Optional: Set custom base URL via environment:

export MINTGARDEN_API_URL=https://api.mintgarden.io

### Output Format

All commands return plain text suitable for:

Terminal output (CLI)
Telegram messages
Discord messages
WhatsApp messages

No markdown tables (for WhatsApp compatibility).

### Error Handling

Invalid IDs → Clear error message
API failures → Retry-friendly error
Network issues → Timeout after 30s
Empty results → Helpful "not found" message

### Limits

Default limit: 50 results per query
Max limit: 100 results per query
No rate limiting (MintGarden is generous)
Pagination available via API client

### Examples

Find rare NFTs in a collection:

/mg collection nfts col1abc...

Check floor price:

/mg collection col1abc...

See what's hot:

/mg trending

Track a specific NFT:

/mg nft history nft1abc...

Monitor marketplace:

/mg events

### Tips

Use shortcuts for quick lookups (paste IDs directly)
Collection IDs start with col1
NFT launcher IDs start with nft1
Profile DIDs start with did:chia:
Trending updates every hour
Volume stats use 7-day window by default

### Support

MintGarden API: https://api.mintgarden.io/docs
Chia NFTs: https://mintgarden.io
Bug reports: File in skill repository
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Koba42Corp
- Version: 1.0.0
## 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-05-05T15:56:16.442Z
- Expires at: 2026-05-12T15:56:16.442Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/mintgarden)
- [Send to Agent page](https://openagent3.xyz/skills/mintgarden/agent)
- [JSON manifest](https://openagent3.xyz/skills/mintgarden/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/mintgarden/agent.md)
- [Download page](https://openagent3.xyz/downloads/mintgarden)