Agent skill · data analytics · jeremylongshore
analyzing-nft-rarity
Calculate NFT rarity scores and rank tokens by trait uniqueness.
Why this skill is useful
Adds specific algorithms and scripts for calculating NFT rarity scores that the AI wouldn't reliably generate on its own.
What it needs
Requires python3, requests installed locally. Requires alchemy, opensea account access. About 2k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
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: OPENSEAAPIKEY for higher rate limits Optional: ALCHEMYAPIKEY for direct metadata fetching Instructions 1. Analyze a Collection 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 rarityscore average information] 2. Check Specific Token 3. Compare Multiple Tokens 4. View Trait Distribution 5. Export Rankings JSON: CSV: 6. Manage Cache Rarity Algorithms Algorithm Description Best For ----------- ------------- ---------- rarityscore Sum of 1/frequency (default) General use, matches rarity.tools statistical Same as rarityscore Backward compatibility average Mean of trait rarities Balanced 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 ${CLAUDESKILLDIR}/references/errors.md for: API rate limiting IPFS gateway issues Collection not found Token ID not found Examples See ${CLAUDESKILLDIR}/references/examples.md for: Collection analysis workflows Token comparison Export and caching Algorithm comparison Resources OpenSea API - Metadata source Rarity Tools - Reference rankings IPFS - Decentralized metadata
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/analyzing-nft-rarity