jeremylongshore/tons-of-skills-marketplace / plugins/crypto/nft-rarity-analyzer/skills/analyzing-nft-rarity
analyzing-nft-rarity
VerifiedCalculate NFT rarity scores and rank tokens by trait uniqueness. Use when analyzing NFT collections, checking token rarity, or comparing NFTs. Trigger with phrases like "check NFT rarity", "analyze collection", "rank tokens", "compare NFTs".
| File | Kind | Size |
|---|---|---|
| ARD.md | markdown | 5.3 KB |
| PRD.md | markdown | 2.7 KB |
| SKILL.md | skill md | 3.5 KB |
| config/settings.yaml | config | 1.9 KB |
| references/errors.md | markdown | 3.2 KB |
| references/examples.md | markdown | 6.2 KB |
| references/implementation.md | markdown | 1.5 KB |
| scripts/formatters.py | script | 8.5 KB |
| scripts/metadata_fetcher.py | script | 11.8 KB |
| scripts/rarity_analyzer.py | script | 11.6 KB |
| scripts/rarity_calculator.py | script | 11.6 KB |
| scripts/trait_parser.py | script | 9.9 KB |
references/examples.md
View on GitHub# Examples
## Quick Start
### Analyze a Collection
```bash
python rarity_analyzer.py collection pudgypenguins
```
Output:
```
COLLECTION: PUDGY PENGUINS
============================================================
Contract: 0xBd3531dA5CF5857e...
Total Supply: 8,888
Fetched: 200 tokens
Trait Types: 10
============================================================
TOKEN RANKINGS (by Rarity Score)
================================================================================
Rank Token Score Percentile Top Trait
--------------------------------------------------------------------------------
#1 Pudgy Penguin #1234 285.42 Top 0.5% Background: Gold
#2 Pudgy Penguin #5678 278.31 Top 1.0% Skin: Alien
#3 Pudgy Penguin #9012 265.19 Top 1.5% Eyes: Laser
...
--------------------------------------------------------------------------------
Algorithm: rarity_score
Total Ranked: 200
================================================================================
```
### Analyze a Specific Token
```bash
python rarity_analyzer.py token boredapeyachtclub 1234
```
Output:
```
TOKEN: Bored Ape #1234
============================================================
Token ID: 1234
Rank: #42
Percentile: Top 0.42%
Score: 312.4500
Algorithm: rarity_score
TRAIT BREAKDOWN
------------------------------------------------------------
Trait Value Rarity Score +
------------------------------------------------------------
Fur Solid Gold 1 in 457 +457.00
Eyes Laser Eyes 1 in 69 +69.00
Background Aquamarine 1 in 125 +125.00
Hat Sea Captain 1 in 283 +283.00
Mouth Bored Cigarette 1 in 175 +175.00
Clothes Tuxedo 1 in 137 +137.00
============================================================
```
## Collection Analysis Options
### Show More Tokens
```bash
python rarity_analyzer.py collection azuki --top 50
```
### Fetch Larger Sample
```bash
python rarity_analyzer.py collection doodles --limit 500
```
### Include Trait Distribution
```bash
python rarity_analyzer.py collection cryptopunks --traits
```
Output:
```
TRAIT DISTRIBUTION
======================================================================
Trait Type Values Coverage Rarest Value
----------------------------------------------------------------------
Background 12 100.0% Neon (0.1%)
Skin 8 100.0% Zombie (2.5%)
Eyes 15 95.0% Laser (0.3%)
Hat 24 75.0% Crown (0.2%)
...
======================================================================
```
### Show Rarest Traits
```bash
python rarity_analyzer.py collection boredapeyachtclub --rarest
```
## Different Algorithms
### Statistical Rarity
```bash
python rarity_analyzer.py collection azuki --algorithm statistical
```
### Information Content (Entropy)
```bash
python rarity_analyzer.py collection doodles --algorithm information
```
### Average Rarity
```bash
python rarity_analyzer.py collection coolcats --algorithm average
```
### Normalized Scores (0-100)
```bash
python rarity_analyzer.py collection pudgypenguins --normalize
```
## Compare Multiple Tokens
```bash
python rarity_analyzer.py compare boredapeyachtclub 1234,5678,9012
```
Output:
```
TOKEN COMPARISON
================================================================================
Trait Bored Ape #1234 Bored Ape #5678 Bored Ape #9012
--------------------------------------------------------------------------------
Background Aquamarine (2%) Blue (15%) New Punk Blue (3%)
Fur Solid Gold (0%) Brown (12%) Robot (2%)
Eyes Laser Eyes (1%) Bored (25%) Heart (5%)
Hat Sea Captain (0%) None (20%) Crown (0%)
Mouth Cigarette (6%) Bored (23%) Phoneme Vuh (1%)
Clothes Tuxedo (1%) None (18%) Sailor Shirt (2%)
--------------------------------------------------------------------------------
RANK #42 #892 #156
SCORE 312.45 85.23 198.67
================================================================================
```
## View Trait Distribution Only
```bash
python rarity_analyzer.py traits clonex
```
## Export Data
### Export as JSON
```bash
python rarity_analyzer.py export azuki > azuki_rarity.json
```
### Export as CSV
```bash
python rarity_analyzer.py export azuki --format csv > azuki_rankings.csv
```
### Export with Full Collection
```bash
python rarity_analyzer.py export boredapeyachtclub --limit 10000 --format csv
```
## Cache Management
### View Cache Status
```bash
python rarity_analyzer.py cache
```
### List Cached Items
```bash
python rarity_analyzer.py cache --list
```
### Clear All Cache
```bash
python rarity_analyzer.py cache --clear
```
### Clear Specific Collection
```bash
python rarity_analyzer.py cache --clear --pattern pudgy
```
## JSON Output Mode
### Collection Analysis
```bash
python rarity_analyzer.py collection azuki --json | jq '.rankings[0]'
```
### Token Analysis
```bash
python rarity_analyzer.py token azuki 1234 --json | jq '.traits'
```
## Common Workflows
### Find Undervalued NFTs
```bash
# Get full rankings
python rarity_analyzer.py collection boredapeyachtclub --limit 1000 --top 100
# Compare specific tokens you're considering
python rarity_analyzer.py compare boredapeyachtclub 1234,5678,9012
```
### Analyze Your Collection
```bash
# Export your holdings
python rarity_analyzer.py export azuki --format csv > my_azuki.csv
# Check specific token
python rarity_analyzer.py token azuki 5432
```
### Research Before Mint
```bash
# Check trait distribution for revealed tokens
python rarity_analyzer.py traits newcollection --limit 500
# See what makes tokens rare
python rarity_analyzer.py collection newcollection --rarest
```
---
*[Tons of Skills](https://tonsofskills.com) by [Intent Solutions](https://intentsolutions.io) | [jeremylongshore.com](https://jeremylongshore.com)*
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |