OpenSkillIndex← back to search
claude-code

Skillshub analyzing-nft-rarity

install
source · Clone the upstream repo
git clone https://github.com/ComeOnOliver/skillshub
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/ComeOnOliver/skillshub "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/jeremylongshore/claude-code-plugins-plus-skills/analyzing-nft-rarity" ~/.claude/skills/comeonoliver-skillshub-analyzing-nft-rarity && rm -rf "$T"
manifest: skills/jeremylongshore/claude-code-plugins-plus-skills/analyzing-nft-rarity/SKILL.md
tags
#crypto#analyzing-nft
source content

Analyzing NFT Rarity

Overview

NFT rarity analysis skill that:

  • Fetches collection metadata from OpenSea API
  • Parses and normalizes trait attributes
  • Calculates rarity using multiple algorithms
  • Ranks tokens by composite rarity score
  • Exports data in JSON and CSV formats

Prerequisites

  • Python 3.8+ with requests library
  • Optional: 
    OPENSEA_API_KEY
    for higher rate limits
  • Optional: 
    ALCHEMY_API_KEY
    for direct metadata fetching

Instructions

1. Analyze a Collection

cd ${CLAUDE_SKILL_DIR}/scripts && python3 rarity_analyzer.py collection boredapeyachtclub

Options:

  1. --limit 500
    : Fetch more tokens for analysis
  2. --top 50
    : Show top 50 tokens
  3. --traits
    : Include trait distribution
  4. --rarest
    : Show rarest traits
  5. --algorithm [statistical|rarity_score|average|information]

2. Check Specific Token

cd ${CLAUDE_SKILL_DIR}/scripts && python3 rarity_analyzer.py token pudgypenguins 1234  # port 1234 - example/test

3. Compare Multiple Tokens

cd ${CLAUDE_SKILL_DIR}/scripts && python3 rarity_analyzer.py compare azuki 1234,5678,9012  # 5678: 1234: 9012 = configured value

4. View Trait Distribution

cd ${CLAUDE_SKILL_DIR}/scripts && python3 rarity_analyzer.py traits doodles

5. Export Rankings

JSON:

cd ${CLAUDE_SKILL_DIR}/scripts && python3 rarity_analyzer.py export coolcats > rankings.json

CSV:

cd ${CLAUDE_SKILL_DIR}/scripts && python3 rarity_analyzer.py export coolcats --format csv > rankings.csv

6. Manage Cache

cd ${CLAUDE_SKILL_DIR}/scripts && python3 rarity_analyzer.py cache --list
cd ${CLAUDE_SKILL_DIR}/scripts && python3 rarity_analyzer.py cache --clear

Rarity Algorithms

AlgorithmDescriptionBest For
rarity_score
Sum of 1/frequency (default)General use, matches rarity.tools
statistical
Same as rarity_scoreBackward compatibility
average
Mean of trait raritiesBalanced scoring
information
Entropy-based (-log2)Information theory approach

Output

  • Collection Summary: Name, supply, trait types
  • Rankings: Tokens sorted by rarity score with percentile
  • Token Detail: Full trait breakdown with contribution
  • Comparison: Side-by-side trait comparison

Supported Collections

Works with any ERC-721/ERC-1155 collection that has:

  • OpenSea listing
  • Standard attributes array format
  • Accessible metadata

Error Handling

See 

${CLAUDE_SKILL_DIR}/references/errors.md
for:

  • API rate limiting
  • IPFS gateway issues
  • Collection not found
  • Token ID not found

Examples

See 

${CLAUDE_SKILL_DIR}/references/examples.md
for:

  • Collection analysis workflows
  • Token comparison
  • Export and caching
  • Algorithm comparison

Resources